编排包含什么

项目根目录的 Docker Compose 编排包含一个 Nginx 边缘入口、一个 OpenTokenRouter 主节点、一个工作节点、PostgreSQL 和 Redis。主节点承担主节点任务，工作节点提供无状态路由容量；两者共享数据库和缓存。

本地启动

cp .env.example .env
docker compose up -d --build

启动后访问 http://localhost:3000。边缘入口只有在主节点和工作节点健康后才对外服务。生产环境必须替换默认数据库、Redis 与会话密钥，并在反向代理层启用 HTTPS。

扩展工作节点

docker compose up -d --scale opentokenrouter-worker=3

工作节点共享 PostgreSQL 与 Redis，因此不要把文章图片、密钥文件或持久状态只写入某个容器本地目录。媒体资源应放到对象存储，数据库应配置备份与恢复演练。

上线前检查

  • 为数据库、Redis、会话密钥使用独立强密码。
  • 设置可信代理和正确的公网 ServerAddress，保证回调与 SEO canonical 一致。
  • 验证健康检查、日志、备份、节点下线与故障转移。
  • 先压测真实模型请求，再决定工作节点数量。