livekit/ingress

LiveKit Ingress Docker镜像文档

镜像概述

LiveKit Ingress是LiveKit实时音视频平台的核心组件之一，专注于媒体流接入功能。该镜像提供了将外部媒体流（如RTMP推流、SRT流、WebRTC输入等）接入LiveKit房间的能力，实现外部内容与LiveKit实时音视频系统的无缝集成，适用于直播、在线会议、媒体桥接等场景。

核心功能与特性

协议支持

• 兼容主流媒体传输协议：RTMP、SRT、WebRTC、HLS（拉流模式）
• 支持RTP/RTSP协议接入（需配置转码参数）

性能与可靠性

• 低延迟传输（端到端延迟<500ms）
• 自适应码率调整，适配网络波动
• 高可用性设计，支持水平扩展

集成能力

• 与LiveKit房间服务无缝对接，接入流可直接进入指定房间
• 支持流状态监控（通过LiveKit API获取流状态、统计信息）
• 动态配置接入参数（分辨率、帧率、比特率等）

便捷管理

• 支持通过LiveKit API创建/更新/删除 ingress 任务
• 详细日志输出，支持多级别日志（DEBUG/INFO/WARN/ERROR）
• 容器化部署，配置简单，易于集成到现有系统

使用场景

1. 直播推流接入：将RTMP直播流推送到LiveKit房间，实现直播内容与实时互动的结合
2. 会议外部视频接入：将外部摄像头、IP摄像机（RTSP流）接入在线会议房间
3. 媒体服务器桥接：作为媒体网关，连接传统媒体服务器（如SRS、Wowza）与LiveKit实时系统
4. 多平台内容聚合：聚合来自不同来源的媒体流（如社交媒体直播、本地文件播放）到统一的LiveKit房间

使用方法

前置条件

• 已部署LiveKit服务（包含LiveKit Server和Redis）
• 拥有LiveKit服务的API密钥（API Key）和密钥（API Secret）
• 开放容器所需端口（如RTMP默认1935端口、SRT默认9999端口等）

环境变量配置

Docker Run 部署示例

bash
docker run -d \
  --name livekit-ingress \
  -p 1935:1935 \  # RTMP端口
  -p 9999:9999/udp \  # SRT端口（UDP）
  -p 8080:8080 \  # 管理API端口
  -e LIVEKIT_URL="wss://your-livekit-server:7880" \
  -e LIVEKIT_API_KEY="your-api-key" \
  -e LIVEKIT_API_SECRET="your-api-secret" \
  -e LOG_LEVEL="info" \
  livekit/ingress:latest

Docker Compose 部署示例

yaml
version: '3.8'

services:
  livekit-ingress:
    image: livekit/ingress:latest
    container_name: livekit-ingress
    ports:
      - "1935:1935"    # RTMP
      - "9999:9999/udp" # SRT
      - "8080:8080"    # 管理API
    environment:
      - LIVEKIT_URL=wss://your-livekit-server:7880
      - LIVEKIT_API_KEY=your-api-key
      - LIVEKIT_API_SECRET=your-api-secret
      - LOG_LEVEL=info
    restart: unless-stopped
    depends_on:
      - livekit-server  # 若LiveKit Server也在Compose中，需添加依赖

  # （可选）LiveKit Server示例配置，实际部署时需根据官方文档调整
  livekit-server:
    image: livekit/server:latest
    ports:
      - "7880:7880"  # WebSocket API
      - "7881:7881"  # HTTPS
    environment:
      - LIVEKIT_API_KEY=your-api-key
      - LIVEKIT_API_SECRET=your-api-secret
      - REDIS_URL=redis://redis:6379
    depends_on:
      - redis

  redis:
    image: redis:alpine
    ports:
      - "6379:6379"

验证与监控

1. 健康检查：通过访问 http://容器IP:8080/health 检查服务状态，返回 {"status":"ok"} 表示正常运行。
2. 流状态查询：使用LiveKit Server API（如GET /ingresses/{ingress_id}）获取接入流的详细状态（如比特率、帧率、连接时长等）。
3. 日志查看：通过 docker logs livekit-ingress 查看实时日志，排查接入异常。

注意事项

• 生产环境建议配置SSL/TLS加密（通过反向代理如Nginx实现），尤其是公网暴露的RTMP/SRT端口。
• 高并发场景下，可通过水平扩展多个ingress实例，并配合负载均衡器（如HAProxy）分发流量。
• 接入流的分辨率、帧率需与LiveKit房间的媒体配置匹配，避免转码性能瓶颈。