livekit 三个宿主端口全部可配置(带默认值); LIVEKIT_API_SECRET 默认加长到 42 字符; README 同步

This commit is contained in:
KIMI
2026-08-08 23:30:03 +08:00
parent 6dd1d4a245
commit efd8becd3b
3 changed files with 15 additions and 9 deletions
+5 -4
View File
@@ -31,9 +31,9 @@
| 10001 | TCP/WS | OpenIM 消息网关(客户端长连接) |
| 10002 | TCP/HTTP | OpenIM REST API |
| 10005 | TCP/HTTP | MinIO(图片/语音/文件下载) |
| 7880 | TCP/WS | LiveKit 信令 |
| 7882 | UDP | LiveKit 语音媒体 |
| 7881 | TCP | LiveKit 媒体备用通道(UDP 不通时 |
| 7880 | TCP/WS | LiveKit 信令`.env``LIVEKIT_PORT` 可改) |
| 7882 | UDP | LiveKit 语音媒体`LIVEKIT_RTC_UDP_PORT` 可改) |
| 7881 | TCP | LiveKit 媒体备用通道(`LIVEKIT_RTC_TCP_PORT` 可改 |
| 10004 | TCP/HTTP | MinIO 控制台(运维用,可不开放) |
| 12379/12380 | TCP | Etcd(仅容器间用,建议不对外) |
@@ -85,5 +85,6 @@ docker compose up -d # 再启动
- **文件/语音能发但打不开**`MINIO_EXTERNAL_ADDRESS` 没写成客户端能访问的 IP。改 `.env``docker compose up -d` 重建 openim-server。
- **启动报缺 `ETCD_USERNAME` / `KAFKA_USERNAME` 等警告**:未启用对应组件认证,官方说明可忽略。
- **openim-server 一直 unhealthy**`docker exec -it openim-server mage check` 看哪项依赖没通;首次启动需等 30-60 秒。
- **livekit 启动报 `bind ... 7880: address already in use`**:服务器上 7880 被别的程序占了。先 `ss -tlnp | grep 7880` 看是谁;若不能停掉对方,就改 `.env``LIVEKIT_PORT=17880``docker compose up -d`之后客户端和自测脚本都用新端口(自测脚本会自动读 `.env`)。
- **livekit 启动报 `bind ... 7880/7881: address already in use`**:服务器上这些端口被别的程序占了`ss -tlnp | grep 788` 查占用者)。不要动别人的服务,把 `.env``LIVEKIT_PORT` / `LIVEKIT_RTC_TCP_PORT` / `LIVEKIT_RTC_UDP_PORT` 改成空闲端口(如 17880/17881/17882),再 `docker compose up -d --force-recreate livekit`之后客户端和自测脚本都用新端口(自测脚本会自动读 `.env`)。
- **livekit 日志报 `secret is too short`**`LIVEKIT_API_SECRET` 必须 ≥32 字符,换个长密钥后重建 livekit 容器。
- **语音通话连不上**:确认服务器 UDP 7882 放行(内网防火墙/安全组);UDP 不通时会走 TCP 7881 兜底。