自托管部署

最小可用拓扑、LiveKit 与 Egress、环境变量清单、健康与就绪探针、备份与升级步骤。

版本 v1.1.0 · 更新于 2026-10-26 · 修订 1

自托管是 ni-meet 与「直接用别人的云」最大的区别：整套东西都跑在你自己的机器/集群上。这一页给出三种部署形态、环境变量、健康检查、备份与升级，以及对生产环境的硬要求。

三种形态#

docker compose -f deploy/compose.yml up -d --build
# API            https://api.your-domain.example
# console        https://console.your-domain.example
# docs           https://docs.your-domain.example
# meeting demo   https://meet.your-domain.example
# LiveKit ws     wss://sfu.your-domain.example
# MinIO          https://objects.your-domain.example    （可选 profile `objectstore`，nimeet / nimeet-secret）
# egress worker  internal health/stats surface (not public)

首次启动 API 会把一次性演示凭证写到 data/demo-credentials.json。暴露到公网前必须改掉 CONSOLE_SEED_PASSWORD、NIMEET_WEBHOOK_SIM_SECRET、NIMEET_EGRESS_WORKER_TOKEN。

环境变量（只列会影响功能的）#

健康与就绪#

Kubernetes 里把健康检查端点设为 liveness/readiness；调度器与 worker 的管理端口只在集群内网暴露。

网络与入口#

• 公网反向代理只暴露：/v1/*、/dev/v1/*、/console/*；管理端口仅限集群内网；
• 必须允许 WebSocket 升级（/rtc 反代到 LiveKit），否则客户端会一直重连；
• TURN：compose 里 LiveKit 自带 TURN，需放通 3478/udp 与 5349/tcp；
• LiveKit webhook 只需配置一次（deploy/livekit.yaml），API 从房间名 <appId>:<channel> 反推项目并验签。

生产硬要求（不满足别上线）#

升级步骤#

1. 先升级 API（向后兼容一个版本），观察 readyz 与错误率；
2. 再升级 egress worker：排空（停止接新任务）→ 等在跑的任务结束 → 替换；
3. 最后升级 LiveKit / Egress（媒体面版本变更会影响推流与录制编码）；
4. 升级后在文档示例目录运行 node examples/run-all.mjs --all 做回归验证。

备份与恢复#

常见部署问题#