fxgl/steamac

选用指南

AI 根据 README 整理 · 2026/10/11 13:56:18

适用场景

适合在 macOS 上运行 SteamOS 游戏，支持 Steam Remote Play 局域网串流，并可通过 SSH 访问虚拟机。

查看 README 依据

`--mouse tablet` — absolute tablet (gamescope ignores it, so only for other guest compositors), `--mouse capture` — always capture on click. Guest access: `ssh -p 2222 steamos@127.0.0.1`, password `steamos` (change via `STEAMOS_PASSWORD=... scripts/build-image.sh disk`). The hvc0 console is in the terminal running `run.sh`. SSH is toggled with one switch: **Settings → Advanced → Enable SSH** (or `--ssh-port N` / `--no-ssh`). On each boot the launcher passes `steamac.ssh=0|1`: with 0, the Mac port is not opened

Ordinary networking uses gvproxy user-mode NAT (`192.168.127.2` in SteamOS); LAN broadcasts do not cross that NAT. **Settings → Advanced → LAN Remote Play** (next start), or `--lan-remote-play`, enables a launcher-side discovery relay and same-port forwards: UDP **27031–27036**, TCP **27036–27037**, from the Mac to the guest. It is **off by default**: enabling it exposes Steam's Remote Play services to other machines, independently of SSH. `--no-lan-remote-play` disables it for one boot; Network off disables it too.

使用方式

通过命令行脚本构建和运行，如 ./build.sh 和 ./run.sh，也提供图形界面应用 FX Steam Launcher。

查看 README 依据

Bundling rejects Mach-O deployment targets above macOS 15.0 (KosmicKrisp alone may require 26.0). ## Building and running ```sh ./build.sh # everything: MoltenVK, virglrenderer, libkrun, launcher, kernel, Mesa, disk ./run.sh # a window with SteamOS ``` Build parts separately: `./build.sh host`, `./build.sh guest`, or the scripts in the table below. The SteamOS image is downloaded from Valve's servers (a signed RAUC bundle); its signature and sha256 are verified. Guest release artifacts have adjacent `.inputs.json` build receipts binding their selected Git

at all (gvproxy without forwarding), and initramfs masks sshd in SteamOS. By default SSH is enabled in the dev launcher (`work/out/steamac-vm`, `./run.sh`, port 2222) and disabled in `FX Steam Launcher.app` (the `SteamacReleaseDefaults` key in Info.plist, set by `bundle.sh`). When enabled, the launcher generates a password for user `steamos` (20 characters, SecRandomCopyBytes), stores it in the Keychain separately for each disk (by its GPT GUID), and on the next boot passes only its SHA-512 crypt hash to the guest (“config payload” disk, `steamac.config=1`; the guest

部署要求

需要 Apple Silicon Mac、macOS 15+、约 150 GB 可用空间，以及 Xcode 26+、Homebrew、rustup 等构建工具。

查看 README 依据

`VK_EXT_depth_clip_enable` (PR #2712) + our fixes, by default. KosmicKrisp (Mesa's Vulkan driver on Metal 4) is an experimental alternative on macOS 26+ (see “Vulkan driver”). ## Requirements - Apple Silicon Mac, macOS 15+, ~150 GB of free space (the disk image is sparse). - Xcode 26+ (full installation: its `actool` builds the app icon from an Icon Composer document), Homebrew, rustup. - KosmicKrisp (optional, alternative Vulkan driver): built only on macOS 26+; `host/kosmickrisp/build.sh`

已知限制

LAN Remote Play 默认关闭，且不支持 Wi-Fi 客户端隔离、VLAN 等网络环境；SteamOS 磁盘容量固定，但可通过 Grow Disk 扩展。

查看 README 依据

Ordinary networking uses gvproxy user-mode NAT (`192.168.127.2` in SteamOS); LAN broadcasts do not cross that NAT. **Settings → Advanced → LAN Remote Play** (next start), or `--lan-remote-play`, enables a launcher-side discovery relay and same-port forwards: UDP **27031–27036**, TCP **27036–27037**, from the Mac to the guest. It is **off by default**: enabling it exposes Steam's Remote Play services to other machines, independently of SSH. `--no-lan-remote-play` disables it for one boot; Network off disables it too.

Allow macOS's **Local Network** permission and incoming traffic in the Mac/SteamOS firewall. Steam Link and the Mac must be on the **same IPv4 subnet** (Wi-Fi client isolation, guest networks, VLANs, routed discovery and IPv6-only LANs are not supported). Enable Remote Play in guest Steam; use the Mac's LAN address for manual pairing, not `192.168.127.2`. Quit the Mac's own Steam client if it owns these ports: the launcher never shares or steals UDP 27036, logs conflicts as `remote-play: disabled for this boot`, and rolls back its forwards.

Venus leaves it disabled by default). Never run the allocation test on the developer's disk. **More room for games:** free space on the Mac is not automatically free space inside SteamOS. The home capacity is fixed when a disk is created. **Settings → Advanced → Grow Disk…** increases it without recreating the disk or deleting games (grow only, up to 4096 GiB). For the running disk, **Grow and Restart** shuts SteamOS down normally, takes the disk's exclusive lock while the VM is stopped, enlarges the image, then boots again. SteamOS grows the last home partition with