10分钟快速上手:手把手搭建你自己的ZTM零信任Mesh网络

原创2026-10-26 23:02:041,403 阅读

10分钟快速上手:手把手搭建你自己的ZTM零信任Mesh网络

ZTM(Zero Trust Mesh)是一个隐私优先、开源的分布式零信任 Mesh 网络工具,基于 HTTP/2 隧道与 TLS 全链路加密,让你无需公网 IP、无需端口映射,就能把家庭、公司、云端的不同设备连成一张端到端加密的私有网络。本文将带你用不到 10 分钟,从零搭建一个属于自己的 ZTM 零信任 Mesh 网络,并快速体验隧道、远程终端等实用功能。

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 有两种方式:

  1. 下载官方二进制(推荐新手):从项目的 Release 页面下载对应操作系统的版本,包含 CLI 单文件可执行程序(SEA)和带图形界面的桌面应用。
  2. 源码构建:如果想在最新代码上尝鲜,按 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 条核心命令。接下来可以:

零信任 + 去中心化 + 全链路加密,这就是 ZTM 给你的自由与掌控。现在,把家里的设备、公司设备、云端主机连起来吧!

登录后查看全文
ztm