ocker 简易部署
ztncui 是由 Key Networks 开发的 ZeroTier 控制器 Web 管理界面,可用于自建 ZeroTier 私有网络 Controller,并提供可视化管理页面,非常适合自建控制节点的人群。
本文基于 Docker 环境,快速部署 ZeroTier Controller + ztncui。
1. 准备目录结构
创建数据目录(持久化 zt1 & 配置文件):
mkdir -p /mydata/zt1
mkdir -p /mydata/ztncui
确保两个目录权限正常,否则容器可能无法写入。
2. 使用 Docker 启动 ZeroTier Controller + ztncui
下面是一条开箱即用的 Docker 命令:
docker run -d \
--name ztncui \
-v /mydata/zt1:/var/lib/zerotier-one \
-v /mydata/ztncui:/opt/key-networks/ztncui/etc \
-p 3443:3443 \
-p 3000:3000 \
-e MYADDR=1.2.3.4 \
-e ZTNCUI_PASSWD=admin123 \
--restart=always \
keynetworks/ztncui
参数说明:
| 参数 | 说明 |
|---|---|
-v /mydata/zt1:/var/lib/zerotier-one | ZeroTier Controller 数据目录(保存 identity、network 等) |
-v /mydata/ztncui:/opt/key-networks/ztncui/etc | ztncui 配置存储目录 |
-p 3443:3443 | ztncui Web 管理界面(HTTPS) |
-p 3000:3000 | ZeroTier Controller API 端口 |
MYADDR=1.2.3.4 | 你服务器的公网 IP |
ZTNCUI_PASSWD=admin123 | Web 登录密码(强烈建议修改) |
--restart=always | 容器自动重启 |
keynetworks/ztncui | 官方/社区镜像 |
3. 查看运行状态
docker ps -a
如果看到:
ztncui Up ... 3443/tcp
说明运行成功。
4. 访问 ztncui Web 管理界面
打开浏览器访问:
https://你的服务器IP:3443
首次登录:
- 用户名:
admin - 密码: 你在环境变量设置的 ZTNCUI_PASSWD(如 admin123)
若使用 https 出现证书警告,忽略即可(自签名证书)。
5. 创建 ZeroTier 私有网络(Controller 模式)
进入 ztncui 后,可进行:
- 创建新的 ZeroTier 网络
- 管理成员(授权、分配 IP)
- 设置 Routes / DNS / IPv6
- 控制器切换为私有控制模式
- 自动生成 ZeroTier 加入命令
非常适合私有组网需求。
6. 在客户端加入你的私有 ZeroTier 网络
通过普通 ZeroTier 客户端:
zerotier-cli join <network-id>
网络 ID 可在 ztncui 界面中获得。
如果需要搭配 Moon:
- 可将本机同时搭建 Moon 节点
- 避免 NAT 环境连接不稳定







