独立的观影室服务器，为部署在 Vercel 的 MoonTVPlus 提供实时同步观影功能。
- 🎬 多人同步观影（播放/暂停/跳转同步）
- 💬 实时聊天系统
- 🎙️ 语音通话（WebRTC）
- 🏠 房间管理（创建/加入/离开）
- 🔐 密码保护和权限控制
- 🔄 自动重连和心跳检测
- 📊 服务器统计信息
- 🐳 Docker 支持
- Node.js 18+
- TypeScript
- Express
- Socket.IO
- Docker
最简单的部署方式，使用 Docker Hub 镜像：
docker run -d \
--name watch-room-server \
--restart unless-stopped \
-p 3001:3001 \
-e AUTH_KEY=your-secret-key \
-e ALLOWED_ORIGINS=https://your-domain.com \
-e NODE_ENV=production \
cyc233/watch-room-server:latestDocker Hub: https://hub.docker.com/r/cyc233/watch-room-server
详细的 Docker 部署选项请查看 Docker 部署 章节。
部署服务器后，需要在 MoonTVPlus 中配置连接信息。
在 Vercel 项目设置中添加以下环境变量：
WATCH_ROOM_ENABLED=true
WATCH_ROOM_SERVER_TYPE=external
WATCH_ROOM_EXTERNAL_SERVER_URL=https://your-watch-room-server.com
WATCH_ROOM_EXTERNAL_SERVER_AUTH=your-secret-auth-key重要提示：
WATCH_ROOM_EXTERNAL_SERVER_AUTH必须与观影室服务器的AUTH_KEY完全一致- 设置后需要重新部署 Vercel 项目
npm install复制 .env.example 为 .env 并修改配置：
cp .env.example .env编辑 .env 文件：
# 服务器端口
PORT=3001
# 认证密钥（必需）- 请修改为强密码
AUTH_KEY=your-secret-auth-key-change-this
# 允许的跨域来源（逗号分隔）
ALLOWED_ORIGINS=https://your-domain.com,https://www.your-domain.com
# 运行环境
NODE_ENV=productionnpm run dev# 构建
npm run build
# 启动
npm start直接使用已发布的 Docker 镜像：
# 拉取镜像
docker pull cyc233/watch-room-server:latest
# 运行容器
docker run -d \
--name watch-room-server \
--restart unless-stopped \
-p 3001:3001 \
-e AUTH_KEY=your-secret-key \
-e ALLOWED_ORIGINS=https://your-domain.com \
-e NODE_ENV=production \
cyc233/watch-room-server:latest或使用 Docker Compose：
version: '3.8'
services:
watch-room-server:
image: cyc233/watch-room-server:latest
container_name: watch-room-server
restart: unless-stopped
ports:
- "3001:3001"
environment:
- AUTH_KEY=your-secret-key
- ALLOWED_ORIGINS=https://your-domain.com
- NODE_ENV=production保存为 docker-compose.yml，然后运行：
docker-compose up -dDocker Hub 地址: https://hub.docker.com/r/cyc233/watch-room-server
- 配置环境变量：
cp .env.example .env
# 编辑 .env 文件- 启动服务：
docker-compose up -d- 查看日志：
docker-compose logs -f- 停止服务：
docker-compose down# 构建镜像
docker build -t watch-room-server .
# 运行容器
docker run -d \
--name watch-room-server \
-p 3001:3001 \
-e AUTH_KEY=your-secret-key \
-e ALLOWED_ORIGINS=https://your-domain.com \
watch-room-server- 在 Railway 创建新项目
- 连接 GitHub 仓库或上传代码
- 设置环境变量：
AUTH_KEY: 你的认证密钥ALLOWED_ORIGINS: 你的前端域名PORT: 3001（Railway 会自动分配）
- Railway 会自动检测并部署
- 在 Render 创建新的 Web Service
- 连接 GitHub 仓库
- 配置：
- Build Command:
npm install && npm run build - Start Command:
npm start
- Build Command:
- 设置环境变量（同上）
- 部署
- 安装 Fly CLI：
curl -L https://fly.io/install.sh | sh- 登录：
fly auth login- 创建应用：
fly launch- 设置环境变量：
fly secrets set AUTH_KEY=your-secret-key
fly secrets set ALLOWED_ORIGINS=https://your-domain.com- 部署：
fly deploy- 安装 PM2：
npm install -g pm2- 构建项目：
npm install
npm run build- 使用 PM2 启动：
pm2 start dist/index.js --name watch-room-server- 设置开机自启：
pm2 startup
pm2 save- 查看日志：
pm2 logs watch-room-server如果使用 Nginx 作为反向代理，需要特别配置 WebSocket 支持：
server {
listen 80;
server_name your-domain.com;
location / {
proxy_pass http://localhost:3001;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# WebSocket 超时设置
proxy_read_timeout 86400;
proxy_send_timeout 86400;
}
}健康检查端点
响应：
{
"status": "ok",
"timestamp": "2024-01-01T00:00:00.000Z",
"uptime": 12345.67
}服务器统计信息（需要认证）
请求头：
Authorization: Bearer YOUR_AUTH_KEY
响应：
{
"totalRooms": 5,
"totalMembers": 12,
"rooms": [
{
"id": "ABC123",
"name": "我的观影室",
"memberCount": 3,
"isPublic": true,
"hasPassword": false,
"createdAt": 1234567890000
}
]
}Socket.IO 连接端点，需要在连接时提供认证：
import {io} from 'socket.io-client';
const socket = io('https://your-server.com', {
auth: {
token: 'YOUR_AUTH_KEY'
},
extraHeaders: {
Authorization: 'Bearer YOUR_AUTH_KEY'
}
});Docker Compose:
docker-compose logs -fPM2:
pm2 logs watch-room-serverDocker Compose:
docker-compose restartPM2:
pm2 restart watch-room-server- 拉取最新代码
- 重新构建
- 重启服务
Docker Compose:
git pull
docker-compose down
docker-compose build
docker-compose up -dPM2:
git pull
npm install
npm run build
pm2 restart watch-room-server- CPU: 1 核心以上
- 内存: 512MB 以上
- 带宽: 根据同时在线用户数调整
- 单实例可支持约 100-200 个并发房间
- 如需更高并发，可使用 Redis 适配器实现多实例负载均衡
常见问题：
- 检查防火墙是否开放端口
- 检查 ALLOWED_ORIGINS 配置
- 检查 AUTH_KEY 是否匹配
- 查看服务器日志
- 确认 Nginx 配置了 WebSocket 支持
- 检查 SSL 证书是否有效
- 确认没有中间代理阻止 WebSocket
- 房主离线 5 分钟后房间会自动删除
- 房主离线 30 秒后会清除播放状态
- 这是正常清理机制
- 使用强密码作为 AUTH_KEY
- 限制 ALLOWED_ORIGINS 为具体域名
- 使用 HTTPS/WSS 加密连接
- 定期更新依赖包
- 启用防火墙，只开放必要端口
- 使用 Nginx 等反向代理增加安全层
MIT
如有问题，请提交 Issue 或联系开发者。