# LiveKit 语音聊天室服务部署文档

## 服务信息

| 项目 | 值 |
|------|-----|
| 服务器IP | 1.15.149.240 |
| HTTP端口 | 7880 |
| TCP端口 | 7881 |
| UDP端口范围 | 50000-50100 |
| API Key | APIKey123456 |
| API Secret | YourSecretKey123456789012345678901234567890 |
| WebSocket地址 | wss://1.15.149.240:7880 |

---

## 一、安装步骤

### 1. 安装Docker（如果没有）
```bash
curl -fsSL https://get.docker.com | sh
```

### 2. 创建配置目录
```bash
mkdir -p /opt/livekit
cd /opt/livekit
```

### 3. 创建配置文件
```bash
cat > /opt/livekit/livekit.yaml << 'EOF'
port: 7880
rtc:
  port_range_start: 50000
  port_range_end: 50100
  use_external_ip: true
keys:
  APIKey123456: YourSecretKey123456789012345678901234567890
logging:
  level: info
EOF
```

### 4. 启动LiveKit服务器（使用host网络模式）
```bash
docker run -d \
  --name livekit \
  --restart always \
  --network host \
  -v /opt/livekit/livekit.yaml:/livekit.yaml \
  livekit/livekit-server \
  --config /livekit.yaml
```

### 5. 检查是否启动成功
```bash
docker ps | grep livekit
docker logs livekit
```

---

## 二、防火墙/安全组配置

需要开放以下端口：

| 协议 | 端口 | 用途 |
|------|------|------|
| TCP | 7880 | HTTP API / WebSocket |
| TCP | 7881 | WebRTC TCP |
| UDP | 50000-50100 | WebRTC 媒体传输 |

---

## 三、常用命令

```bash
# 查看服务状态
docker ps | grep livekit

# 查看日志
docker logs livekit
docker logs -f livekit  # 实时查看

# 重启服务
docker restart livekit

# 停止服务
docker stop livekit

# 删除服务
docker rm -f livekit

# 更新服务
docker pull livekit/livekit-server
docker rm -f livekit
# 然后重新执行启动命令
```

---

## 四、验证服务

```bash
# 本地测试
curl http://localhost:7880

# 外网测试
curl http://1.15.149.240:7880
# 返回 "OK" 表示服务正常
```

---

## 五、后续开发

### 后端需要实现
- Token生成接口：`/api/voice-room/join-token`

### Android客户端需要
- 添加依赖：`io.livekit:livekit-android:2.0.0`
- 实现语音房间Activity
- 麦位UI界面

---

## 六、注意事项

1. **生产环境请修改API密钥**：当前使用的是示例密钥，正式上线前请更换
2. **建议配置HTTPS**：可以用Nginx反向代理添加SSL证书
3. **UDP端口范围**：当前配置100个端口，支持约50人同时连麦