Debian 系统安装 ZeroTier 并配置 Moon 服务器完整教程

简介

ZeroTier 是一个基于 P2P 的虚拟局域网工具，可以让分布在不同网络的设备组建虚拟局域网。Moon 服务器（根服务器）可以提供更快的连接速度和更稳定的中转服务。

一、安装 ZeroTier

方法一：使用官方安装脚本（推荐）

curl -s https://install.zerotier.com | sudo bash

方法二：手动安装

# 添加 ZeroTier GPG 密钥
curl -s 'https://raw.githubusercontent.com/zerotier/ZeroTierOne/master/doc/contact%40zerotier.com.gpg' | gpg --dearmor | sudo tee /usr/share/keyrings/zerotier-archive-keyring.gpg >/dev/null

# 添加 ZeroTier 仓库
echo "deb [signed-by=/usr/share/keyrings/zerotier-archive-keyring.gpg] http://download.zerotier.com/debian/bullseye bullseye main" | sudo tee /etc/apt/sources.list.d/zerotier.list

# 更新软件包列表并安装
sudo apt update
sudo apt install zerotier-one

二、启动并配置服务

# 启动 ZeroTier 服务
sudo systemctl start zerotier-one

# 设置开机自启动
sudo systemctl enable zerotier-one

# 查看服务运行状态
sudo systemctl status zerotier-one

三、加入 ZeroTier 网络

# 加入网络（将 NETWORK_ID 替换为你的网络 ID）
sudo zerotier-cli join NETWORK_ID

# 查看网络连接状态
sudo zerotier-cli listnetworks

输出示例：

200 listnetworks <nwid> <name> <mac> <status> <type> <dev> <ZT assigned ips>
200 listnetworks NETWORK_ID mynetwork xx:xx:xx:xx:xx:xx OK PRIVATE ztxxxxxxxx 10.x.x.x/24

四、授权设备

1. 访问 ZeroTier Central
2. 登录你的账户
3. 找到对应的网络
4. 在成员列表中找到你的设备
5. 勾选授权复选框

五、配置 Moon 服务器

重要说明

⚠️ 注意：ZeroTier Moon 服务器需要通过配置文件（.moon 文件）添加，而不是直接使用 Moon ID。

添加步骤

1. 获取 Moon 配置文件

向 Moon 服务器管理员获取 .moon 配置文件，文件名格式通常为：<MOON_ID>.moon

2. 创建 moons.d 目录（如果不存在）

sudo mkdir -p /var/lib/zerotier-one/moons.d/

3. 放置 Moon 配置文件

# 将 .moon 文件复制到配置目录
sudo cp <MOON_ID>.moon /var/lib/zerotier-one/moons.d/

或通过 URL 直接下载（如果提供）：

cd /var/lib/zerotier-one/moons.d/
sudo wget http://moon服务器地址/<MOON_ID>.moon

4. 重启 ZeroTier 服务

sudo systemctl restart zerotier-one

5. 验证 Moon 连接

# 查看所有对等节点，MOON 标记表示 Moon 服务器
sudo zerotier-cli listpeers | grep MOON

成功输出示例：

200 listpeers <MOON_ID> 1.2.3.4/9993;12345;12345 50 1.10.6 MOON

六、验证配置

检查节点信息

sudo zerotier-cli info

检查网络状态

sudo zerotier-cli listnetworks

检查 IP 分配

ip addr show | grep zt
sudo zerotier-cli listnetworks

测试连通性

ping 10.x.x.x

七、常用命令

网络管理

sudo zerotier-cli join <NETWORK_ID> 
sudo zerotier-cli leave <NETWORK_ID> 
sudo zerotier-cli listnetworks

Moon 服务器管理

加入MOON服务器命令

sudo zerotier-cli orbit Moonid Moonid

sudo zerotier-cli listpeers | grep MOON 
sudo rm /var/lib/zerotier-one/moons.d/<MOON_ID>.moon 
sudo systemctl restart zerotier-one

# 查看所有对等节点，MOON 标记表示是 Moon 服务器
sudo zerotier-cli listpeers

# 输出示例（成功连接的样子）：
# 200 listpeers <ztaddr> <path> <latency> <version> <role>
# 200 listpeers 000000fac6ae907d 1.2.3.4/9993;12345;12345 50 1.10.6 MOON

服务管理

sudo systemctl start zerotier-one
sudo systemctl stop zerotier-one
sudo systemctl restart zerotier-one
sudo systemctl status zerotier-one
sudo journalctl -u zerotier-one -f

八、防火墙配置

ZeroTier 使用 UDP 9993 端口，确保防火墙允许该端口：

sudo ufw allow 9993/udp
sudo iptables -A INPUT -p udp --dport 9993 -j ACCEPT

九、故障排除

问题 1：无法加入网络

解决方法：

• 检查网络 ID 是否正确
• 确认服务是否正常运行：sudo systemctl status zerotier-one
• 查看日志：sudo journalctl -u zerotier-one -n 50

问题 2：已加入但未分配 IP

• 检查设备是否授权
• 确认 IP 自动分配设置
• 重启服务：sudo systemctl restart zerotier-one

问题 3：Moon 服务器添加失败

404 orbit

• 确认 .moon 文件是否正确
• 检查路径：/var/lib/zerotier-one/moons.d/
• 确认 Moon 服务器在线
• 手动添加MOON文件

• # 进入容器
  docker exec -it zerotier-one sh
  
  # 创建 moons.d 目录
  mkdir -p /var/lib/zerotier-one/moons.d
  
  # 下载 Moon 配置文件（需要实际地址）
  cd /var/lib/zerotier-one/moons.d
  wget http://moon服务器地址/<Moon_ID>.moon
  
  # 或使用 curl
  curl -O http://moon服务器地址/<Moon_ID>.moon
  
  # 退出容器
  exit
  
  # 重启容器
  docker restart zerotier-one
  
  或者
  # 将 moon 文件复制到数据目录
  cp <Moon_ID>.moon /mnt/data/docker/zerotier/moons.d/
  
  # 重启容器
  docker restart zerotier-one
  
  # 验证
  docker exec zerotier-one zerotier-cli listpeers | grep MOON

   

问题 4：网络延迟较高

• 使用 Moon 服务器优化路径
• 检查本地网络
• 用 sudo zerotier-cli listpeers 查看连接路径

十、配置文件位置

• 配置目录：/var/lib/zerotier-one/
• Moon 配置：/var/lib/zerotier-one/moons.d/
• 网络配置：/var/lib/zerotier-one/networks.d/
• 日志文件：journalctl -u zerotier-one

十一、安全建议

1. 在 ZeroTier Central 中仅授权信任设备
2. 使用私有网络（Private）模式
3. 保持版本更新：

   sudo apt update
   sudo apt upgrade zerotier-one
   

4. 配置防火墙规则限制访问

十二、卸载 ZeroTier

sudo systemctl stop zerotier-one
sudo apt remove --purge zerotier-one
sudo rm -rf /var/lib/zerotier-one
sudo rm /etc/apt/sources.list.d/zerotier.list

总结

通过以上步骤，你已经成功在 Debian 系统上安装并配置了 ZeroTier，实现了：

• ✅ 安装 ZeroTier 客户端
• ✅ 加入虚拟网络
• ✅ 配置 Moon 服务器加速
• ✅ 掌握常用管理命令

ZeroTier 可以让你轻松构建跨地域的虚拟局域网，适用于远程办公、游戏联机、NAS 访问等多种场景。

参考资料

• ZeroTier 官方文档
• ZeroTier GitHub
• ZeroTier Central 控制面板