10分钟快速上手:手把手搭建你自己的ZTM零信任Mesh网络
10分钟快速上手:手把手搭建你自己的ZTM零信任Mesh网络
ZTM(Zero Trust Mesh)是一个隐私优先、开源的分布式零信任 Mesh 网络工具,基于 HTTP/2 隧道与 TLS 全链路加密,让你无需公网 IP、无需端口映射,就能把家庭、公司、云端的不同设备连成一张端到端加密的私有网络。本文将带你用不到 10 分钟,从零搭建一个属于自己的 ZTM 零信任 Mesh 网络,并快速体验隧道、远程终端等实用功能。
为什么需要 ZTM 零信任 Mesh 网络?
想象一下:你想在外地安全地访问家里的电脑、和朋友点对点传大文件、或者在办公室远程执行家里设备上的命令。传统方案要么需要公网 IP + 端口转发,要么依赖第三方中继服务,隐私和安全性都打折扣。
ZTM 的核心思路是**"去中心化 + 证书身份"**:
| 核心能力 | 说明 |
|---|---|
| 跨网关连接 | 穿透防火墙、NAT,任意两台设备可互通 |
| 全链路加密 | 所有流量经 TLS 加密,点对点直连 |
| 证书认证 | 基于"设备 + 证书"的零信任身份体系,只有被许可的用户才能加入网络 |
| 去中心化 | 文件、应用可在 Mesh 内部分布式发现与共享,不依赖中心化平台 |
从"2 节点的个人网络(家里 ↔ 公司)"到"上万节点的企业网络",ZTM 都能胜任。更多架构细节可参阅 docs/Architecture-Concepts.md。
搭建前的准备:获取 ZTM 工具
搭建一个典型的最小 Mesh 只需要 3 台设备:1 台运行 Hub(通常是一台有公网 IP 的云主机),2 台运行 Agent(任何能上网的电脑/设备,称为 Endpoint)。
数据中心(云主机)
+-----------------------------+
| Hub |
+-----------------------------+
| HTTPS 8888 | HTTPS 8888
互联网/防火墙
| |
+---------------+ +---------------+
| Agent @ 家里 | | Agent @ 公司 |
+---------------+ +---------------+
获取 ZTM 有两种方式:
- 下载官方二进制(推荐新手):从项目的 Release 页面下载对应操作系统的版本,包含 CLI 单文件可执行程序(SEA)和带图形界面的桌面应用。
- 源码构建:如果想在最新代码上尝鲜,按 docs/Build.md 安装依赖(Clang、CMake、Node.js 等)后克隆仓库构建:
git clone https://gitcode.com/gh_mirrors/zt/ztm
cd ztm
./build.sh
构建产物位于 ztm/bin/ztm,将其加入 PATH 即可使用。
💡 官方文档中的 README.md 提供了 Quick Start 章节,是搭建过程中最好的参考资料。
第一步:启动 Hub(1 台云主机)
假设你的云主机公网 IP 是 1.2.3.4,且放行了 8888 端口。只需一条命令:
ztm start hub --listen 0.0.0.0:8888 --names 1.2.3.4:8888 --permit root.json
各参数含义:
--listen:Hub 监听地址,固定为0.0.0.0:8888;--names:对外通告的 Hub 地址(公网 IP:端口),Agent 将用它来接入;--permit:生成根用户许可文件root.json,后续所有设备都要凭它加入 Mesh。
执行后,Hub 会作为系统服务(systemd)在后台运行,本地会生成 root.json。这个文件包含 CA 证书与 root 用户凭证,请务必妥善保管,它是整张网络的"根钥匙"。
第二步:启动 Agent 并加入 Mesh(每台设备)
在你的家庭电脑上执行:
# 启动 Agent(注册为系统服务)
ztm start agent
# 使用 root.json 许可加入 Mesh
ztm join my-mesh --as home --permit root.json
参数说明:
my-mesh:Mesh 的本地名称,自己起,用于本机同时管理多个网络时区分;--as home:当前端点在 Mesh 中的名字,其他设备会看到home;--permit root.json:把第一步生成的root.json拷贝到本机后作为加入凭证。
⚠️ 在 Windows 上暂不支持注册为系统服务,请改用
ztm run agent在前台运行。
在公司电脑上重复同样的两条命令,只是把 --as 换成 workplace。至此,两台设备已经通过云端 Hub 建立起了加密隧道。
第三步:验证 Mesh 网络状态
在任意一台设备上确认网络已经连通:
# 查看本机加入的 Mesh
ztm get mesh
# NAME JOINED AS USER HUBS STATUS
# my-mesh home root 1.2.3.4:8888 Connected
# 查看 Mesh 中的所有端点
ztm get ep
# NAME USER IP PORT STATUS
# home (local) root 10.0.0.5 13297 Online
# workplace root 103.116.x.x 18687 Online
看到两台端点都是 Online,说明你的 ZTM 零信任 Mesh 网络已经搭建成功了!🎉
第四步:让网络真正有用 —— 试试内置应用
只把设备连起来还不够,真正让 Mesh 产生价值的是跑在其中的 App。官方版本内置了 4 个实用应用:
| 应用 | 功能 | 典型场景 |
|---|---|---|
| Tunnel | 在端点间建立安全 TCP/UDP 隧道 | 远程访问家里的 Web 服务、RDP |
| Proxy | SOCKS/HTTP 正向代理 | 让流量从公司网络"借道"回家 |
| Terminal | 远程 Shell 终端 | 免 SSH、免端口映射远程执行命令 |
| Script | 远程执行 PipyJS 脚本 | 在任意端点跑自动化任务 |
远程终端示例(最直观的验证)
在家庭电脑上先设置白名单,只允许 root 用户接入终端:
ztm terminal config --add-user root
然后在公司电脑上一条命令连入家庭电脑:
ztm terminal open home
uname -a
无需知道对方内网 IP、无需任何端口映射,命令直接在远端设备上执行。更多用法见 docs/ZT-App.md(含隧道、代理、脚本、云盘四大应用的完整指南)。
图形界面(可选)
启动 Agent 后,直接用浏览器打开 http://localhost:7777,就能通过网页完成加入 Mesh、查看端点、管理应用等操作——几乎所有 CLI 功能在 GUI 中都有对应入口,桌面应用更是开箱即用。
用命令管理你的应用
ztm get app # 列出已安装的应用
ztm APP_NAME help # 查看某个应用的详细用法
常见问题速查
Hub 需要一台 24 小时在线的机器吗? 需要。Hub 承担身份签发与端点注册,通常部署在云主机上;所有端点之间的数据流量仍然走加密隧道直连,Hub 只是"调度中心"。
root.json 丢失了怎么办?
它是 root 用户的许可凭证,丢失后无法再加入已创建的 Mesh。请务必备份;也可以登录后用 ztm invite 为其他用户签发新的 permit。
两台设备在同一局域网可以测试吗? 可以,Agent 之间支持 P2P 直连,同一 LAN 内不需要经过公网 Hub 也能通信,适合先用本地环境演练。
支持哪些系统和架构? 非常广:Linux、macOS、Windows、FreeBSD、Android 等系统,以及 x86、ARM、MIPS、RISC-V、LoongArch 等 CPU 架构,详见 README.md 的 Features 章节。
总结与进阶
到这里,你已经完成了 ZTM 零信任 Mesh 网络的完整搭建:Hub → Agent → Join → 验证 → 使用内置应用,全程 5 条核心命令。接下来可以:
- 查阅 docs/CLI.md 了解全部命令行用法;
- 阅读 docs/Agent-API.md 探索 Agent API,实现二次开发;
- 深入源码:Hub 逻辑见 hub/main.js,Agent 见 agent/main.js,CLI 见 cli/main.js;
- 在 docs/Build.md 中尝试从源码构建最新版本的 ZTM。
零信任 + 去中心化 + 全链路加密,这就是 ZTM 给你的自由与掌控。现在,把家里的设备、公司设备、云端主机连起来吧!
