初始化网关
适用场景
首次部署 ZStack API Router 后，需要完成初始化，确认数据库迁移、服务状态和控制台入口可用。
前提条件
zr-server已启动。- PostgreSQL 已完成
zr-migrate迁移。 - 管理员已获得控制面访问凭证。
- 如启用控制台，
ZR_CONSOLE_DIST_DIR已指向控制台静态资源目录。
操作步骤
- 在浏览器访问控制台地址，例如
http://{ROUTER_HOST}:3080/ai-gateway。 - 使用管理员账号或平台注入的登录方式进入控制台。
- 打开 系统状态 页面，确认 服务状态 为正常。
- 打开 模型管理、渠道管理、令牌管理 页面，确认页面可正常加载。
- 在服务器上执行健康检查：
curl -fsS http://{ROUTER_HOST}:3080/healthz
curl -fsS http://{ROUTER_HOST}:3080/readyz验证方式
| 检查项 | 预期结果 |
|---|---|
/healthz | 返回成功。 |
/readyz | 返回 ready。 |
| 控制台 | 可正常登录并查看资源列表。 |
| OpenAPI | /api/zr/openapi.json 可访问。 |
注意事项
- 生产环境请勿使用测试云平台访问令牌（Cloud token）。
- 如控制台无法访问，但
/readyz正常，请优先检查入口代理和静态资源目录。 - 如
/readyz不正常，请先检查ZR_DATABASE_URL和数据库连接。