11# Watch Room Server
22
3- 独立的观影室服务器,为部署在 Vercel 的 MoonTVPlus 提供实时同步观影功能。
4-
5- > ** ⚠️ 重要提示:** 如果遇到 Docker 构建失败(` npm ci ` 错误),请查看 [ 快速修复指南] ( HOTFIX.md ) 。
3+ 独立的观影室服务器,为部署在 Vercel 的 MoonTVPlus(https://github.com/mtvpls/MoonTVPlus ) 提供实时同步观影功能。
64
75## 功能特性
86
@@ -122,18 +120,18 @@ docker run -d \
1221201 . 在 [ Railway] ( https://railway.app ) 创建新项目
1231212 . 连接 GitHub 仓库或上传代码
1241223 . 设置环境变量:
125- - ` AUTH_KEY ` : 你的认证密钥
126- - ` ALLOWED_ORIGINS ` : 你的前端域名
127- - ` PORT ` : 3001(Railway 会自动分配)
123+ - ` AUTH_KEY ` : 你的认证密钥
124+ - ` ALLOWED_ORIGINS ` : 你的前端域名
125+ - ` PORT ` : 3001(Railway 会自动分配)
1281264 . Railway 会自动检测并部署
129127
130128### Render 部署
131129
1321301 . 在 [ Render] ( https://render.com ) 创建新的 Web Service
1331312 . 连接 GitHub 仓库
1341323 . 配置:
135- - Build Command: ` npm install && npm run build `
136- - Start Command: ` npm start `
133+ - Build Command: ` npm install && npm run build `
134+ - Start Command: ` npm start `
1371354 . 设置环境变量(同上)
1381365 . 部署
139137
@@ -237,6 +235,7 @@ server {
237235健康检查端点
238236
239237响应:
238+
240239``` json
241240{
242241 "status" : " ok" ,
@@ -250,11 +249,13 @@ server {
250249服务器统计信息(需要认证)
251250
252251请求头:
252+
253253```
254254Authorization: Bearer YOUR_AUTH_KEY
255255```
256256
257257响应:
258+
258259``` json
259260{
260261 "totalRooms" : 5 ,
@@ -277,15 +278,15 @@ Authorization: Bearer YOUR_AUTH_KEY
277278Socket.IO 连接端点,需要在连接时提供认证:
278279
279280``` javascript
280- import { io } from ' socket.io-client' ;
281+ import {io } from ' socket.io-client' ;
281282
282283const socket = io (' https://your-server.com' , {
283- auth: {
284- token: ' YOUR_AUTH_KEY'
285- },
286- extraHeaders: {
287- Authorization: ' Bearer YOUR_AUTH_KEY'
288- }
284+ auth: {
285+ token: ' YOUR_AUTH_KEY'
286+ },
287+ extraHeaders: {
288+ Authorization: ' Bearer YOUR_AUTH_KEY'
289+ }
289290});
290291```
291292
@@ -313,23 +314,27 @@ WATCH_ROOM_EXTERNAL_SERVER_AUTH=your-secret-auth-key
313314### 查看日志
314315
315316Docker Compose:
317+
316318``` bash
317319docker-compose logs -f
318320```
319321
320322PM2:
323+
321324``` bash
322325pm2 logs watch-room-server
323326```
324327
325328### 重启服务
326329
327330Docker Compose:
331+
328332``` bash
329333docker-compose restart
330334```
331335
332336PM2:
337+
333338``` bash
334339pm2 restart watch-room-server
335340```
@@ -341,6 +346,7 @@ pm2 restart watch-room-server
3413463 . 重启服务
342347
343348Docker Compose:
349+
344350``` bash
345351git pull
346352docker-compose down
@@ -349,6 +355,7 @@ docker-compose up -d
349355```
350356
351357PM2:
358+
352359``` bash
353360git pull
354361npm install
@@ -371,7 +378,6 @@ pm2 restart watch-room-server
371378
372379## 故障排查
373380
374- 遇到问题?查看详细的 [ 故障排查指南] ( TROUBLESHOOTING.md ) 。
375381
376382常见问题:
377383
@@ -390,7 +396,7 @@ pm2 restart watch-room-server
390396
391397- 房主离线 5 分钟后房间会自动删除
392398- 房主离线 30 秒后会清除播放状态
393- - 这是正常的清理机制
399+ - 这是正常清理机制
394400
395401## 安全建议
396402
0 commit comments