本地 Docker 部署

使用受支持的本地服务栈进行评估与集成测试。

受支持的本地 Docker 服务栈会同时运行 Gateway、Web、Identity、PostgreSQL、Redis 和对象存储。旧的 SQLite 单镜像配置已退役，因为当前 Gateway 需要 PostgreSQL。

启动最小化配置

在已检出的仓库根目录运行：

bash
bun run docker:up

网关监听 http://127.0.0.1:8877。发送请求前请等待容器健康检查通过。

健康检查

bash
curl http://127.0.0.1:8877/healthz
curl http://127.0.0.1:8877/readyz

数据与凭证

  • PostgreSQL、Redis 和对象存储数据保存在具名 Docker volume 中。
  • 示例 Compose 文件包含仅用于开发的 bootstrap 凭证。
  • 与他人共享环境前必须替换所有 bootstrap secret。
  • 不要把该配置直接暴露到公网。

生产边界

最小化配置不是生产拓扑。生产部署需要外部 PostgreSQL、Redis、托管密钥、对象存储、独立 Web 与 Identity 服务、TLS ingress、迁移、备份和回滚证据。规划生产私有化部署前请联系支持。

停止配置但保留数据卷：

bash
bun run docker:down