这篇文档适用于 Windows 10 与 Windows Server 2019 及以上版本。
前置条件
- 能访问外网的 Windows 机器，不需要公网 IP。
- 管理员权限（安装服务需要）。
- Pi Desktop 已安装并登录（如果需要采集账号数据）。
第 1 步：下载安装包
从控制台「节点」→「添加节点」页面下载 Windows 安装包。
下载后校验文件大小——正常是百兆级别。如果只有几百字节，说明下载到了错误页面（可能是登录态过期），重新登录后再下。
第 2 步：运行安装
双击安装包。会弹出用户账户控制提示，选择「是」。
安装程序会：
- 解压文件到安装目录
- 请求你填写授权令牌
- 注册为 Windows 服务
- 启动服务
授权令牌从「添加节点」页面复制。粘贴时注意不要带上多余的空格。
第 3 步：确认服务在运行
按 Win + R，输入 services.msc，回车。
在列表里找到对应服务（名称包含 Pi Admin 或 AgentLite），检查：
- 状态为「正在运行」
- 启动类型为「自动」
如果状态是「已停止」，右键 →「启动」，然后看事件查看器里的错误。
第 4 步：确认后台能看到节点
回到控制台刷新「节点」列表。节点应该出现，状态为在线。
进入详情页核对：
- 节点名称应该是 Pi 账号用户名
- 区块高度在增长
- 算力、奖励有数值
关于防火墙
客户端是主动外连，不需要开放任何入站端口。
如果机器上有出站限制（某些企业网络会限制），需要允许客户端访问服务端的域名与端口（通常是 443 或 8443）。
一个快速判断方法：在节点机器上用浏览器打开服务端地址，能打开说明出站没问题。
排错对照表
安装时提示"需要管理员权限"。
右键安装包 →「以管理员身份运行」。
服务启动后立即停止。
打开「事件查看器」→「Windows 日志」→「应用程序」，找最近的错误。最常见的原因是配置文件里的令牌为空或格式错误。
也可以直接看日志文件：安装目录下的 logs/ 子目录。
节点显示在线，但没有账号数据。
按顺序检查：
- Pi Desktop 是否在运行并已登录。
- Pi Desktop 的调试端口是否可访问：在浏览器打开
/json，应该返回一段 JSON。如果打不开，说明 Pi Desktop 没有开调试端口或版本不匹配。 - 采集脚本是否在跑：任务管理器里应该有 node.exe 进程。
节点名称显示成随机字符串。
说明账号数据没采到。同上一条排查。
提示"授权已被其他设备使用"。
令牌绑定过别的机器。在后台解绑旧设备，或重新生成令牌。
换机器后提示绑定失败。
先解绑旧设备再绑定新设备。解绑操作在后台「授权管理」里可以完成，不需要旧设备在线。
关于开机自启
安装时注册的服务默认是自动启动。如果希望延迟启动（等网络就绪），可以在服务属性里设置「自动（延迟启动）」。
不建议设为「手动」——那样重启后节点会一直离线，直到有人手动启动。
卸载
在「控制面板」→「程序和功能」里找到对应条目卸载。卸载会停止并删除服务，但保留配置文件与日志（方便排查后再清理）。
如需彻底清理，卸载后手动删除安装目录。
升级
后台「系统更新」里会有提示。也可以下载新版安装包直接覆盖安装——安装程序会先停服务、替换文件、再启动。
—— Pi Admin X 团队