🏠(CLI)-Windows家庭版(VirtualBox版)教程

本教程适用于Windows 8及以上版本的所有Windows操作系统

一、下载所需文件

（共计3个文件）

1. 下载VirtualBox：点击下载（备用下载链接：点击下载）
2. 下载Multipass：点击下载（备用下载链接：点击下载）
3. 下载Titan Agent：点击下载

二、安装文件

2.1 安装VirtualBox

安装时注意事项：

（1）建议使用默认安装位置。如果修改了安装位置，请记住新的路径，并在后续设置环境变量时使用

（2）自定安装界面必须勾选最后一条(建议默认全部勾选)

点击查看详细安装步骤

1. 双击下载好的VirtualBox安装程序进行安装

1. 进入安装向导，并点击”下一步”

1. 选择接受协议，并点击”下一步”

1. 选择安装位置，并点击”下一步”

（建议使用默认安装位置。如果修改了安装位置，请记住安装路径，后续设置环境变量时使用）

1. 进入安装向导，并点击”是”

1. 进入安装Python核心包和win32api绑定界面，并点击”是”

1. 进入自定安装界面，所有条目勾选上，并点击”下一步”

   （建议默认全部勾选）

1. 进入准备安装界面，并点击”安装”

1. 点击”完成”即可完成安装

2.2 安装Multipass

安装时注意事项：

（1）推荐默认安装位置

（2）某些系统版本，如 Windows Home（家庭版），不会显示选择虚拟机类别，但这不会影响后续安装，您可以正常进行安装

（3）在环境选择界面必须选择"Add multipass to the current user's PATH"

点击查看详细安装步骤

1. 双击点开下载好的multipass安装程序

1. 进入安装向导，并点击”Next”

1. 勾选”I accept the terms in the License Agreement”，并点击”Next”

1. *勾选”Orade VM VirtualBox”，并点击”Next”

   （注意：某些系统版本，如“Windows Home(家庭版)”，不会出现这一步，这很正常，可以直接跳到下一步，注意这步不要选错)

1. 勾选”Add multipass to the current user's PATH”，并点击”Next”

1. 选择安装位置，并点击”Next”

(推荐默认安装位置)

1. 进入准备安装界面，点击”Install”

1. 点击”Finish”即可完成安装

三、配置环境

3.1 关闭IPV6

Windows 10

1. 在Windows搜索框中输入”查看网络连接”并打开

1. 找到当前正在使用的网卡，右键点击”属性”

辨别正在使用的网卡方法（根据当前使用的网卡进行操作）：

• 有线连接：以太网 | 网络X | 网卡（如 Realtek、Intel、Broadcom 等）

• 无线连接：WLAN | 当前连接的 WIFI 名称 | 网卡（如 Intel、Broadcom 等）

1. 取消勾选”Internet协议版本6(TCP/IPv6)”然后点击”确定”

Windows 11

1. 在Windows搜索框/按下Win键在输入框中输入 ”查看网络连接”并打开

1. 找到当前正在使用的网卡，右键点击”属性”

辨别正在使用的网卡方法（根据当前使用的网卡进行操作）：

• 有线连接：以太网 | 网络X | 网卡（如 Realtek、Intel、Broadcom 等）

• 无线连接：WLAN | 当前连接的 WIFI 名称 | 网卡（如 Intel、Broadcom 等）

1. 取消勾选”Internet协议版本6(TCP/IPv6)”然后点击”确定”

3.2 配置Titan Agent

1. 设置agent存放路径

在你想存放agent的目录下，右键点击选择”新建” ->”文件夹”，然后为文件夹命名（例如：titan-agent-windows）

1. 将“agent-windows压缩包”中的agent文件解压到这个新建文件夹中

注意：当前文件夹中只应包含agent文件，切勿更改agent文件名，并记住该文件夹的路径

3.3 配置VirtualBox环境变量

从这里开始，下文中所有使用"cmd"窗口的操作都"需要"在"命令提示符（管理员）"中进行

在Windows搜索框中输入”cmd”，选择”以管理员身份运行”打开一个对话框

1. 输入以下命令以设置VirtualBox环境变量

setx PATH "%PATH%;<VirtualBox安装路径>" /M

(请将<VirtualBox安装路径>替换成您安装VirtualBox时的路径)

若忘记安装位置，点开查看寻找方法

1. 在桌面找到"Oracle VirtualBox"，右键打开并点击属性

1. 将起始位置双引号里面的地址替换掉命令里面的<VirtualBox安装路径>

setx PATH "%PATH%;<VirtualBox安装路径>" /M

若您用是默认路径安装，点开复制里面的命令即可完成设置

setx PATH "%PATH%;C:\Program Files\Oracle\VirtualBox" /M

设置完成后请关闭当前”命令提示符(管理员)”窗口(此步骤非常重要，否则值不会生效)

1. 重新在Windows搜索框中输入”cmd”，选择”以管理员身份运行”打开一个”新”的对话框，并输入以下命令验证VirtualBox是否安装成功

VBoxManage --version

(显示类似”7.x.xx”的版本号，说明安装成功)

3.4 配置Multipass

1. 输入以下命令验证Multipass是否安装成功

multipass --version

• 如果只显示:”multipass”的版本号，服务不完整,请参考以下方法开启服务

启动 multipassd 服务，点开复制里面的命令即可完成设置

sc start multipass

再执命令查看multipass服务是否完整

multipass --version

