🏢(CLI)-Windows专业版(Hyper-V版)教程
本教程适用于Windows 8及以上版本的Windows专业版操作系统
本安装教程不适用于Windows Home(家庭版)用户，在安装前请确认您的系统版本！！！
Windows Home(家庭版)用户请移步到：VirtualBox版教程
操作步骤一览
一、下载所需文件
（共计2个文件）
下载Titan Agent：点击下载
二、安装
2.1 安装Hyper-V(系统自带软件)
在Windows搜索框中输入”功能”并打开
勾选Hyper-V，最后点击”确认”
(确保Hyper-V内所有内容都勾选)
选择”立即重新启动电脑”
📌必须要重启电脑后才能成功安装Hyper-V
2.2 安装Multipass
安装时注意事项：
（1）推荐默认安装位置
（2）在环境选择界面必须选择"Add multipass to the current user's PATH"
点击查看详细安装步骤
双击点开下载好的multipass安装程序
进入安装向导，并点击”Next”
勾选”I accept the terms in the License Agreement”，并点击”Next”
勾选”Microsoft Hyper-V”，并点击”Next”
(如果没有出现这步，请检查你的系统版本，注意这步不要选错)
勾选”Add multipass to the current user's PATH”，并点击”Next”
选择安装位置，并点击”Next”
(推荐默认安装位置)
进入准备安装界面，点击”Install”
点击”Finish”即可完成安装
三、配置环境
3.1 关闭IPV6
在Windows搜索框中输入”查看网络连接”并打开
找到当前正在使用的网卡，右键点击”属性”
辨别正在使用的网卡方法（根据当前使用的网卡进行操作）：
有线连接：以太网 | 网络X | 网卡（如 Realtek、Intel、Broadcom 等）
无线连接：WLAN | 当前连接的 WIFI 名称 | 网卡（如 Intel、Broadcom 等）
取消勾选”Internet协议版本6(TCP/IPv6)”然后点击”确定”
3.2 配置Titan Agent
设置agent存放路径
在你想存放agent的目录下，右键点击选择”新建” ->”文件夹”，然后为文件夹命名（例如：titan-agent-windows）
(注意，文件夹不建议出现中文)
将“agent-windows压缩包”中的agent文件解压到这个新建文件夹中
注意：当前文件夹中只应包含agent文件，切勿更改agent文件名，并记住该文件夹的路径
3.3 配置Multipass
从下文开始所有使用"cmd"窗口的操作都"需要"在"命令提示符（管理员）"中进行
从下文开始所有使用"cmd"窗口的操作都"需要"在"命令提示符（管理员）"中进行
在Windows搜索框中输入”cmd”，选择”以管理员身份运行”打开一个对话框
输入以下命令验证Multipass是否安装成功
multipass --version如果只显示:”multipass”的版本号，服务不完整,请参考以下方法开启服务
如果显示:”multipass”和”multipassd”的版本号，则服务完整
输入以下命令将Multipass配置为通过Hyper-V运行
(此步按回车后是不会返回东西的)
multipass set local.driver=hyperv再执命令查看是否配置成功
multipass get local.driver
四、运行Titan Agent程序
4.1 获取Titan账户的专属Key
找到并复制您的专属密钥Key
(建议创建个文本文件将Key复制下来，方便后面的命令的修改）
4.2 启动 Titan Agent
输入以下命令进入您的agent文件所在路径
cd <您的agent文件夹所在路径>(请将<您的titan-agent文件夹路径>替换成您保存agent文件的路径)
输入以下命令启动agent服务(请完整复制命令)
agent.exe --working-dir=<您的agent文件所在路径> --server-url=https://test4-api.titannet.io --key=<您的密钥>(请将<您的agent文件所在路径>和<您的密钥>替换成您保存agent文件的路径和您的专属密钥Key)
4.3查看Titan Agent运行情况
访问Titan四测后台：点击这里
管理后台→节点管理→设备列表→点击查看详情
4.4 Titan Agent首次启动状态说明
点击查看详细
Agent状态:离线 | 服务状态:环境部署中 | 持续时间:10-45分钟
Agent状态:在线 | 服务状态:部署中 | 持续时间:看你机器安装速度
Agent状态:在线 | 服务状态:资源审核中 | 持续时间:5-30分钟
Agent状态:在线 | 服务状态:运行中 | 正常运行
服务显示运行中后会有一次很少流量的测试，持续时间很短，这是正常现象
之后再过30分钟到120分钟会正式开始跑(这个时间地区不一样可能有差异)
4.5 查看日志
当 CMD 窗口循环显示 level=info msg=updateScriptFromServer 时，可在 agent 文件所在文件夹内查看日志（agent.txt）。
从 0.1.2 版本起，日志默认存放于此，如遇问题，请查看日志或提供最后一页内容给管理员
4.6 收益发放说明
收益节点正常运行后，第二天16点左右，打开Titan四测后台→节点详情页，就可以看到收益啦！
五、常见问题
问题1：如何停止(暂停)节点运行
点击查看详细
将正在运行Agent的”命令提示符（管理员）”窗口关闭
重新在Windows搜索框中输入”cmd”，选择”以管理员身份运行”打开一个”新”的对话框，并输入以下命令停止(暂停)节点运行
multipass stop ubuntu-niulink(回车后没有内容输出则为成功)
再使用以下命令查看虚拟机状态
multipass info
//State:Stopped则为已停止(暂停)
//停止(暂停)是可以重新启动的
问题2：如何重新启动节点
重新执行第四章中的4.2 启动Titan Agent部分即可
问题3：如何删除节点(删除操作不可逆)
点击查看详细
将正在运行Agent的”命令提示符（管理员）”窗口关闭
重新在Windows搜索框中输入”cmd”，选择”以管理员身份运行”打开一个”新”的对话框，并输入以下删除节点
multipass delete --purge ubuntu-niulink(回车后没有内容输出则为成功)
再使用以下命令查看虚拟机状态
multipass info
//输出No instances found就是完成删除了
最后将agent所在的文件夹及其内容删除即可
问题4：出现 multipass cannot connect network 错误
重新打包 multipass 安装包，点击 Repair 修复安装。
问题5：启用 Hyper-V 服务的其他方法
方法二: 使用 PowerShell 启用 Hyper-V
以管理员身份打开 PowerShell 控制台。
复制粘贴，运行以下命令：
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V –All如果无法找到此命令，请确保你以管理员身份运行 PowerShell。安装完成后重启计算机
方法三: 使用 CMD 启用 Hyper-V
以管理员身份打开 CMD 会话。
键入下列命令：
DISM /Online /Enable-Feature /All /FeatureName:Microsoft-Hyper-V执行完成后会出现如下提示：
Do you want to restart the computer now?(Y/N)输入 Y 重启计算机
如遇问题，可参考官方文档: 在 Windows 10 上安装 Hyper-V
📢致谢
🤩非常感谢社区志愿者meko贡献此文档，感谢ZG、aron、草边河、包包参与讨论。日期2025年3月。
Last updated