在 Mac 上试用

nSIM 只在 Linux 上运行。模组插在 Mac 上时，可以借 OrbStack 运行 nSIM。OrbStack 把模组透传进它的 Linux 环境，nSIM 在其中用 Docker 运行。

开始之前

已安装并启动 OrbStack 2.2.3 或更新的版本。高通模组的 USB 透传从这一版开始可用。
模组已经用 USB 接到 Mac。
读过用 Docker 安装，这一页沿用那里的 compose 文件和配置文件。

目前只在 OrbStack 上验证过，没有试过 Mac 上其他的 Docker 方案。AT 串口、QMI、MBIM、模组网卡、eSIM 和热插拔在 OrbStack 上都工作正常。

把模组透传进 OrbStack

在 Mac 的终端里列出 USB 设备：
终端窗口
```
orb usb list
```
厂商 ID 是 2c7c（移远）或 05c6（高通）的就是模组，记下第一列的设备 ID。
对每台模组执行一次透传：
终端窗口
```
orb usb attach <设备 ID>
```
再运行 orb usb list，这台模组那一行会显示 attached。

准备文件并启动

照用 Docker 安装准备目录，写好 docker-compose.yml 和 config/config.yaml。
在 docker-compose.yml 的 volumes 下多加一行：
```
      - /opt/orbstack-guest:/opt/orbstack-guest:ro
```
模组重启后，OrbStack 有时仍显示设备已透传，Linux 里却已经没有这台设备。有了这一行，nSIM 能自己把设备断开再重新透传。这一行只用于 OrbStack，Linux 主机上不要加。
启动：
终端窗口
```
docker compose up -d
```

完成后

在 Mac 的浏览器里打开 http://127.0.0.1:7575，能看到登录页。OrbStack 会把端口映射到 Mac 本机，不需要额外设置。

用 127.0.0.1 打开时，浏览器把它当作安全环境，网页通话可以直接使用麦克风。

接下来