Docker 部署

本页适用于从 JumpCLI 应用源代码部署单个应用服务。商业计费与认证服务需要按各自页面 单独准备。

前置条件

• Docker 24 或更高版本。
• Docker Compose v2。
• 至少 2GB 内存；同时运行计费栈时建议 4GB 或更多。
• 可持久化的数据和图像存储空间。

准备环境文件

cp .env.example .env

至少配置访问控制、管理员二次验证和上游模型服务。示例仅使用占位值：

ACCESS_KEY=replace-with-access-gate-secret
ADMIN_KEY=replace-with-distinct-step-up-secret
DEFAULT_API_URL=https://api.example.com
DEFAULT_API_KEY=replace-with-api-key-reference
DEFAULT_API_PATH=/v1/images/generations

生产 HTTPS 环境使用公开域名而不是内网端口。以下为不含秘密的最小示例：

PUBLIC_ORIGIN=https://app.jumpcli.com
ALLOWED_HOSTS=app.jumpcli.com
CASDOOR_PUBLIC_ORIGIN=https://auth.jumpcli.com
CASDOOR_REDIRECT_URI=https://app.jumpcli.com/api/identity/callback
ACCESS_COOKIE_SECURE=true
TRUST_PROXY_HEADERS=true
TRUSTED_PROXY_IPS=replace-with-your-proxy-ip-or-cidr

仅在已填写真实反向代理 IP 或 CIDR 后启用 TRUST_PROXY_HEADERS。不要把 Casdoor、 Meteroid 或支付密钥写进本文示例或版本库。

启动

从当前代码构建：

docker compose -f docker-compose.yml -f docker-compose.local.yml up -d --build

查看服务状态：

docker compose ps
docker compose logs web --tail 50

验证

curl --fail --silent --show-error http://127.0.0.1:9090/health

响应中应包含 "status":"ok"。随后使用测试账户完成一次登录和最小生成请求。

更新

更新前备份数据目录和必要的维护日志；然后拉取已审核的版本并重新构建。不要通过删除 数据卷来解决启动问题。