Isaac Sim 5.1.0 部署指南（实验室服务器）

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}

Isaac Sim 5.1.0 部署指南（实验室服务器）

适用场景：实验室 Linux 服务器运行 Isaac Sim，Mac 本地通过 WebRTC 客户端远程查看画面

⚠️ 不适用于 AutoDL：AutoDL 不支持 UDP 端口，Isaac Sim WebRTC 必须用 UDP 47998 传输媒体流，结构性不可用。详见文末说明。

前置要求

硬件要求（官方文档 5.1.0）：

⚠️ VRAM < 16GB 的显卡（如 3070 Ti 8GB）可以运行基础场景，但复杂场景和多传感器场景可能显存不足。 ⚠️ A100、H100 没有 RT Core，不支持 Isaac Sim。 ⚠️ 驱动版本要求：Linux 最低 580.65.06

系统要求：

• Ubuntu 22.04 或 24.04（需 GLIBC 2.35+，可用 ldd –version 确认）
• Python 3.11
• 服务器防火墙开放：TCP 49100（WebRTC 信令）+ UDP 47998（WebRTC 媒体流）
• 网络可访问 pypi.nvidia.com（安装时需要）

第一步：创建缓存目录（可选，仅系统盘空间紧张时需要）

Isaac Sim 运行时会在 ~/.local/share/ov、~/.cache/ov、~/.cache/nvidia/GLCache 写入大量缓存（数 GB），若系统盘空间有限，建议通过软链接将其路由至数据盘。

# 缓存软链接
mkdir -p /你的文件夹/isaac_cache
# 建立软链接，将缓存路由至数据盘
rm -rf ~/.cache/ov ~/.local/share/ov ~/.cache/nvidia/GLCache
mkdir -p ~/.local/share ~/.cache/nvidia
ln -s /extra/xubinyao/isaac_cache ~/.cache/ov
ln -s /extra/xubinyao/isaac_cache ~/.local/share/ov
ln -s /extra/xubinyao/isaac_cache ~/.cache/nvidia/GLCache

# 虚拟环境直接建在数据盘（不需要软链接）
python3.11 -m venv /extra/xubinyao/isaac_env

第二步：创建 Python 虚拟环境

官方推荐使用 venv，conda 方式已在 5.1.0 中标注为 deprecated，将在后续版本移除。

python3.11 -m venv /extra/xubinyao/isaac_env
source /extra/xubinyao/isaac_env/bin/activate
pip install –upgrade pip

第三步：安装系统图形依赖与 Isaac Sim

# 安装无窗口模式所需的图形库（官方 pip 安装方式在 Linux 服务器上需要这些依赖）
sudo apt-get update
sudo apt-get install -y \\
libglu1-mesa libgl1-mesa-glx libxi6 libxrandr2 libxcursor1 libxinerama1 \\
libvulkan1 libxt6 zenity libegl1 libxext6 libxrender1

# 安装 Isaac Sim（耗时较长，请耐心等待）
pip install "isaacsim[all,extscache]==5.1.0" –extra-index-url https://pypi.nvidia.com

引号是必要的：部分 shell（如 zsh）会将 [] 解释为通配符，加引号可避免报错。

安装完成后可用 pip show isaacsim 确认安装路径。

第四步：启动 Isaac Sim（服务端）

# 激活虚拟环境
source /data/isaac_env/bin/activate

# 接受 NVIDIA EULA（避免无窗口模式卡在交互提示）
export OMNI_KIT_ACCEPT_EULA=YES

# 准备工程目录
mkdir -p /data/isaac_project
cd /data/isaac_project

# 启动 Isaac Sim Streaming 模式（将 <服务器公网IP> 替换为实际 IP）
isaacsim isaacsim.exp.full.streaming –no-window –allow-root \\
–/app/livestream/publicEndpointAddress=<服务器公网IP> \\
–/app/livestream/port=49100

等待终端出现以下字样（首次启动需编译 shader 缓存，约需 5～15 分钟）：

Isaac Sim Full Streaming App is loaded.

## 第五步：Mac 客户端连接

1. 打开 Mac 上的 **Isaac Sim WebRTC Streaming Client**
2. Server 填写**服务器公网 IP**
3. 点击 **Connect**

客户端下载地址：https://docs.isaacsim.omniverse.nvidia.com/5.1.0/installation/download.html#isaac-sim-latest-release

> ⚠️ 快捷键说明：在串流画面内用 `Ctrl+C` / `Ctrl+V` 复制粘贴；从 Mac 本地复制到串流内用 `⌘C` + `Ctrl+V`。

——

## 附：常用排查命令

```bash
# 确认 49100（TCP）和 47998（UDP）端口是否在监听
ss -tlunp | grep -E "49100|47998"

# 查看 Isaac Sim 进程是否在运行
ps aux | grep isaacsim | grep -v grep

# 查看最新 Isaac Sim 日志
ls -t /data/isaac_env/lib/python3.11/site-packages/isaacsim/kit/logs/Kit/"Isaac-Sim Python"/5.1/ | head -3

附：~/.ssh/config 参考配置（Mac 本地）

Host lab-server
HostName <服务器公网IP或域名>
User <用户名>
Port 22
IdentityFile ~/.ssh/id_rsa

附：为什么 AutoDL 不可用

AutoDL 使用 NAT 共享 IP，无法暴露 UDP 端口，WebRTC 媒体流永远无法建立，属结构性限制，无解。