企业官网建设流程全解析

IsaacLab 远程可视化白屏排查指南：3 层定位 Livestream 断点

【免费下载链接】IsaacLabUnified framework for robot learning with multi-physics/renderer support项目地址: https://gitcode.com/GitHub_Trending/is/IsaacLab

在云 GPU 服务器上跑 IsaacLab headless 仿真，想在自己电脑上看到实时画面，就得依赖远程可视化：仿真侧把 GPU 渲染结果编码成视频流，本地端收流并回放画面。headless 指无本地窗口运行，--livestream参数则负责开启这条视频通路。连接失败时，断点几乎只藏在三个地方：端口没放行、启动参数没配对、客户端接错了地址。先按下面的快速诊断表定位现象，再从网络层、服务器端、客户端三层逐一定位断点。

现象诊断：先认表，再动手

把终端报错和画面表现对号入座，能砍掉一半排查时间：

网络层：端口放行与占用检查

先确认信令端口和媒体端口都已放行，再谈后面一切。--livestream开启后，IsaacLab 固定使用 TCP 49100 做 WebRTC 信令、47998 做流媒体传输，媒体走 UDP；而云主机安全组和系统防火墙对 UDP 默认就是丢弃，这正是"连得上、看不到画面"的高频根因。在服务器上用下面命令确认 49100 处于 LISTEN 状态：

ss -tlnp | grep 49100

如果上一条流会话没退干净，端口仍被占着，新会话就会直接报NVST_R_BUSY。先 SIGTERM、无效再强杀：

kill $(lsof -ti tcp:49100) kill -9 $(lsof -ti tcp:49100)

📌 媒体端口的完整端口段清单请以官方文档为准，放行时把 UDP 一并加上。

服务器端：livestream 参数组合与启动命令

--livestream的合法取值只有 0、1、2：0 表示不开流，1 面向公网，2 面向局域网、私网。关键点在于——取值只要 ≥1，AppLauncher会自动进入 headless，所以命令里不必再写--headless，写了也不会冲突。局域网场景的完整启动命令：

./isaaclab.sh -p scripts/reinforcement_learning/train.py \ --task Isaac-Cartpole-v0 --num_envs 1 \ --livestream 2 --width 1280 --height 720

命令行参数会覆盖LIVESTREAM环境变量（代码里显式处理了这个优先级），所以别两边各写一个值。同一时间只能启用一个流扩展，重复传参会直接抛错。带宽紧张时把--width/--height调低，码率随之下降；公网部署则额外设置PUBLIC_IP=<你的公网IP>，因为公网模式会把该地址写进信令配置供客户端寻址。Docker 里跑容器时，由于 WebRTC 端口需要直出宿主机，必须用--network=host模式启动容器。

客户端：WebRTC 浏览器与 Streaming Client 两条路线

--livestream 1/2都是 WebRTC 流：在浏览器地址栏直接输入http://<服务器IP>（完整入口地址以官方文档为准），看到播放按钮即说明信令已通，此时没画面就是媒体端口的问题。另一条路线是 Omniverse Streaming Client：在 Omniverse 客户端目录安装 Streaming Client，地址栏同样填服务器 IP，等服务器日志打印出开始仿真的信息后再点连接。✅ 连上后若只有卡顿没有白屏，说明链路已通，剩下的是带宽问题，按上面调分辨率即可。

底层机制：一句话讲清

headless 只关窗口不关渲染：GPU 照常在服务器上做光追渲染，WebRTC 信令端口 49100 负责握手建连，媒体端口 47998 负责推编码后的视频帧。所以信令不通 = 连接失败，媒体不通 = 连上却白屏，UDP 恰好是最容易被默认丢弃的那一层。

下一步动作清单

• 完整端口段清单与客户端下载地址，查阅官方文档：troubleshooting 之 Livestreaming 与 WebRTC 一节
• 参数优先级、环境变量与--help的完整行为，见 launch_app 教程
• 每次切换流模式前先杀掉旧流进程，避免NVST_R_BUSY
• 带宽不够时先降--width/--height，再怀疑其他环节

【免费下载链接】IsaacLabUnified framework for robot learning with multi-physics/renderer support项目地址: https://gitcode.com/GitHub_Trending/is/IsaacLab