133 lines
2.4 KiB
Markdown
133 lines
2.4 KiB
Markdown
|
# 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人同时连麦
|