首页 / Docker 自托管

Docker 自托管

拓扑

服务镜像端口(宿主)说明
consoleGHCR 不可变 digest(见 下载与校验)127.0.0.1:48500→4730主控制台 + 多用户 API + cchain + RAG 编排
postgrespgvector/pgvector(manifest digest 钉死)不发布mu 库(pgvector 扩展),数据卷 pgdata
bge-m3GHCR sidecar digest不发布RAG 嵌入服务(可选)
webhook-ingressnode:22-alpine + webhook-proxy.js127.0.0.1:48590→8080webhook-only 入口:仅放行 webhook 与 health
compose 全部服务 restart: unless-stopped;仅 console 与 webhook-ingress 发布端口且默认绑定回环; postgres/sidecar 仅内部网络可达。

卷与数据

备份/恢复 = 备份/恢复 pgdata 卷或定期 pg_dump(见 升级与回滚)。

公网入口与反代拓扑(对外)

compose 默认仅在 127.0.0.1 暴露 48500(Console 全量)与 48590(webhook-ingress)。 对外暴露时须由部署者前置 HTTPS 反向代理或隧道(Nginx / Caddy / Cloudflare Tunnel):

可直接复用的 Nginx / Caddy / Cloudflare Tunnel 完整配置模板见 安全加固清单, 公网连通性与 GitHub Delivery 验收步骤见 多租户与 webhook。

cchain 信任链(可选)

三项配置齐全后 cchain=READY,任一缺失即 BLOCKED(fail-closed,控制台如实显示):

健康与巡检

docker compose --env-file .env ps
curl -s http://127.0.0.1:48500/api/health | jq
node preflight.mjs --live

/api/health 的 version 字段是运行版本的唯一真源。