Isaac Sim 5.1.0 部署指南（实验室服务器）
适用场景：实验室 Linux 服务器运行 Isaac Sim，Mac 本地通过 WebRTC 客户端远程查看画面
⚠️ 不适用于 AutoDL：AutoDL 不支持 UDP 端口，Isaac Sim WebRTC 必须用 UDP 47998 传输媒体流，结构性不可用。详见文末说明。
前置要求
硬件要求（官方文档 5.1.0）：
| 项目 | 最低 | 推荐 | 理想 |
|---|---|---|---|
| GPU | RTX 4080 | RTX 5080 | RTX PRO 6000 |
| VRAM | 16GB | 16GB | 48GB |
| RAM | 32GB | 64GB | 64GB |
| 存储 | 50GB SSD | 500GB SSD | 1TB NVMe |
| CPU 核心 | 4 核 | 8 核 | 16 核 |
⚠️ 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），若系统盘空间有限，建议通过软链接将其路由至数据盘。
bash
# 缓存软链接
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，将在后续版本移除。
bash
python3.11 -m venv /extra/xubinyao/isaac_env
source /extra/xubinyao/isaac_env/bin/activate
pip install --upgrade pip第三步：安装系统图形依赖与 Isaac Sim
bash
# 安装无窗口模式所需的图形库（官方 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（服务端）
bash
# 激活虚拟环境
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 | 实验室服务器 |
|---|---|---|
| UDP 47998（媒体流） | ❌ NAT 不支持 | ✅ 可开放 |
| TCP 49100（信令） | ✅ SSH 隧道可转 | ✅ 可开放 |
| 独立公网 IP | ❌ 共享 NAT | ✅ 通常有 |
AutoDL 使用 NAT 共享 IP，无法暴露 UDP 端口，WebRTC 媒体流永远无法建立，属结构性限制，无解。