PaaS 平台部署

Hub 只是一个无状态容器加一个 PostgreSQL，可以部署在 Zeabur、Railway、Render、Koyeb、Sealos、Fly.io 等任意支持 Docker 镜像的平台。

步骤

1. 在平台上创建一个托管 PostgreSQL，复制它的连接串。
2. 新建服务，镜像填 ghcr.io/trageeker/assemblyai-hub:latest（或固定版本，如 :3.4.0）。
3. 设置环境变量：

变量	必填	说明
DATABASE_URL	是	postgres://user:pass@host:5432/db，postgresql:// 和 ?sslmode=require 都支持
SECRET_KEY	是	长随机字符串，加密上游 Key；设置后不要更改
ADMIN_PASSWORD	是	控制台密码
PUBLIC_BASE_URL	推荐	服务的公网 HTTPS 地址，开启回调
WEBHOOK_SECRET	推荐	回调鉴权头的值
PORT	视平台	监听端口，默认 8000；多数平台会自动注入

4. 暴露 HTTP 端口（默认 8000），部署。
5. 健康检查路径填 /healthz。

注意事项

• 只运行一个实例。 后台轮询、订阅更新和 sing-box 都在进程内运行，多实例会重复轮询、端口冲突。
• 冷启动 / 休眠。 免费档会休眠的平台会让回调和轮询中断，任务要等服务唤醒后才会更新。
• 上传大小。 部分平台的入口代理限制请求体大小（如 100 MB），超出时上传会被平台直接拒绝，与 MAX_UPLOAD_MB 无关。
• WebSocket。 使用实时中继模式时，确认平台支持 WebSocket 且空闲超时足够长。
• 镜像可见性。 若镜像仓库为私有，需要在平台上配置 GHCR 的拉取凭据，或自行构建并推送到你的镜像仓库。