# (CLI)-Windows专业版(Hyper-V版)教程
{% hint style="danger" %}
本安装教程**不适用于Windows Home(家庭版)用户**，在安装前请确认您的系统版本！！！
Windows Home(家庭版)用户请移步到：[**VirtualBox版教程**](https://help.titanapp.info/titan-network-zhong-wen/4-ce-jia-li-le-ce-shi-wang/titan-agent-an-zhuang-jiao-cheng/windows-xi-tong/cliwindows-jia-ting-ban-virtualbox-ban-jiao-cheng)
{% endhint %}
{% 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 %}
## 操作步骤一览
## 一、下载所需文件
**（共计2个文件）**
1. 下载Multipass：[点击下载](https://canonical.com/multipass/download/windows)（备用下载链接：[点击下载](https://canonical.com/multipass/install)）
2. 下载Titan Agent：[点击下载](https://pcdn.titannet.io/filpcdn/bin/filagent/filagent-windows.zip)
## 二、安装
### 2.1 安装Hyper-V(系统自带软件)
{% tabs %}
{% tab title="Windows10" %}
1. 在Windows搜索框中输入”功能”并打开
2. 勾选Hyper-V，最后点击”确认”
**(确保Hyper-V内所有内容都勾选)**
3. 选择”立即重新启动电脑”
📌**必须要重启电脑后才能成功安装Hyper-V**
{% endtab %}
{% tab title="Windows11" %}
1. 在Windows搜索框/按下Win键在输入框中输入”功能”并打开
2. 勾选Hyper-V，最后点击”确认”
**(确保Hyper-V内所有内容都勾选)**
3. 选择”立即重新启动电脑”
**必须要重启电脑后才能成功安装Hyper-V**
{% endtab %}
{% endtabs %}
### 2.2 安装Multipass
安装时注意事项：
（1）推荐默认安装位置
（2）在环境选择界面必须选择"Add multipass to the current user's PATH"
点击查看详细安装步骤
1. 双击点开下载好的multipass安装程序
2. 进入安装向导，并点击”Next”
3. 勾选”I accept the terms in the License Agreement”，并点击”Next”
4. 勾选”Microsoft Hyper-V”，并点击”Next”
(如果没有出现这步，请检查你的系统版本，注意这步不要选错)
5. 勾选”Add multipass to the current user's PATH”，并点击”Next”
6. 选择安装位置，并点击”Next”
(推荐默认安装位置)
7. 进入准备安装界面，点击”Install”
8. 点击”Finish”即可完成安装
### 三、配置环境
### 3.1 关闭IPV6
1. **在Windows搜索框中输入”查看网络连接”并打开**
2. **找到当前正在使用的网卡，右键点击”属性”**
辨别正在使用的网卡方法（根据当前使用的网卡进行操作）：
* 有线连接：以太网 | 网络X | 网卡（如 Realtek、Intel、Broadcom 等）
* 无线连接：WLAN | 当前连接的 WIFI 名称 | 网卡（如 Intel、Broadcom 等）
3. **取消勾选”Internet协议版本6(TCP/IPv6)”然后点击”确定”**
### **3.2 配置Titan Agent**
1. **设置agent存放路径**
在你想存放agent的目录下，右键点击选择”新建” ->”文件夹”，然后为文件夹命名（例如：titan-agent-windows）
(注意，文件夹不建议出现中文)
2. **将“agent-windows压缩包”中的agent文件解压到这个新建文件夹中**
{% hint style="danger" %}
注意：当前文件夹中只应包含agent文件，切勿更改agent文件名，并记住该文件夹的路径
{% endhint %}
### **3.3** 配置Multipass
**从下文开始所有使用"cmd"窗口的操作都"需要"在"命令提示符（管理员）"中进行**
{% hint style="danger" %} **从下文开始所有使用"cmd"窗口的操作都"需要"在"命令提示符（管理员）"中进行**
{% endhint %}
#### 在Windows搜索框中输入”cmd”，选择”以管理员身份运行”打开一个对话框
1. **输入以下命令验证Multipass是否安装成功**
```
multipass --version
```
* 如果只显示:”multipass”的版本号，服务不完整,请参考以下方法开启服务
启动 multipassd 服务，点开复制里面的命令即可完成设置
```
sc start multipass
```
再执命令查看multipass服务是否完整
```
multipass --version
```
* 如果显示:”multipass”和”multipassd”的版本号，则服务完整
2. **输入以下命令将Multipass配置为通过Hyper-V运行**
(此步按回车后是不会返回东西的)
```
multipass set local.driver=hyperv
```
再执命令查看是否配置成功
```
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
{% 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**](https://help.titanapp.info/titan-network-zhong-wen/titan-fil/titanfil-agent-an-zhuang-jiao-cheng/windows-xi-tong/cliwindows-zhuan-ye-ban-hyperv-ban-jiao-cheng)部分即可
#### **问题3：如何删除节点(删除操作不可逆)**
点击查看详细
1. **将正在运行Agent的”****命令提示符（管理员）****”窗口关闭**
2. **重新在Windows搜索框中输入”cmd”，选择”****以管理员身份运行****”打开一个”****新****”的对话框，并输入以下删除节点**
```
multipass delete --purge ubuntu-niulink
```
(回车后没有内容输出则为成功)
再使用以下命令查看虚拟机状态
```
multipass info
```
*//*输出No instances found就是完成删除了
3. 最后将agent所在的文件夹及其内容删除即可
#### **问题4：出现 multipass cannot connect network 错误**
重新打包 multipass 安装包，点击 Repair 修复安装。
#### **问题5：启用 Hyper-V 服务的其他方法**
#### **方法二: 使用 PowerShell 启用 Hyper-V**
1. 以管理员身份打开 PowerShell 控制台。
#### **方法三: 使用 CMD 启用 Hyper-V**
1. 以管理员身份打开 CMD 会话。
2. 键入下列命令：
```
DISM /Online /Enable-Feature /All /FeatureName:Microsoft-Hyper-V
```
* 执行完成后会出现如下提示：
```
Do you want to restart the computer now?(Y/N)
```
输入 Y 重启计算机
如遇问题，可参考官方文档: [在 Windows 10 上安装 Hyper-V](https://learn.microsoft.com/zh-cn/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v)
\
📢**致谢**
��*非常感谢社区志愿者**meko**贡献此文档，感谢**ZG、aron、草边河、包包**参与讨论。日期2025年3月。*\
