ZeroTier网络控制器ztncui：Web界面完整安装与配置教程

ztncui是一款专为ZeroTier网络控制器设计的Web用户界面，通过直观的图形化界面帮助用户轻松管理虚拟网络。无需复杂的命令行操作，任何人都能快速搭建和配置ZeroTier网络环境，实现设备间的安全通信。

【免费下载链接】ztncuiZeroTier network controller UI项目地址: https://gitcode.com/gh_mirrors/zt/ztncui

环境准备与依赖安装

在开始安装ztncui之前，需要确保系统满足以下基本要求：

• Node.js v14或更高版本
• ZeroTier One已安装在同一台机器上
• Git版本控制工具

ZeroTier One是ztncui运行的基础组件，负责处理网络控制器的核心功能。确保ZeroTier服务正常运行是成功部署的关键。

三步快速安装流程

1. 克隆项目代码

git clone https://gitcode.com/gh_mirrors/zt/ztncui

2. 安装Node.js依赖包

cd ztncui/src npm install

3. 初始化配置文件

复制默认密码文件并创建环境变量配置：

cp -v etc/default.passwd etc/passwd touch .env

核心配置详解

环境变量设置

在项目根目录创建.env文件，配置以下关键参数：

获取ZeroTier认证令牌的方法：

sudo cat /var/lib/zerotier-one/authtoken.secret

将输出的令牌字符串填入.env文件的ZT_TOKEN字段。

安全权限配置

配置完成后，确保环境文件的安全权限：

chmod 400 .env chown ztncui.ztncui .env

启动与访问管理

手动启动方式

npm start

应用将在默认端口3000上启动，可通过浏览器访问http://localhost:3000进行本地测试。

生产环境自动启动

推荐使用PM2进程管理器实现开机自启：

sudo npm install -g pm2 pm2 start bin/www --name ztncui pm2 startup pm2 save

远程安全访问

通过SSH隧道实现安全的远程访问：

ssh -f user@服务器地址 -L 3333:localhost:3000 -N

然后在本地浏览器访问http://localhost:3333

HTTPS安全配置

启用HTTPS服务

在.env文件中添加HTTPS配置：

HTTPS_PORT=3443

SSL证书创建

cd etc/tls openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout privkey.pem -out fullchain.pem

按照提示填写证书信息，完成后应用将支持HTTPS加密访问。

网络管理实战操作

创建新网络

登录ztncui界面后，点击Networks→Add network，输入网络名称并创建。

设备授权管理

设备加入网络的步骤：

1. 在设备上执行：zerotier-cli join 网络ID
2. 在ztncui中点击members查看待授权设备
3. 勾选Authorized并设置设备名称

IP地址分配

通过easy setup功能快速配置IPv4网络：

• 自动生成网络地址段
• 智能计算IP分配池
• 一键应用配置

常见问题解决方案

无法访问Web界面

检查防火墙设置，开放对应端口：

sudo ufw allow 3000/tcp

确认ZeroTier服务状态：

sudo systemctl status zerotier-one

忘记管理员密码

重置默认管理员密码：

node src/scripts/reset-password.js admin password

网络连接问题

确保所有设备都已正确授权，并检查IP分配池配置是否合理。

最佳实践建议

• 首次登录后立即修改默认管理员密码
• 创建专用用户账户代替默认admin账户
• 定期备份网络配置信息
• 使用HTTPS确保通信安全

通过ztncui，即使是没有网络管理经验的用户也能轻松搭建和管理ZeroTier虚拟网络。无论是个人使用还是团队协作，这款工具都能提供专业级的网络管理体验。

【免费下载链接】ztncuiZeroTier network controller UI项目地址: https://gitcode.com/gh_mirrors/zt/ztncui