ZTM (零信任网格) 技术文档

【免费下载链接】ztmZTM（零信任网格）是一个以隐私为先的开源去中心化端到端加密软件定义网络，基于HTTP/2隧道。体验无限连接，将全球网格化！项目地址: https://gitcode.com/flomesh-io/ztm

1. 安装指南

1.1 下载安装

ZTM提供两种形式的发布包：

• CLI工具（单可执行应用程序）
• 桌面应用程序（包含CLI工具并提供GUI界面）

推荐从官方发布页面下载最新二进制版本。如需从源码构建，请参考构建文档。

1.2 系统要求

支持以下平台：

• 操作系统：Linux/Windows/macOS/FreeBSD/Android/iOS
• CPU架构：x86/ARM/MIPS/RISC-V/LoongArch等

2. 项目使用说明

2.1 基本架构

典型部署包含3类节点：

1. Hub节点：作为中心协调器（通常部署在云服务器）
2. Agent节点：作为终端接入点（可部署在任何网络环境）
3. 应用节点：运行各类分布式应用

2.2 快速启动示例

2.2.1 启动Hub服务（Linux）

ztm start hub --listen 0.0.0.0:8888 --names 1.2.3.4:8888 --permit root.json

此命令会：

• 监听8888端口
• 生成root.json许可文件
• 注册为systemd服务

2.2.2 启动Agent节点

ztm start agent # Linux/macOS ztm run agent # Windows

2.2.3 加入网格网络

ztm join MESH_NAME --as EP_NAME --permit root.json

2.3 管理命令

3. API使用文档

3.1 核心API功能

• 证书认证：基于TLS的通信加密
• 访问控制：通过root.json实现权限管理
• 服务发现：终端节点自动注册与发现

3.2 内置应用API

1. 隧道服务：

   ztm tunnel [参数]

2. 网络转发服务：

   ztm forward [参数]

3. 脚本执行：

   ztm script [PipyJS脚本]

4. 安装方式详解

4.1 二进制安装

1. 下载对应平台的发布包
2. 解压后添加可执行权限
3. 将可执行文件放入系统PATH路径

4.2 源码编译

需要安装以下依赖：

• Rust工具链
• Tauri框架
• Vite5构建工具 具体编译步骤请参考构建文档。

4.3 容器化部署

提供Docker镜像支持：

docker run -p 8888:8888 flomesh/ztm-hub

5. 高级功能

5.1 自定义PipyJS脚本

支持通过脚本实现：

• 网络流量定制化处理
• 安全策略动态调整
• 协议转换等扩展功能

5.2 应用开发

开发者可以：

1. 基于Agent API开发分布式应用
2. 通过PipyJS实现网络功能扩展
3. 发布应用到ZTM应用市场

提示：所有功能均可通过CLI或Web GUI（localhost:7777）操作

【免费下载链接】ztmZTM（零信任网格）是一个以隐私为先的开源去中心化端到端加密软件定义网络，基于HTTP/2隧道。体验无限连接，将全球网格化！项目地址: https://gitcode.com/flomesh-io/ztm