OpenZiti 入门（3）：安装并登录 Ziti Admin Console（ZAC）

上一篇我们用 CLI 创建了 Echo 服务。这一篇给本地 Quickstart 网络加上网页管理界面 Ziti Admin Console（ZAC），并在浏览器里查看网络对象。

本文参考官方 ZAC 安装指南，以 Ubuntu / WSL2 中的本地免 Docker Quickstart 为例。

1. 准备环境并下载 ZAC

在 Ubuntu 终端中恢复 Quickstart 环境变量：

bash
source "${HOME}/.ziti/quickstart/$(hostname)/$(hostname).env"
echo "$ZITI_HOME"
export ZITI_HOME

确认 ZITI_HOME 显示的是 Quickstart 的工作目录。然后下载 ZAC 3.0 或更高版本的发布包，并解压到该目录：

bash
wget -O ziti-console.zip \
  https://github.com/openziti/ziti-console/releases/latest/download/ziti-console.zip

unzip -d "${ZITI_HOME}/console" ./ziti-console.zip

如果系统提示找不到 unzip，先安装它：

bash
sudo apt-get update
sudo apt-get install -y unzip

2. 把 ZAC 加到 Controller 配置中

打开 Quickstart 生成的 Controller 配置文件：

bash
nano "${ZITI_HOME}/$(hostname -s).yaml"

在 web 配置中找到包含 edge-management 的 apis: 列表，并在同一列表中添加 zac。新条目要与 - binding: edge-management 对齐：

yaml
          - binding: zac
            options:
              location: ./console
              indexFile: index.html

保存文件并退出。ZAC 必须和 edge-management 配置在同一个 Web API 监听器下；location 指向刚解压的目录。

3. 重启本地 Quickstart 网络

回到上一篇启动 Quickstart 的终端，在同一个 Bash 环境中依次重启：

bash
stopRouter
stopController
startController
startRouter

这里使用 Quickstart 提供的辅助命令。官方文档中针对 systemd 服务的重启命令适用于另一种部署方式；本教程使用的是本地 Quickstart。

4. 在浏览器中打开 ZAC

先在 Ubuntu 终端中查看本地 Quickstart 使用的地址：

bash
echo "https://${ZITI_CTRL_EDGE_ADVERTISED_ADDRESS}:${ZITI_CTRL_EDGE_ADVERTISED_PORT}/zac/"

用输出的地址在浏览器中打开 ZAC。本地 Quickstart 默认管理 API 端口为 1280，因此常见地址类似：

text
https://<本机广告地址>:1280/zac/

如果在 WSL2 中通过 Windows 浏览器访问，而本机广告地址无法解析，可以试试：

text
https://localhost:1280/zac/

Quickstart 使用自签名证书，浏览器可能显示证书警告；仅在确认这是自己的本地测试环境时继续访问。公开或生产环境应配置受信任的证书。

5. 登录并查看网络对象

使用 Quickstart 创建的管理员凭据登录。默认用户名是 admin；生成的密码保存在 Quickstart 环境文件的 ZITI_PWD 中。请不要把密码或令牌贴到公开帖子里。

登录后，可以在 ZAC 中查看和管理网络对象，例如 identities、services、edge routers 和 policies。可以回到前两篇中创建的 founder-laptop 和 echo，对照查看 CLI 创建的对象如何显示在控制台中。

常见问题

• 打开页面显示 404：确认已在包含 edge-management 的同一个 apis: 列表中添加 zac，并检查 location: ./console 和解压目录是否一致。
• 登录页面无法连接 Controller：确认浏览器访问的主机名和端口能从当前设备解析并连接；本地免 Docker Quickstart 默认使用 1280 端口。
• 重启后仍看不到 ZAC：确认 Controller 使用的是修改过的配置文件，并检查启动日志是否有 YAML 配置错误。

ZAC 是管理 OpenZiti 网络的网页界面。对于本地免 Docker Quickstart，需要下载 ZAC 发布包、在 Controller 配置中增加 zac API binding，再重启 Controller。

更多细节见官方 ZAC 安装文档。修改管理员密码的步骤见官方密码管理指南。