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

一、下载所需文件

（共计3个文件）

1. 下载VirtualBox：点击下载（备用下载链接：点击下载）

2. 下载Multipass：点击下载（备用下载链接：点击下载）

3. 下载Titan Agent：点击下载

二、安装文件

2.1 安装VirtualBox

安装时注意事项：

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

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

2.2 安装Multipass

安装时注意事项：

（1）推荐默认安装位置

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

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

三、配置环境

3.1 关闭IPV6

Windows 10

Windows 11

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

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

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

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

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

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

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文件解压到这个新建文件夹中

3.3 配置VirtualBox环境变量

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

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

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

(请将<VirtualBox安装路径>替换成您安装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”的版本号，服务不完整,请参考以下方法开启服务

sc start 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盘

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

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

Copy

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

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

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

Copy

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

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

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

Copy

<盘符>:

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

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

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

Copy

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

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

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

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

Copy

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首次启动状态说明

4.5 查看日志

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

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

4.6 收益发放说明

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

五、常见问题

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

multipass stop ubuntu-niulink

multipass info

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

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

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

multipass delete --purge ubuntu-niulink

multipass info

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

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

📢致谢

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