本文档帮助你将设备接入自建的 ZeroTier 虚拟网络。
第一步：安装 ZeroTier 客户端
根据你的操作系统安装：
- Windows：访问 https://www.zerotier.com/download/ 下载安装
-
macOS：访问 https://www.zerotier.com/download/ 下载安装，或使用
brew install zerotier-one -
Linux：执行
curl -s https://install.zerotier.com | sudo bash - Android：在 Google Play 搜索 "ZeroTier One"
- iOS：在 App Store 搜索 "ZeroTier One"
第二步：替换 Planet 文件
自建网络需要使用自定义的 planet 文件，替换客户端自带的官方 planet 文件，你的设备才能连接到我们的 Planet 服务器。
下载 Planet 文件
以下链接需要下载密钥，请联系管理员获取。
替换方法
Windows：
- 在系统服务中停止 ZeroTier One 服务（
services.msc→ 找到 ZeroTier One → 右键停止） - 将下载的
planet文件替换到：C:\ProgramData\ZeroTier\One\planet - 重新启动 ZeroTier One 服务
macOS：
sudo launchctl unload /Library/LaunchDaemons/com.zerotier.one.plist
sudo cp ~/Downloads/planet /Library/Application\ Support/ZeroTier/One/planet
sudo launchctl load /Library/LaunchDaemons/com.zerotier.one.plist
Linux：
sudo systemctl stop zerotier-one
sudo cp planet /var/lib/zerotier-one/planet
sudo systemctl start zerotier-one
Android / iOS：
移动端不支持替换 planet 文件，请改用 Moon 方式接入：将 .moon 文件放入客户端的 moons.d/ 目录（Android 路径为内部存储的 ZeroTier/moons.d/）。
第三步：加入网络
替换 planet 文件并重启服务后，加入网络：
Windows / macOS / Android / iOS：
在 ZeroTier 客户端界面中点击 Join Network，输入网络 ID。
Linux：
sudo zerotier-cli join <Network-ID>
第四步：申请授权
加入网络后，你的设备处于 未授权 状态，无法通信。需要联系管理员授权：
管理面板不开放注册和登录。 如需加入网络或遇到连接问题，请发送邮件至：
邮件中请提供以下信息：
- 你的设备 Node ID（在 ZeroTier 客户端中查看，格式为 10 位十六进制字符，如
1a2b3c4d5e）- 期望的 IP 地址（可选，不指定则自动分配）
- 用途简述
管理员收到邮件后会授权你的设备，授权完成后设备状态变为 OK，即可与其他节点通信。
常见问题
加入网络后状态一直显示 Requesting
- 确认 planet 文件已正确替换且服务已重启
- 确认已发送邮件申请授权，管理员尚未通过
替换 planet 后无法连接
- 确认 planet 文件没有损坏（文件大小约 1-2KB）
- 确认服务已完全重启
- Linux 可用
sudo zerotier-cli info查看连接状态
忘记 Node ID
- Windows：右键任务栏 ZeroTier 图标 → 点击 Node ID 即可复制
-
Linux：
sudo zerotier-cli info，输出中的200 info <Node-ID> ...即为 Node ID - macOS：菜单栏 ZeroTier 图标 → 点击 Node ID
需要使用 Moon 接入（可选）
如果你无法替换 planet 文件（如移动端），可以使用 moon 文件接入：
Linux：
sudo mkdir -p /var/lib/zerotier-one/moons.d
sudo cp 000000xxxxx.moon /var/lib/zerotier-one/moons.d/
sudo systemctl restart zerotier-one
Windows：
mkdir "C:\ProgramData\ZeroTier\One\moons.d"
copy 000000xxxxx.moon "C:\ProgramData\ZeroTier\One\moons.d\"
# 然后重启 ZeroTier One 服务
Android：
- 在手机内部存储根目录下创建
ZeroTier/moons.d/文件夹 - 将
.moon文件放入该文件夹 - 重新启动 ZeroTier 客户端
Moon 方式需要同时保留官方 planet 文件，不需要替换。