# docker-zerotier-planet **Repository Path**: code-liufl/docker-zerotier-planet ## Basic Information - **Project Name**: docker-zerotier-planet - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-09-28 - **Last Updated**: 2025-09-28 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README Logo 本项目的 CDN 加速和安全保护由腾讯 EdgeOne 赞助 # Docker ZeroTier Planet > 一键部署 ZeroTier Planet 服务器，支持 Docker 容器化部署 ## 📢 交流群 ### Telegram - **TG交流群**：https://t.me/+JduuWfhSEPdlNDk1 ### QQ Group - **1群**：692635772 - **2群**：785620313 - **3群**：316239544 - **4群**：1027678459 - **5群**：651935808 ## 📱 微信公众号 ![二维码](assets/wechat.png) ## ✨ 功能特性 - ✅ 支持 Linux/AMD64、Linux/ARM64 架构 - 🐳 Docker 容器化部署 - 📥 支持 URL 下载 planet、moon 配置 - 🌐 可作为 Moon 或 Planet 服务器搭建 - 🔧 简单易用的一键部署脚本 - 📊 可视化 Web 管理界面 ## 📋 目录 - [0. 托管服务](#0-托管服务) - [1. ZeroTier 介绍](#1-zerotier-介绍) - [2. 为什么要自建 PLANET 服务器](#2-为什么要自建-planet-服务器) - [3. 开始安装](#3-开始安装) - [3.1 环境准备](#31-环境准备) - [3.2 下载项目源码](#32-下载项目源码) - [3.3 执行安装脚本](#33-执行安装脚本) - [3.4 下载 planet 文件](#34-下载-planet-文件) - [3.5 新建网络](#35-新建网络) - [4. 客户端配置](#4-客户端配置) - [4.1 Windows 配置](#41-windows-配置) - [4.2 Linux 客户端](#42-linux-客户端) - [4.3 安卓客户端配置](#43-安卓客户端配置) - [4.4 MacOS 客户端配置](#44-macos-客户端配置) - [4.5 OpenWRT 客户端配置](#45-openwrt-客户端配置) - [4.6 iOS 客户端配置](#46-ios-客户端配置) - [5. 管理面板 SSL 配置](#5-管理面板-ssl-配置) - [6. 卸载](#6-卸载) - [7. 常见问题](#7-常见问题) - [8. 开发计划](#8-开发计划) - [9. 风险声明](#9-风险声明) - [10. 类似项目](#10-类似项目) - [11. 捐助和支持](#11-捐助和支持) - [12. 鸣谢](#12-鸣谢) --- ## 0. 托管服务 ### 0.1 自运营容器服务 **寻找便捷的解决方案？** 我们提供专业的托管服务： | 服务项目 | 详情 | |---------|------| | **试用期** | 免费试用 3 天 | | **年费** | 仅需 99￥ | | **带宽** | 高速带宽 300Mbit | | **流量政策** | 每月 100G 转发流量，P2P 连接后不计流量，超出后每 10 元 100G | | **机房** | 优质线路：宁波电信机房 | | **联系方式** | Telegram：[https://t.me/uxkram](https://t.me/uxkram) 或加入 QQ 群咨询群主 | **测速图如下：** 宁波机房测速图 ### 0.2 雨云容器服务 [![通过雨云一键部署](https://rainyun-apps.cn-nb1.rains3.com/materials/deploy-on-rainyun-cn.svg)](https://app.rainyun.com/apps/rca/store/6215?ref=220429) ### 0.3 微信公众号 欢迎关注公众号获取最新动态和技术分享 微信公众号二维码 --- ## 1. ZeroTier 介绍 `ZeroTier` 是一款强大的 P2P VPN 工具，它能让你在互联网上搭建属于自己的虚拟局域网。通过它，你可以轻松实现远程访问家中设备的需求 - 比如在公司用手机直接访问家里的 NAS。最重要的是，设备之间是点对点直连的，无需经过中转服务器，既保证了速度，又提升了安全性。 ### 工作原理 通过 `ZeroTier One` 客户端，在不同设备（如笔记本、手机、服务器等）之间建立 P2P 连接，即使这些设备都在 NAT 后面也没问题。它使用了 STUN 等技术，可以穿透大多数类型的 NAT，实现设备间的直接通信。如果实在无法直连，才会通过中转服务器进行通信。 简单来说，`ZeroTier` 就像是一个跨越互联网的"虚拟交换机"，让分布在世界各地的设备，都能像在同一个局域网内一样方便地相互访问。 ![zerotier](assets/zerotier-network.png) ### ZeroTier 网络中的关键概念 | 概念 | 说明 | |------|------| | **PLANET**（行星服务器） | ZeroTier 网络的核心根服务器，负责网络发现和初始连接。相当于整个网络的"中枢" | | **MOON**（卫星服务器） | 用户可以自建的私有根服务器。它可以作为区域性的代理节点，帮助就近的设备更快地建立连接，提升网络性能 | | **LEAF**（叶子节点） | 所有接入 ZeroTier 网络的终端设备，如电脑、手机、服务器等。这些设备通过 PLANET 和 MOON 的协调来相互发现和通信 | 本教程将指导您搭建一个私有的 PLANET 服务器，让您完全掌控自己的 ZeroTier 网络。 --- ## 2. 为什么要自建 PLANET 服务器 自建 PLANET 服务器有以下几个重要原因： ### 🚀 性能优势 - **提升网络稳定性**：官方服务器位于海外，国内用户访问延迟高且不稳定。自建服务器可以大幅提升连接质量 - **加快连接速度**：本地化的 PLANET 服务器可以更快地帮助设备建立 P2P 连接 ### 🔒 安全优势 - **增强网络控制**：自建服务器让您完全掌控网络配置，可以根据需求进行优化调整 - **提高安全性**：私有化部署意味着网络流量不经过第三方服务器，更加安全可靠 ### 💪 可靠性优势 - **降低依赖**：避免因官方服务器故障或网络波动影响您的业务正常运行 --- ## 3. 开始安装 ### 3.1 环境准备 在开始安装之前，请确保您的服务器满足以下条件： #### 服务器要求 - ✅ 拥有公网 IP 地址 - ✅ 需开放以下端口： - `3443/tcp` (管理面板，根据实际情况调整) - `9994/tcp` (ZeroTier 通信，根据实际情况调整) - `9994/udp` (ZeroTier 通信，根据实际情况调整) #### 软件依赖 - ✅ Docker (容器运行环境) - ✅ Git (获取项目代码) #### 系统要求 推荐使用较新的 Linux 发行版： - Debian 12 - Ubuntu 20.04+ - Rocky Linux - 其他同类系统 #### 3.1.1 安装 Git ```bash # Debian/Ubuntu 等 apt update && apt install git -y # CentOS 等 yum update && yum install git -y ``` #### 3.1.2 安装 Docker ```bash curl -fsSL https://get.docker.com | bash ``` > **注意**：如果网络问题导致无法安装，可以使用国内镜像安装，请参考：[安装 Docker](https://help.aliyun.com/zh/ecs/use-cases/install-and-use-docker#33f11a5f1800n) #### 3.1.3 启动 Docker ```bash service docker start ``` #### 3.1.4 配置 Docker 加速镜像（可选） ```bash sudo tee /etc/docker/daemon.json < **提示**：整个脚本预计需要 1-3 分钟，具体时间取决于网络与机型 4. **安装成功标志：** ![install-finish](./assets/install_finish.png) ### 3.4 下载 planet 文件 脚本运行完成后，会在 `./data/zerotier/dist` 目录下生成 `planet` 和 `moon` 配置文件。 您可以通过以下两种方式获取这些文件： 1. **通过安装完成后提供的 URL 直接下载** 2. **使用 scp 或其他文件传输工具从服务器下载** > **重要**：请妥善保存这些文件，后续配置客户端时会用到。 ### 3.5 新建网络 #### 3.5.1 访问管理界面 访问 `http://ip:3443` 进入 controller 页面 ![ui](assets/ztncui.png) **默认登录信息：** - 用户名：`admin` - 密码：`password` #### 3.5.2 创建网络 1. 登录后点击 "Networks" 菜单 2. 点击 "Add Network" 按钮创建新网络 3. 输入一个便于识别的网络名称，其他选项可保持默认 4. 点击 "Create Network" 按钮完成创建 ![ui](assets/ztncui_create_net.png) 创建成功后系统会自动生成一个网络 ID，这个 ID 在后续客户端配置时会用到，请记录下来。 ![ui](assets/ztncui_net_id.png) #### 3.5.3 分配网络 IP 1. 选中 "Easy Setup" ![assign_id](./assets/easy_setup.png) 2. 生成 IP 范围 ![ip_addr](./assets/network_addr.png) --- ## 4. 客户端配置 ZeroTier 支持多种主流操作系统的客户端，包括： - Windows - macOS - Linux - Android ### 4.1 Windows 配置 #### 步骤 1：下载客户端 首先去 ZeroTier 官网下载一个 ZeroTier 客户端 #### 步骤 2：替换 planet 文件 将 `planet` 文件覆盖粘贴到 `C:\ProgramData\ZeroTier\One` 中（这个目录是个隐藏目录，需要允许查看隐藏目录才行） #### 步骤 3：重启服务 1. 按 `Win + S` 搜索 "服务" ![ui](assets/service.png) 2. 找到 ZeroTier One，并且重启服务 ![ui](assets/restart_service.png) #### 步骤 4：加入网络 使用管理员身份打开 PowerShell，执行如下命令： ```powershell PS C:\Windows\system32> zerotier-cli.bat join 网络id 200 join OK PS C:\Windows\system32> ``` > **注意**：网络 ID 就是在网页里面创建的那个网络 ID #### 步骤 5：授权设备 登录管理后台可以看到有个新的客户端，勾选 `Authorized` 即可 ![ui](assets/join_net.png) IP assignment 里面会出现 ZeroTier 的内网 IP ![ip](./assets/allow_devices.png) #### 步骤 6：验证连接 执行如下命令验证连接状态： ```powershell PS C:\Windows\system32> zerotier-cli.bat peers 200 peers fcbaeb9b6c 1.8.7 PLANET 52 DIRECT 16 8994 1.1.1.1/9993 fe92971aad 1.8.7 LEAF 14 DIRECT -1 4150 2.2.2.2/9993 PS C:\Windows\system32> ``` 可以看到有一个 `PLANET` 和 `LEAF` 角色，连接方式均为 `DIRECT`（直连） 到这里就加入网络成功了！ ### 4.2 Linux 客户端 **配置步骤：** 1. 安装 Linux 客户端软件 2. 进入目录 `/var/lib/zerotier-one` 3. 替换目录下的 `planet` 文件 4. 重启 `zerotier-one` 服务：`service zerotier-one restart` 5. 加入网络：`zerotier-cli join 网络id` 6. 管理后台同意加入请求 7. 执行 `zerotier-cli peers` 可以看到 `PLANET` 角色 ### 4.3 安卓客户端配置 推荐使用 [Zerotier 非官方安卓客户端](https://github.com/kaaass/ZerotierFix) ### 4.4 MacOS 客户端配置 **配置步骤：** 1. 进入 `/Library/Application\ Support/ZeroTier/One/` 目录，并替换目录下的 `planet` 文件 2. 重启 ZeroTier-One：`cat /Library/Application\ Support/ZeroTier/One/zerotier-one.pid | sudo xargs kill` 3. 加入网络：`zerotier-cli join 网络id` 4. 管理后台同意加入请求 5. 执行 `zerotier-cli peers` 可以看到 `PLANET` 角色 ### 4.5 OpenWRT 客户端配置 **配置步骤：** 1. 安装 ZeroTier 客户端 2. 进入目录 `/etc/config/zero/planet` 3. 替换目录下的 `planet` 文件 4. 在 OpenWRT 网页后台先关闭 ZeroTier 服务，再开启 ZeroTier 服务 5. 在 OpenWRT 网页后台加入网络 6. 管理后台同意加入请求 7. 执行 `ln -s /etc/config/zero /var/lib/zerotier-one` 8. 执行 `zerotier-cli peers` 可以看到 `PLANET` 角色 ### 4.6 iOS 客户端配置 **方案一：越狱方案** 越狱后安装 ZeroTier，然后替换 `planet` 文件 **方案二：WireGuard 方案** 使用 WireGuard 接入到 ZeroTier 网络 --- ## 5. 管理面板 SSL 配置 管理面板的 SSL 支持需要自行配置，参考 Nginx 配置如下： ```nginx upstream zerotier { server 127.0.0.1:3443; } server { listen 443 ssl; server_name {CUSTOM_DOMAIN}; # 替换自己的域名 # SSL 证书地址 ssl_certificate pem 或 crt 文件的路径; ssl_certificate_key key 文件的路径; # SSL 验证相关配置 ssl_session_timeout 5m; # 缓存有效期 ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4; # 加密算法 ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # 安全链接可选的加密协议 ssl_prefer_server_ciphers on; # 使用服务器端的首选算法 location / { proxy_pass http://zerotier; proxy_set_header HOST $host; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } server { listen 80; server_name {CUSTOM_DOMAIN}; # 替换自己的域名 return 301 https://$server_name$request_uri; } ``` --- ## 6. 卸载 ```bash docker rm -f zerotier-planet ``` --- ## 7. 常见问题 ### Q1: 为什么我 ping 不通目标机器？ **A:** 请检查防火墙设置，`Windows` 系统需要允许 `ICMP` 入站，`Linux` 同理 ### Q2: iOS 客户端怎么用？ **A:** iOS 客户端插件在这里，设备需要越狱：https://github.com/lemon4ex/ZeroTieriOSFix ### Q3: 为什么看不到官方的 Planet？ **A:** 该项目剔除了官方服务器，只保留了自定义的 Planet 节点 ### Q4: 我更换了 IP 需要怎么处理？ **A:** 如果 IP 更换了，则需要重新部署，相当于全新部署 ### Q5: PVE lxc 容器没有创建网卡？ **A:** 需要修改 lxc 容器的配置，同时 lxc 容器需要取消勾选"无特权" 配置文件位置在 `/etc/pve/lxc/{ID}.conf` **Proxmox 7.0 之前的版本添加以下内容：** ``` lxc.cgroup.devices.allow: c 10:200 rwm lxc.mount.entry: /dev/net/tun dev/net/tun none bind,create=file ``` **Proxmox 7.0 之后的版本添加以下内容：** ``` lxc.cgroup2.devices.allow: c 10:200 rwm lxc.mount.entry: /dev/net/tun dev/net/tun none bind,create=file ``` ### Q6: 管理后台忘记密码怎么办？ **A:** 执行 `./deploy.sh`，选择重置密码即可 ### Q7: 为什么连不上 planet？ **A:** 请检查防火墙，如果是阿里云、腾讯云用户，需要在对应平台后台防火墙放行端口。Linux 机器上也要放行，如果安装了 ufw 等防火墙工具。 ### Q8: 如何判断是直连还是中转？ **A:** 管理员权限执行终端，运行 `zerotier-cli peers` ``` 69c0d507d0 - LEAF -1 RELAY 93caa675b0 1.12.2 PLANET -894 DIRECT 4142 4068 110.42.99.46/9994 ab403e2074 1.10.2 LEAF -1 RELAY ``` 如果你的 ztaddr 是 `RELAY`，就说明是中转 ### Q9: 为什么我的 ZeroTier 传输不稳定？ **A:** 由于 ZeroTier 使用的是 UDP 协议，部分地区可能对 UDP 进行了 QoS，可以考虑使用 OpenVPN。 ### Q10: 支持域名吗？ **A:** 暂不支持 ### Q11: ARM 服务器可以搭建吗？ **A:** 可以 ### Q12: 支持 docker-compose 启动部署吗？ **A:** 支持，参考 docker-compose 文件如下： ```yaml version: '3' services: myztplanet: image: xubiaolin/zerotier-planet:latest container_name: ztplanet ports: - 9994:9994 - 9994:9994/udp - 3443:3443 - 3000:3000 environment: - IP_ADDR4=[IPV4IP ADDRESS] - IP_ADDR6= - ZT_PORT=9994 - API_PORT=3443 - FILE_SERVER_PORT=3000 volumes: - ./data/zerotier/dist:/app/dist - ./data/zerotier/ztncui:/app/ztncui - ./data/zerotier/one:/var/lib/zerotier-one - ./data/zerotier/config:/app/config restart: unless-stopped ``` --- ## 8. 开发计划 🥰 您的捐助可以让开发计划的速度更快 🥰 - [ ] 多 planet 支持 - [x] 3443 端口自定义支持 - [ ] planet 和 controller 分离部署 --- ## 9. 风险声明 本项目仅供学习和研究使用，不鼓励用于商业用途。我们不对任何因使用本项目而导致的任何损失负责。 --- ## 10. 类似项目 - [WireGuard 一键脚本](https://github.com/xubiaolin/wireguard-onekey) --- ## 11. 捐助和支持 如果觉得本项目对您有帮助，欢迎通过扫描下方赞赏码捐助项目 :) donate --- ## 12. 鸣谢 感谢以下网友投喂，你们的支持和鼓励是我不懈更新的动力 **按时间顺序排序：** - 随性 - 我 - 你好 - Calvin - 小猪猪的饲养员 - 情若犹在 - 天天星期天 - 啊乐 - 夏末秋至 - **忠 - 岸芷汀兰 - Kimi Chen - 匿名 - 阳光报告旷课 - 濂溪先生 - Water - 匿名 - 匿名 - 陆 - 精钢葫芦娃 - 唯 - 王小新 - 匿名 - Duck不必 --- ## 📚 参考链接 - [ZeroTier-虚拟局域网详解](https://www.glimmer.ltd/2021/3299983056/) - [五分钟自建 ZeroTier 的 Planet/Controller](https://v2ex.com/t/799623)