# 自建 ZeroTier 私有网络 - 加入指南

## 🌐 网络信息

| 项目 | 值 |
|------|-----|
| **网络 ID** | `0440aaedaf778dc4` |
| **Planet 服务器** | `138.2.48.251:9994` |
| **IP 网段** | `10.6.6.0/24` |
| 网络名称 | ARM-私有网络 |

---

## 📥 下载 Planet 配置文件

> **重要**：必须将本文件替换到客户端的 planet 目录，才能连接自建网络。

- [⬇️ 下载 planet 文件](https://zero.zddyz.org/zt/planet)
- [⬇️ 下载 moon 文件](https://zero.zddyz.org/zt/0000000440aaedaf.moon)

---

## 🖥️ Linux 客户端接入步骤

### 1. 安装 ZeroTier

```bash
# Debian/Ubuntu
curl -s https://install.zerotier.com | sudo bash
```

### 2. 替换 planet 文件

```bash
# 备份原文件
sudo cp /var/lib/zerotier-one/planet /var/lib/zerotier-one/planet.bak

# 下载本服务器生成的 planet 文件
sudo curl -o /var/lib/zerotier-one/planet https://zero.zddyz.org/zt/planet

# 重启 zerotier 服务
sudo systemctl restart zerotier-one
```

### 3. 加入网络

```bash
sudo zerotier-cli join 0440aaedaf778dc4
```

### 4. 验证连接

```bash
# 查看是否连接 PLANET (应显示 138.2.48.251)
sudo zerotier-cli peers

# 查看本机分配到的 IP
sudo zerotier-cli listnetworks
```

### 5. 在管理面板授权

访问 `http://138.2.48.251:3443` (admin/password)，在 Networks 里找到 `0440aaedaf778dc4`，勾选允许该新节点。

---

## 🔧 一键脚本

以下脚本自动完成 Linux 客户端的安装+配置+加入：

```bash
#!/bin/bash
# 一键加入自建 ZeroTier 网络 (ARM-私有网络)
NETWORK_ID="0440aaedaf778dc4"
PLANET_URL="https://zero.zddyz.org/zt/planet"

echo "[1/4] 安装 ZeroTier..."
which zerotier-cli >/dev/null 2>&1 || curl -s https://install.zerotier.com | sudo bash

echo "[2/4] 替换 planet 文件..."
sudo cp /var/lib/zerotier-one/planet /var/lib/zerotier-one/planet.bak 2>/dev/null
sudo curl -s -o /var/lib/zerotier-one/planet "$PLANET_URL"
sudo systemctl restart zerotier-one
sleep 5

echo "[3/4] 加入网络..."
sudo zerotier-cli join "$NETWORK_ID"

echo "[4/4] 完成！请到管理面板 http://138.2.48.251:3443 授权本节点"
echo "验证: sudo zerotier-cli peers / sudo zerotier-cli listnetworks"
```

> 保存为 `join-zerotier.sh`，然后 `bash join-zerotier.sh` 执行。

---

## 🍎 macOS 客户端

```bash
# 替换 planet
sudo cp "/Library/Application Support/ZeroTier/One/planet" "/Library/Application Support/ZeroTier/One/planet.bak"
sudo curl -o "/Library/Application Support/ZeroTier/One/planet" https://zero.zddyz.org/zt/planet

# 重启
sudo kill $(cat "/Library/Application Support/ZeroTier/One/zerotier-one.pid")

# 加入网络
zerotier-cli join 0440aaedaf778dc4
```

## 📱 Android

推荐使用 [ZerotierFix](https://github.com/kaaass/ZerotierFix) 客户端，导入 planet 文件后加入网络。

---

## 🖥️ Windows

1. 安装 [ZeroTier 官方客户端](https://www.zerotier.com/download/)
2. 将 `planet` 文件放到 `C:\ProgramData\ZeroTier\One\`
3. 重启 ZeroTier 服务
4. `zerotier-cli join 0440aaedaf778dc4`

---

## ❓ 常见问题

**Q: `zerotier-cli peers` 没看到 PLANET?**
A: 确认 planet 文件替换正确，且防火墙放行 9994/udp 端口。

**Q: 加入后没分配到 IP?**
A: 到管理面板 `http://138.2.48.251:3443` 授权该节点。

**Q: 需要防火墙放行哪些端口？**
A: `9994/tcp`、`9994/udp`、`3443/tcp`（管理面板）。