OpenZiti 安装指南：快速部署测试环境

[openapi]

本文将手把手教你搭建 OpenZiti 测试环境。通过 Docker 快速部署，让你在 10 分钟内拥有一个可用的零信任网络。

一、环境准备

系统要求

项目	最低要求	推荐配置
操作系统	Linux / macOS / Windows	Ubuntu 22.04 / macOS
CPU	2 核	4 核
内存	4 GB	8 GB
磁盘	20 GB	50 GB

必需软件

• Docker
• Docker Compose
• ziti CLI 工具

安装 ziti CLI：

# Linux/macOS 安装脚本
curl -fsSL https://get.openziti.io/quick/install | bash

# 或使用 Homebrew (macOS)
brew install openziti

# 验证安装
ziti --version

二、快速启动

创建本地测试网络

# 创建工作目录
mkdir -p ~/ziti-quickstart
cd ~/ziti-quickstart

# 下载并运行快速启动脚本
curl -fsSL https://get.openziti.io/quick/simple/quickstart-simple.sh | bash

该脚本会自动创建控制器、边缘路由器、生成 PKI 证书。

三、使用 Docker Compose 部署

创建 docker-compose.yml 文件，启动控制器和边缘路由器。

四、验证安装

检查控制器状态

ziti edge login --username admin --password admin --url https://127.0.0.1:1280
ziti edge list controllers
ziti edge list edge-routers

访问 Web 控制台

打开浏览器访问：https://127.0.0.1:1280

默认登录凭据：用户名 admin，密码 admin

五、常见问题

• 端口被占用：修改 docker-compose.yml 中的端口映射
• 证书错误：检查证书文件是否存在
• 容器启动失败：查看 docker compose logs

---

相关资源

• 官方文档：https://openziti.io/docs/
• GitHub 仓库：https://github.com/openziti/ziti
• OpenZiti 中文社区：https://www.openziti.cn