# (CLI)-Windows家庭版(VirtualBox版)教程
{% hint style="success" %}
高收益攻略：
1. 新上机的节点有3-7天部署期，请耐心等待，之后收益将逐渐稳定。
2. 请保持设备24小时在线，尤其是晚高峰（18:00-24:00）时段。
3. 请确保节点的Agent状态和服务状态均为正常，若出现异常请及时联系客服。
[→点击查看更多攻略](https://help.titanapp.info/titan-network-zhong-wen/4-ce-jia-li-le-ce-shi-wang/chang-jian-wen-ti/xin-jie-dian-shang-ji-gong-le-cong-cheng-gong-yun-xing-dao-shou-yi-ti-sheng)
{% endhint %}
## 一、下载所需文件
**（共计3个文件）**
1. 下载VirtualBox：[点击下载](https://download.virtualbox.org/virtualbox/7.1.6/VirtualBox-7.1.6-167084-Win.exe)（备用下载链接：[点击下载](https://www.oracle.com/hk/virtualization/technologies/vm/downloads/virtualbox-downloads.html)）
2. 下载Multipass：[点击下载](https://canonical.com/multipass/download/windows)（备用下载链接：[点击下载](https://canonical.com/multipass/install)）
3. 下载Titan Agent：[点击下载](https://pcdn.titannet.io/filpcdn/bin/filagent/filagent-windows.zip)
## 二、安装文件
### 2.1 安装VirtualBox
安装时注意事项：
（1）建议使用默认安装位置。如果修改了安装位置，请记住新的路径，并在后续设置环境变量时使用
（2）自定安装界面必须勾选最后一条(建议默认全部勾选)
点击查看详细安装步骤
1. 双击下载好的VirtualBox安装程序进行安装
2. 进入安装向导，并点击”下一步”
3. 选择接受协议，并点击”下一步”
4. 选择安装位置，并点击”下一步”
（建议使用默认安装位置。如果修改了安装位置，请记住安装路径，后续设置环境变量时使用）
5. 进入安装向导，并点击”是”
6. 进入安装Python核心包和win32api绑定界面，并点击”是”
7. 进入自定安装界面，所有条目勾选上，并点击”下一步”
（建议默认全部勾选）
8. 进入准备安装界面，并点击”安装”
9. 点击”完成”即可完成安装
### 2.2 安装Multipass
安装时注意事项：
（1）推荐默认安装位置
（2）某些系统版本，如 Windows Home（家庭版），不会显示选择虚拟机类别，但这不会影响后续安装，您可以正常进行安装
（3）在环境选择界面必须选择"Add multipass to the current user's PATH"
点击查看详细安装步骤
1. 双击点开下载好的multipass安装程序
2. 进入安装向导，并点击”Next”
3. 勾选”I accept the terms in the License Agreement”，并点击”Next”
4. \*勾选”Orade VM VirtualBox”，并点击”Next”
（注意：某些系统版本，如“Windows Home(家庭版)”，不会出现这一步，这很正常，可以直接跳到下一步，注意这步不要选错)
5. 勾选”Add multipass to the current user's PATH”，并点击”Next”
6. 选择安装位置，并点击”Next”
(推荐默认安装位置)
7. 进入准备安装界面，点击”Install”
8. 点击”Finish”即可完成安装
## 三、配置环境
### 3.1 关闭IPV6
{% tabs %}
{% tab title="Windows 10" %}
1. **在Windows搜索框中输入”查看网络连接”并打开**
2. **找到当前正在使用的网卡，右键点击”属性”**
辨别正在使用的网卡方法（根据当前使用的网卡进行操作）：
* 有线连接：以太网 | 网络X | 网卡（如 Realtek、Intel、Broadcom 等）
* 无线连接：WLAN | 当前连接的 WIFI 名称 | 网卡（如 Intel、Broadcom 等）
3. **取消勾选”Internet协议版本6(TCP/IPv6)”然后点击”确定”**
{% endtab %}
{% tab title="Windows 11" %}
1. **在Windows搜索框/按下Win键在输入框中输入 ”查看网络连接”并打开**
2. **找到当前正在使用的网卡，右键点击”属性”**
辨别正在使用的网卡方法（根据当前使用的网卡进行操作）：
* 有线连接：以太网 | 网络X | 网卡（如 Realtek、Intel、Broadcom 等）
* 无线连接：WLAN | 当前连接的 WIFI 名称 | 网卡（如 Intel、Broadcom 等）
3. **取消勾选”Internet协议版本6(TCP/IPv6)”然后点击”确定”**
{% endtab %}
{% endtabs %}
### **3.2 配置Titan Agent**
1. **设置agent存放路径**
在你想存放agent的目录下，右键点击选择”新建” ->”文件夹”，然后为文件夹命名（例如：titan-agent-windows）
2. **将“agent-windows压缩包”中的agent文件解压到这个新建文件夹中**
{% hint style="info" %} 注意：当前文件夹中只应包含agent文件，切勿更改agent文件名，并记住该文件夹的路径
{% endhint %}
### **3.3 配置VirtualBox环境变量**
{% hint style="info" %} **从这里开始，下文中所有使用"cmd"窗口的操作都"需要"在"命令提示符（管理员）"中进行**
{% endhint %}
#### 在Windows搜索框中输入”cmd”，选择”以管理员身份运行”打开一个对话框
1. **输入以下命令以设置VirtualBox环境变量**
```
setx PATH "%PATH%;" /M
```
(请将\替换成您安装VirtualBox时的路径)
若忘记安装位置，点开查看寻找方法
1. 在桌面找到"Oracle VirtualBox"，**右键**打开并点击属性
2. 将起始位置双引号里面的地址替换掉命令里面的\
```
setx PATH "%PATH%;" /M
```
若您用是默认路径安装，点开复制里面的命令即可完成设置
```
setx PATH "%PATH%;C:\Program Files\Oracle\VirtualBox" /M
```
**设置完成后请关闭当前”命令提示符(管理员)”窗口(此步骤非常重要，否则值不会生效)**
2. **重新在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”的版本号，则服务完整
2. **输入以下命令将Multipass配置为通过VirtualBox运行**
(此步按回车后是不会返回东西的)
```
multipass set local.driver=virtualbox
```
再执命令查看是否配置成功
```
multipass get local.driver
```
## 四、运行Titan Agent程序
#### 4.1 获取Titan账户的专属Key
1. **访问Titan-fil后台：**[**https://filecoin.titannet.io/**](https://filecoin.titannet.io/)
2. **点击钱包登录（需要连接Keplr插件）首次使用请**[**点击此处**](https://titannet.gitbook.io/titan-network-cn/qu-kuai-lian-ce-shi/titan-qian-bao-ce-shi-bi/chuang-jian-titan-qian-bao-di-zhi)**查看教程**
3. **找到并复制您的专属密钥Key**
(建议创建个文本文件将Key复制下来，方便后面的命令的修改）
#### 4.2 启动 Titan Agent
请根据agent文件存在的位置来查看指导
{% tabs %}
{% tab title="存放的agent文件在C盘" %}
1. 输入以下命令进入您的agent文件所在路径
```
cd <您的agent文件夹所在路径>
```
(请将<您的titan-agent文件夹路径>替换成您保存agent文件的路径)
2. 输入以下命令启动agent服务(请完整复制命令)
{% code overflow="wrap" %}
```
filagent.exe --working-dir=<您的agent文件所在路径> --server-url=https://fil-agent-server-api.titannet.io --key=<您的密钥>
```
{% endcode %}
(请将<您的agent文件所在路径>和<您的密钥>替换成您保存agent文件的路径和您的专属密钥Key)
{% endtab %}
{% tab title="存放的agent文件在其他盘（非C盘）" %}
1. **输入以下命令切换您的agent文件所在路径的盘符(盘符大小写都行)**
```
<盘符>:
```
(请将<盘符>替换成您保存agent文件的路径的盘符)
(假设你的agent文件在E:\盘，看目录第一位可以确定盘符)
2. **输入以下命令进入您的agent文件所在路径**
```
cd <您的agent文件夹所在路径>
```
(请将<您的titan-agent文件夹路径>替换成您保存agent文件的路径)
*//里面的**<>**括号也要去掉，**路径中不要包含\agent结尾**，复制时避免添加额外内容*
3. **输入以下命令启动agent服务(请完整复制命令)**
{% code overflow="wrap" %}
```
agent.exe --working-dir=<您的agent文件所在路径> --server-url=https://test4-api.titannet.io --key=<您的密钥>
```
{% endcode %}
(请将<您的agent文件所在路径>和<您的密钥>替换成您保存agent文件的路径和您的专属密钥Key)
*//里面的<>括号也要去掉，路径中不要包含\agent结尾，复制时避免添加额外内容*
{% endtab %}
{% endtabs %}
#### **4.3查看Titan Agent运行情况**
1. **访问Titan-fil后台：**[**https://filecoin.titannet.io/**](https://filecoin.titannet.io/)
2. **管理后台→节点管理→设备列表→点击查看详情**
#### 4.4 Titan Agent首次启动状态说明
点击查看详细
1. Agent状态:离线 | 服务状态:环境部署中 | 持续时间:10-45分钟
2. Agent状态:在线 | 服务状态:部署中 | 持续时间:看你机器安装速度
3. Agent状态:在线 | 服务状态:资源审核中 | 持续时间:5-30分钟
4. Agent状态:在线 | 服务状态:运行中 | 正常运行
服务显示运行中后会有一次很少流量的测试，持续时间很短，这是正常现象
之后再过30分钟到120分钟会正式开始跑(这个时间地区不一样可能有差异)
#### 4.5 查看日志
当 CMD 窗口循环显示 `level=info msg=updateScriptFromServer` 时，可在 agent 文件所在文件夹内查看日志（`agent.txt`）。
从 0.1.2 版本起，日志默认存放于此，如遇问题，请查看日志或提供最后一页内容给管理员
#### 4.6 收益发放说明
收益节点正常运行后，第二天16点左右，打开Titan四测后台**→**节点详情页，就可以看到收益啦！
## 五、常见问题
#### 问题1：如何停止(暂停)节点运行
点击查看详细
1. **将正在运行Agent的”命令提示符（管理员）”窗口关闭**
2. **重新在Windows搜索框中输入”cmd”，选择”****以管理员身份运行****”打开一个”****新****”的对话框，并输入以下命令停止(暂停)节点运行**
```
multipass stop ubuntu-niulink
```
(回车后没有内容输出则为成功)
再使用以下命令查看虚拟机状态
```
multipass info
```
*//State:Stopped则为已停止(暂停)*
*//停止(暂停)是可以重新启动的*
#### 问题2：如何重新启动节点
重新执行第四章中的[**4.2 启动Titan Agent**](#id-4.2-qi-dong-titan-agent)部分即可
#### 问题3：如何删除节点(删除操作不可逆)
点击查看详细
1. **将正在运行Agent的”命令提示符（管理员）”窗口关闭**
2. **重新在Windows搜索框中输入”cmd”，选择”****以管理员身份运行****”打开一个”新”的对话框，并输入以下删除节点**
```
multipass delete --purge ubuntu-niulink
```
(回车后没有内容输出则为成功)
再使用以下命令查看虚拟机状态
```
multipass info
```
*//*输出No instances found就是完成删除了
3. 最后将agent所在的文件夹及其内容删除即可
#### 问题4：安装 VirtualBox时出现报错
点击查看解决方法
* 打开浏览器（Chrome、Edge等）输入网址：
* 点击[Visual Studio 2015、2017、2019 和 2022](https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist?view=msvc-170#visual-studio-2015-2017-2019-and-2022) 选择对应的版本下载
* 安装visual C++
* 再运行VirtualBox 安装程序即可
## 上机问题请联系技术支持沟通
| 频道 | 链接 |
| ----------- | -------------------------------------- |
| TG频道✈️ | [点击跳转⏭️](https://t.me/titannet_dao) |
| Discord频道🎃 | [点击跳转⏭️](https://discord.titannet.io/) |
| 邮箱📮 | ** |
\
\
📢**致谢**
��*非常感谢社区志愿者**meko**贡献此文档，感谢**ZG、aron、草边河、包包**参与讨论。日期2025年3月。*\
