From 39b21de4c613775b84162f2fbd7fe0eb111f5bab Mon Sep 17 00:00:00 2001
From: KIMI <kimi@multica.local>
Date: Sat, 8 Aug 2026 22:36:06 +0800
Subject: [PATCH] =?UTF-8?q?selftest=20=E6=94=AF=E6=8C=81=E8=87=AA=E5=AE=9A?=
 =?UTF-8?q?=E4=B9=89=20LIVEKIT=5FPORT;=20README=20=E8=A1=A5=E5=85=85=20788?=
 =?UTF-8?q?0=20=E7=AB=AF=E5=8F=A3=E5=86=B2=E7=AA=81=E5=A4=84=E7=90=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md           | 3 ++-
 scripts/selftest.sh | 5 +++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 7f00050..4eb5f3e 100644
--- a/README.md
+++ b/README.md
@@ -77,7 +77,7 @@ docker compose up -d           # 再启动
 
 - OpenIM API: `http://<服务器IP>:10002`
 - OpenIM WebSocket: `ws://<服务器IP>:10001`
-- LiveKit: `ws://<服务器IP>:7880`，API Key/Secret 见 `.env` 的 `LIVEKIT_API_KEY` / `LIVEKIT_API_SECRET`
+- LiveKit: `ws://<服务器IP>:7880`（7880 为默认信令端口，可用 `.env` 的 `LIVEKIT_PORT` 改），API Key/Secret 见 `.env` 的 `LIVEKIT_API_KEY` / `LIVEKIT_API_SECRET`
 - 测试账号：`test001` / `test002`（由自测脚本注册）；语音通话时两名用户以各自 identity 进同一房间即可
 
 ## 常见问题
@@ -85,4 +85,5 @@ 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`）。
 - **语音通话连不上**：确认服务器 UDP 7882 放行（内网防火墙/安全组）；UDP 不通时会走 TCP 7881 兜底。
diff --git a/scripts/selftest.sh b/scripts/selftest.sh
index c36bed6..d309aaa 100755
--- a/scripts/selftest.sh
+++ b/scripts/selftest.sh
@@ -18,8 +18,9 @@ MINIO_SK="$(env_get MINIO_SECRET_ACCESS_KEY)"; MINIO_SK="${MINIO_SK:-openIM123}"
 MINIO_PORT="$(env_get MINIO_PORT)"; MINIO_PORT="${MINIO_PORT:-10005}"
 LK_KEY="$(env_get LIVEKIT_API_KEY)"
 LK_SECRET="$(env_get LIVEKIT_API_SECRET)"
-LK_HTTP="http://${IP}:7880"
-LK_WS="ws://${IP}:7880"
+LK_PORT="$(env_get LIVEKIT_PORT)"; LK_PORT="${LK_PORT:-7880}"
+LK_HTTP="http://${IP}:${LK_PORT}"
+LK_WS="ws://${IP}:${LK_PORT}"
 LK_CLI_IMAGE="livekit/livekit-cli:v2.18.2"
 MC_IMAGE="minio/mc:latest"