# deploy-test — 测试服务器部署脚本集 > **适用场景**：部署在**有公网 IP 的测试服务器**上。所有服务（后端、前端、Docker 基础设施、LiveKit）均在本机运行。 > > 如果你在本机 Mac 开发，请使用 `deploy-local/` 目录。 --- ## 两套环境对比 | 项目 | deploy-test（本目录）| deploy-local/ | |------|---------------------|----------------| | 适用机器 | 测试服务器（有公网 IP） | 本机 Mac（无公网 IP） | | 配置文件 | `.env.deploy-test` | `.env.deploy-local` | | 运行时目录 | `.deploy-test/` | `.deploy-local/` | | LiveKit | 本机 Docker 启动，使用公网 IP | 指向本目录服务器的 LiveKit | | Redis/Kafka/Etcd | 本机 Docker | 本机 Docker | | 后端服务 | 本机进程 | 本机进程 | | 前端服务 | 本机进程（可选） | 本机进程 | --- ## 目录结构 ``` deploy-test/ ├── common.sh # 公共函数库（路径、日志函数） ├── 01-init-env.sh # 步骤1：生成 .env.deploy-test 配置模板 ├── 02-patch-config.sh # 步骤2：将 .env.deploy-test 写入各服务 YAML ├── 03-start-infra.sh # 步骤3：启动 Docker 容器（Redis/Kafka/Etcd/LiveKit） ├── 04-build.sh # 步骤4：编译所有后端 Go 服务 ├── 05-start.sh # 步骤5：启动所有后端服务 ├── 06-install-frontend.sh # 步骤6：安装前端依赖（可选） ├── 07-start-frontend.sh # 步骤7：启动前端开发服务器（可选） ├── stop.sh # 停止后端服务 ├── stop-infra.sh # 停止 Docker 容器（含 LiveKit） ├── stop-frontend.sh # 停止前端服务 ├── remove-infra.sh # 删除 Docker 容器及数据（危险！） ├── restart.sh # 重启指定服务（支持 --build） ├── status.sh # 查看所有服务状态 ├── logs.sh # 查看日志（统一入口） ├── check-conn.sh # 验证 MongoDB / S3 连接 └── setup.sh # 一键完整部署（首次使用） ``` 运行时目录（`.deploy-test/`，已加入 `.gitignore`）： ``` .deploy-test/ ├── bin/ # Go 编译产物 ├── pids/ # PID 文件 ├── logs/ # 后端/前端服务日志 ├── docker-data/ # Docker 数据卷 ├── docker-logs/ # Docker 容器日志（按日期滚动） └── script-logs/ # 脚本执行日志（带时间戳） ``` --- ## 快速开始 ### 首次使用 ```bash # 一键执行（推荐） ./deploy-test/setup.sh ``` ### 分步执行 ```bash # 1. 生成配置模板 ./deploy-test/01-init-env.sh # 2. 修改配置（重要：确认 DEPLOY_TEST_IP 等信息正确） vim .env.deploy-test # 3. 将配置写入各服务 YAML（包括 livekit/livekit.yaml） ./deploy-test/02-patch-config.sh # 4. 启动 Docker 基础设施（Redis / Kafka / Etcd / LiveKit） ./deploy-test/03-start-infra.sh # 5. 编译后端服务 ./deploy-test/04-build.sh # 6. 启动后端服务 ./deploy-test/05-start.sh # 7. 安装前端依赖（可选） ./deploy-test/06-install-frontend.sh # 8. 启动前端开发服务器（可选） ./deploy-test/07-start-frontend.sh ``` --- ## 配置文件（`.env.deploy-test`） ```bash # ══ 测试服务器公网 IP ═══════════════════════════════════════════ DEPLOY_TEST_IP=54.116.29.247 # 本机公网 IP（LiveKit WebRTC 必需） # ══ MongoDB ════════════════════════════════════════════════════ MONGO_HOST=47.237.103.4 MONGO_PORT=27017 MONGO_USERNAME=minio_pC5wMB MONGO_PASSWORD=rI57PJsJhnz_qlRkfnTa0RPT MONGO_AUTHSOURCE=openim_v3 MONGO_DATABASE=openim_v3 BUILD_MONGO_DATABASE=build # ══ Amazon S3 ══════════════════════════════════════════════════ OPENIM_AWS_REGION=ap-southeast-1 OPENIM_AWS_BUCKET=im1688 OPENIM_AWS_ACCESS_KEY_ID=xxx OPENIM_AWS_SECRET_ACCESS_KEY=xxx BUILD_AWS_REGION=ap-east-1 BUILD_AWS_BUCKET=im-hk-apk BUILD_AWS_ACCESS_KEY=xxx BUILD_AWS_SECRET_KEY=xxx # ══ Docker Redis / Kafka / Etcd ════════════════════════════════ REDIS_PORT=6379 REDIS_PASSWORD=openIM123 KAFKA_PORT=9092 ETCD_PORT=2379 # ══ LiveKit（本机 Docker，使用公网 IP）════════════════════════ LIVEKIT_NODE_IP=54.116.29.247 # 与 DEPLOY_TEST_IP 保持一致 LIVEKIT_URL=ws://127.0.0.1:7880 LIVEKIT_API_KEY=API8462dba2 LIVEKIT_API_SECRET=xxx # ══ Cloudflare Stream / 腾讯云 RTC ════════════════════════════ CF_ACCOUNT_ID= CF_API_TOKEN= TENCENT_SDK_APP_ID=xxx TENCENT_SDK_SECRET_KEY=xxx ``` --- ## 服务地址 ### 后端服务 | 服务 | 端口 | |------|------| | openim-server | :10002 (HTTP) / :10001 (WS) | | chat-api | :10008 | | admin-api | :10009 | | meetingmsg | :8000 (WS) | | livecloud | :8080 | | livestream | :8081 | | build-server | :8281 | ### 前端开发服务器（可选） | 项目 | 端口 | 说明 | |------|------|------| | pc (Electron) | :7777 | Electron 桌面客户端 | | meetingh5 | :5188 | 直播观看 H5（弹幕+视频） | | h5 | :3003 | 移动端 H5 | | cms | :8001 | 后台管理 | | build-cms | :8002 | 构建管理后台 | | build-down | :8003 | 下载页 | > **meetingh5 访问方式** > > `02-patch-config.sh` 会自动生成 `meetingh5/.env.local`，设置默认后端地址： > > ``` > # 直接访问（使用 .env.local 中的默认后端） > http://:5188 > > # 或显式传入 URL 参数（优先级最高） > http://:5188?ws=ws://:8000&liveApi=http://:8081 > ``` > > - `ws` → meetingmsg 弹幕 WebSocket `:8000` > - `liveApi` → livestream 直播间 API `:8081` ### Docker 基础设施 | 服务 | 端口 | |------|------| | Redis | :6379 | | Kafka | :9092 | | Etcd | :2379 | | LiveKit | :7880 (API) / :7882 (TCP) / :50000-51000/udp (WebRTC) | --- ## LiveKit 说明 本测试服务器运行本地 LiveKit 容器，WebRTC 媒体流通过公网 IP 对外暴露。 ``` 测试服务器（DEPLOY_TEST_IP: 54.116.29.247） │ ├── dev-redis :6379 ←── dev-livekit 通过 host.docker.internal 访问 └── dev-livekit :7880 → HTTP API（后端连接） :7882/tcp+udp → WebRTC fallback :50000-51000/udp → WebRTC 媒体流（客户端直连公网 IP） ``` **防火墙必须开放**：7880/tcp、7882/tcp+udp、50000-51000/udp 本机 Mac（deploy-local）的 LiveKit 连接地址为 `ws://54.116.29.247:7880`，与此保持一致。 --- ## 日志体系 ``` .deploy-test/ ├── script-logs/ ← 每次脚本执行的完整输出（带时间戳，自动去除颜色码） ├── logs/ ← 后端/前端服务进程 stdout+stderr └── docker-logs/ ← Docker 容器日志（每日一文件） ├── redis/ ├── kafka/ ├── etcd/ └── livekit/ ``` ```bash # 查看所有日志概览 ./deploy-test/logs.sh # 实时跟踪某个服务 ./deploy-test/logs.sh openim-server ./deploy-test/logs.sh livekit ./deploy-test/logs.sh cms # 查看脚本执行历史 ./deploy-test/logs.sh scripts ./deploy-test/logs.sh scripts --last # 最新一次完整输出 ``` --- ## 日常操作 ```bash # 早上开机 ./deploy-test/03-start-infra.sh # Docker 容器（含 LiveKit） ./deploy-test/05-start.sh # 后端服务 # 查看状态 ./deploy-test/status.sh # 重启单个后端服务 ./deploy-test/restart.sh chat-api ./deploy-test/restart.sh chat-api --build # 重编译 + 重启 # 下班关机 ./deploy-test/stop.sh # 后端进程 ./deploy-test/stop-infra.sh # Docker 容器（含 LiveKit，数据保留） ``` --- ## 故障排查 ```bash # 验证 MongoDB / S3 连接 ./deploy-test/check-conn.sh # 查看 LiveKit 日志（WebRTC 不通时） ./deploy-test/logs.sh livekit --last # 重置 Docker 环境（删除所有数据） ./deploy-test/remove-infra.sh ./deploy-test/02-patch-config.sh ./deploy-test/03-start-infra.sh ```