LiveKit 部署实战从最小可用配置到生产环境避坑【免费下载链接】livekitEnd-to-end realtime stack for connecting humans and AI项目地址: https://gitcode.com/GitHub_Trending/li/livekit给自己的产品接实时通话绕不开信令与媒体转发这一层最快的路是在一台机器上跑起 LiveKit server——开源免费的 WebRTC SFU负责房间管理、媒体转发与 JWT 鉴权。这份笔记覆盖本地最小可用部署的 4 步、4 个最易配错的配置项以及上线前必须切换的内容。先跑起来4 步跑通最小可用部署装二进制Linux 可执行仓库内的 install-livekit.shmacOS 用brew install livekit不想装现成版也可以从源码构建——需要 Go 1.23git clone仓库后依次执行./bootstrap.sh和mage或直接用仓库里的 Dockerfile 构建镜像。✅ 验证livekit-server --version能打印版本号。开发模式启动livekit-server --dev。该标志会启用占位密钥devkey/secret并只绑定127.0.0.1本地测试很安全。✅ 验证日志出现starting in development mode随后看到:7880的监听地址。生成 access token任何客户端入房都需要服务端签发的 JWT用 livekit-cli 执行lk token create --api-key devkey --api-secret secret --join --room my-first-room --identity user1 --valid-for 24h✅ 验证命令输出一串 JWT。让测试用户入房lk room join --url ws://localhost:7880 --api-key devkey --api-secret secret --identity bot-user1 --publish-demo my-first-room会向房间发一路循环测试视频。✅ 验证日志显示参与者加入并有 track 发布记录。本地环境不用碰防火墙7880 是信令口50000–60000是媒体 UDP 口只有暴露到外网时才需要处理。绕不开的 4 项关键配置仓库根目录的 config-sample.yaml 是全量配置样例新手真正要盯的只有下面 4 项keysAPI key/secret 对为什么重要它是签发 access token 和服务端 API 调用的唯一凭据。生产环境继续用devkey/secret等同于裸奔。 推荐值用livekit-server generate-keys生成一对真实密钥secret 只留服务端可用环境变量LIVEKIT_KEYS注入绝不能下发到前端。port: 7880与rtc.port_range_start/end为什么重要7880 是信令/WS 入口50000–60000是客户端媒体流量走的 UDP 段。这段 UDP 没在防火墙/安全组放行是最典型的部署了但画面出不来的原因。 推荐值云主机上把整个 UDP 段开入站若前面挂了四层负载均衡可改用udp_port: 7882-7892的 UDP mux 模式只暴露少量端口。redis.address为什么重要配置了 RedisLiveKit 会自动进入完全分布式模式客户端连到任意节点都会被路由到同一房间不配则是纯单机。 推荐值开发留空多节点部署时所有节点必须指向同一个 Redis否则房间会分裂。turn内置 TURN 中继为什么重要部分企业网、运营商 NAT 会封 UDP没有中继这类客户端直接连不进来。 推荐值enabled: true配好 TLS 证书与domaintls_port生产建议用443。开发环境 vs 生产环境该切换什么项--dev模式生产必须做密钥占位devkey/secretgenerate-keys生成真实密钥绑定地址仅127.0.0.17880 放负载均衡后面TLS 终结媒体端口本地随意放行 UDP 段或改udp_portmux 开 TURN 兜底监控无打开prometheus_port: 6789接入 Grafana仓库deploy/grafana/自带看板日志debug 级level: info开json: true便于采集不同规模怎么选机器并发规模CPU / 内存带宽上行≤ 1004 核 / 8 GB50 Mbps 起100–10008 核 / 16 GB 单机200 Mbps–1 Gbps1000每节点 8 核 / 16 GB 多节点 共享 Redis10 Gbps按区域做多节点接入单机吞吐有个粗略标尺配置里limit.num_tracks默认约 400 tracks/CPU按每人音视频各占 2 条 track 估算单核大约撑得住 200 个全媒体用户据此向上取整核数即可。下一步读官方文档的 Deploy to a VM 章节把单机方案落地deploy/README.md 里有 VM 与 Kubernetes 两条部署路线再用 livekit-cli 压一轮测试流量确认容量余量。【免费下载链接】livekitEnd-to-end realtime stack for connecting humans and AI项目地址: https://gitcode.com/GitHub_Trending/li/livekit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考