Windowns ZeroTier 私有Moon节点记录

Moon 节点(超级节点)可为私网环境的 ZeroTier 客户端提供稳定的中继,使内网环境也能稳定通信,适合集群、家庭网络、跨地区互联等场景。

以下是 Windows 环境 下搭建 ZeroTier 私有 Moon 节点的完整流程。


1. 生成 Moon 节点模板

打开命令提示符(管理员权限),进入 ZeroTier 目录:

CD C:\ProgramData\ZeroTier\One\

生成 identity.public 和 Moon 模板:

zerotier-one_x64.exe -i
zerotier-one_x64.exe -i initmoon identity.public >> moon.json

执行完成后,当前目录会出现:

moon.json

这就是 Moon 节点模板文件。


2. 编辑 moon.json,填入公网 IP

使用任意文本编辑器打开 moon.json,找到:

"stableEndpoints": [ "1.1.1.1/9993" ]

1.1.1.1 修改为你的公网 IPv4 地址。 如要支持 IPv6,也可写成:

[ "1.1.1.1/9993", "[2408:xxxx:xxxx]/9993" ]

ZeroTier 默认使用端口 9993,如端口被占用可修改。


3. 生成 Moon 签名文件(.moon)

执行以下命令:

zerotier-one_x64.exe -i genmoon moon.json

执行成功后会生成一个文件,例如:

000000xxxxxxxx.moon

这是 Moon 节点的签名文件。


4. 安装 Moon 文件并重启 ZeroTier

进入 ZeroTier 程序目录,新建文件夹:

moons.d

将刚生成的 000000xxxx.moon 文件复制进去,例如:

C:\ProgramData\ZeroTier\One\moons.d\

最后,重启 ZeroTier 服务

  • 打开“服务”→ ZeroTier One → 重启 或
  • 使用命令:
net stop zerotierone
net start zerotierone

Moon 节点至此安装完成。


5. 客户端加入 Moon 节点(Orbit)

在所有需要使用 Moon 的客户端上执行:

zerotier-cli orbit <world-id> <moon-ip:port>

示例:

zerotier-cli orbit XXXXXXXXXX 1.1.1.1/9993

说明:

  • <world-id> 为 Moon 文件名中的 ID(000000xxxx 前面的部分)
  • 1.1.1.1/9993 为 Moon 节点公网地址

Orbit 命令让客户端“围绕(orbit)”该 Moon 节点运行。


6. 查看客户端是否成功使用 Moon 节点

在客户端上执行:

zerotier-one_x64.exe -q listpeers

如果看到类似:

xxxxxxxxxx    MOON

或带有 moon 字样的 peer,说明客户端已成功连接到 Moon 节点。