• 如果显示:”multipass”和”multipassd”的版本号，则服务完整

1. 输入以下命令将Multipass配置为通过VirtualBox运行

(此步按回车后是不会返回东西的)

multipass set local.driver=virtualbox

再执命令查看是否配置成功

multipass get local.driver

四、运行Titan Agent程序

4.1 获取Titan账户的专属Key

1. 访问Titan四测后台：点击这里
2. 点击钱包登录（需要连接Keplr插件）首次使用请点击此处查看教程

1. 找到并复制您的专属密钥Key

(建议创建个文本文件将Key复制下来，方便后面的命令的修改）

4.2 启动 Titan Agent

请根据agent文件存在的位置来查看指导

存放的agent文件在C盘

1. 输入以下命令进入您的agent文件所在路径

cd <您的agent文件夹所在路径>

(请将<您的titan-agent文件夹路径>替换成您保存agent文件的路径)

1. 输入以下命令启动agent服务(请完整复制命令)

agent.exe --working-dir=<您的agent文件所在路径> --server-url=https://test4-api.titannet.io --key=<您的密钥>

(请将<您的agent文件所在路径>和<您的密钥>替换成您保存agent文件的路径和您的专属密钥Key)

存放的agent文件在其他盘（非C盘）

1. 输入以下命令切换您的agent文件所在路径的盘符(盘符大小写都行)

<盘符>:

(请将<盘符>替换成您保存agent文件的路径的盘符)

(假设你的agent文件在E:\盘，看目录第一位可以确定盘符)

1. 输入以下命令进入您的agent文件所在路径

cd <您的agent文件夹所在路径>

(请将<您的titan-agent文件夹路径>替换成您保存agent文件的路径)

//里面的<>括号也要去掉，路径中不要包含\agent结尾，复制时避免添加额外内容

1. 输入以下命令启动agent服务(请完整复制命令)

agent.exe --working-dir=<您的agent文件所在路径> --server-url=https://test4-api.titannet.io --key=<您的密钥>

(请将<您的agent文件所在路径>和<您的密钥>替换成您保存agent文件的路径和您的专属密钥Key)

//里面的<>括号也要去掉，路径中不要包含\agent结尾，复制时避免添加额外内容

4.3查看Titan Agent运行情况

1. 访问Titan四测后台：点击这里
2. 管理后台→节点管理→设备列表→点击查看详情

4.4 Titan Agent首次启动状态说明

点击查看详细

1. Agent状态:离线 | 服务状态:环境部署中 | 持续时间:10-45分钟

1. Agent状态:在线 | 服务状态:部署中 | 持续时间:看你机器安装速度

1. Agent状态:在线 | 服务状态:资源审核中 | 持续时间:5-30分钟

1. Agent状态:在线 | 服务状态:运行中 | 正常运行

服务显示运行中后会有一次很少流量的测试，持续时间很短，这是正常现象

之后再过30分钟到120分钟会正式开始跑(这个时间地区不一样可能有差异)

4.5 查看日志

当 CMD 窗口循环显示 level=info msg=updateScriptFromServer 时，可在 agent 文件所在文件夹内查看日志（agent.txt）。

从 0.1.2 版本起，日志默认存放于此，如遇问题，请查看日志或提供最后一页内容给管理员

4.6 收益发放说明

收益节点正常运行后，第二天16点左右，打开Titan四测后台→节点详情页，就可以看到收益啦！

五、常见问题

问题1：如何停止(暂停)节点运行

点击查看详细

1. 将正在运行Agent的”命令提示符（管理员）”窗口关闭

1. 重新在Windows搜索框中输入”cmd”，选择”以管理员身份运行”打开一个”新”的对话框，并输入以下命令停止(暂停)节点运行

multipass stop ubuntu-niulink

(回车后没有内容输出则为成功)

再使用以下命令查看虚拟机状态

multipass info

//State:Stopped则为已停止(暂停)

//停止(暂停)是可以重新启动的

问题2：如何重新启动节点

重新执行第四章中的4.2 启动Titan Agent部分即可

问题3：如何删除节点(删除操作不可逆)

点击查看详细

1. 将正在运行Agent的”命令提示符（管理员）”窗口关闭

1. 重新在Windows搜索框中输入”cmd”，选择”以管理员身份运行”打开一个”新”的对话框，并输入以下删除节点

multipass delete --purge ubuntu-niulink

(回车后没有内容输出则为成功)

再使用以下命令查看虚拟机状态

multipass info

//输出No instances found就是完成删除了

1. 最后将agent所在的文件夹及其内容删除即可

问题4：安装 VirtualBox时出现报错

点击查看解决方法

• 打开浏览器（Chrome、Edge等）输入网址：https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist?view=msvc-170

• 点击Visual Studio 2015、2017、2019 和 2022 选择对应的版本下载

• 安装visual C++

• 再运行VirtualBox 安装程序即可

上机问题请联系技术支持沟通

中文社区MOD	社区技术支持1	社区技术支持2
TG ID 🆔 ： @bdbaobao	TG ID 🆔 ：@EthanTitanSupport	TG ID 🆔 ：@LucasTitanSupport

频道	链接
TG频道✈️	点击跳转⏭️
Discord频道🎃	点击跳转⏭️
邮箱📮	[e-mail]

📢致谢

🤩非常感谢社区志愿者meko贡献此文档，感谢ZG、aron、草边河、包包参与讨论。日期2025年3月。