在 Mac 上用 Moonlight 串流 Windows 游戏
在 Mac 上用 Moonlight 串流 Windows 游戏
Windows 主机运行游戏和 Sunshine,Mac 用 Moonlight 接收画面并发送键鼠、手柄输入。游戏仍在 Windows 上执行,Mac 不需要安装 Windows 版游戏,也不依赖兼容层。
我的组合是 Mac mini M4 与一台配备 RTX 3050 Ti Laptop 4 GiB 显存的 Windows 11 笔记本,游戏使用 GTA5。下面从局域网搭建讲起,再处理连接黑屏、Sunshine 崩溃、NVENC 编码超时和画质问题。低显存笔记本尤其要把游戏负载和编码负载一起考虑。
1. 环境准备
| 位置 | 需要准备的内容 |
|---|---|
| Windows 主机 | 已安装显卡驱动,游戏能在本机正常运行,安装 Sunshine |
| Mac 客户端 | 安装 Moonlight,能访问 Windows 所在局域网 |
| 网络 | 主机优先有线;Mac 可先用有线排除无线波动,再换回日常网络 |
| 显示 | Windows 有可供捕获的活动显示器,先用正常桌面验证 |
连接过程是:
Windows 游戏 → Sunshine 捕获与编码 → 局域网 → Moonlight 解码 → Mac 显示
↑ │
└──────── 输入控制 ──────────┘先在同一局域网完成搭建。跨网络访问还涉及路由、可达性和访问控制,等本地链路稳定后再处理,避免把两类问题混在一起。
2. 安装 Sunshine
从 Sunshine 官方发布页 下载适合 Windows 和处理器架构的安装包,按安装说明安装。使用安装器部署服务,避免又手动启动第二个 Sunshine 实例;新装与升级都要确认显卡驱动满足该版本要求。Windows 安装说明
安装后在 Windows 浏览器打开默认管理地址:
https://localhost:47990首次访问建立管理账号。默认使用自签名证书,核对地址确实是自己的主机后再继续;不要把管理密码当作 Moonlight 配对 PIN。进入管理界面检查应用列表,确认有 Desktop 入口。
在管理员 PowerShell 查看服务与进程:
Get-Service *sunshine*
Get-Process sunshine -ErrorAction SilentlyContinue |
Select-Object Id,StartTime,Path如果没有找到服务,检查安装日志和所用安装方式;如果已有一个实例,不要再用另一个配置目录手动启动同名进程。服务运行后,先保留默认编码设置,暂时不改 HEVC、HDR 或高级 NVENC 参数。
2.1 端口设置
Sunshine 默认基础端口为 47989,Web 管理界面默认是 47990。基础端口改变时,其余服务端口也会偏移。我这台主机曾使用 48989,对应管理地址为 https://主机IP:48990;这是自定义配置,并非安装后应该照抄的端口。
只在确定端口被其他服务占用时调整。修改后同时核对 Sunshine 配置界面显示的端口、防火墙规则和 Moonlight 主机地址。管理页面能访问只说明管理通道可达,不代表视频流正常。Sunshine 网络配置
2.2 防火墙规则
保留安装器创建的 Sunshine 规则,核对规则是否启用、是否适用于当前网络配置文件。管理员 PowerShell 可以先查看:
Get-NetConnectionProfile | Select-Object InterfaceAlias,NetworkCategory
Get-NetFirewallRule -DisplayName '*Sunshine*' |
Select-Object DisplayName,Enabled,Profile,Direction,Action
Get-NetFirewallRule -DisplayName '*Sunshine*' |
Get-NetFirewallPortFilter |
Select-Object Protocol,LocalPort,RemotePort规则名称因安装包和语言而异,必要时在“高级安全 Windows Defender 防火墙”中按程序路径检查。视频传输需要 UDP,只做 TCP 端口测试无法验证它;自定义端口后也要更新相应规则,不要只放行 WebUI,更不要为方便排障长期关闭整个防火墙。
3. 安装与配对 Moonlight
从 Moonlight 官方网站进入 macOS 下载页,安装并启动客户端。Windows 先保持登录桌面和显示器活动。
- 在 Moonlight 中查看是否自动发现 Windows 主机。没有发现时,点击添加主机,输入它的局域网 IPv4 地址。
- 使用自定义基础端口时,添加
主机IP:端口,例如192.168.1.50:48989。这个地址不是 Web 管理端口。 - 选择主机,取得 Moonlight 显示的配对 PIN。
- 回到 Sunshine 管理界面的 PIN 页面,输入这一次的 PIN 并提交。
- 返回 Moonlight,打开主机应用列表,先选择 Desktop。
配对通过 Sunshine 页面完成即可,不需要修改 sunshine_state.json 或手工调用配对 API。如果同时发现同名主机,核对 IP、端口和 Windows 上实际运行的串流服务,再删除客户端中不再使用的主机条目。Moonlight 搭建与操作说明
4. 首次串流
第一轮可以从下列设置起步,目标是建立一个容易排查的基线,不是最高画质:
| 项目 | 起步设置 |
|---|---|
| 分辨率 | 1920 × 1080 |
| 帧率 | 60 FPS |
| 码率 | 15–20 Mbps,网络不稳时再降低 |
| 编码格式 | 自动;排查兼容性时单独对比 H.264 |
| HDR | 先关闭,SDR 正常后再启用 |
连接 Desktop 后移动窗口、播放声音,测试鼠标与键盘。按 Ctrl+Alt+Shift+S 打开性能统计,Mac 键盘上的 Alt 对应 Option;检查帧率、网络掉帧和解码耗时。再启动游戏,重复观察同一组指标。退出串流可用 Ctrl+Alt+Shift+Q,它不会保证把主机上的游戏一起关闭。
游戏内分辨率、Windows 桌面分辨率和 Moonlight 请求分辨率需要一起核对。客户端选择 1080p 不保证主机已经自动把桌面切成 1080p;先确认画面比例、文字大小和捕获的显示器都正确,再加高刷新率或 HDR。
5. 黑屏与无声音
按下面顺序区分网络和捕获问题:
- 先串流 Desktop。 桌面正常、只有某个游戏黑屏时,检查该游戏的窗口/全屏模式、显示器和捕获路径,而不是先重配主机。
- 确认 Windows 的显示器仍活动。 笔记本合盖、拔掉显示器或切换显示模式后,重新检查 Sunshine 捕获的是哪一个输出。
- 检查当前网络和 UDP 规则。 尤其是换了 Wi-Fi、VPN 或 Sunshine 基础端口之后;WebUI 可访问和 ping 正常都不能排除这一层。
- 查看 Sunshine 日志中的显示器与编码器初始化。 双显卡机器要核对实际显示适配器,不要只因有 NVIDIA GPU 就假定所有显示输出都走它。
- 无声音时单独检查音频设备。 先确认 Windows 本机有输出、客户端未静音,再查 Sunshine 选择的音频设备。
如果经 RDP 改过显示会话,先回到主机正常控制台桌面重试。若降低码率立刻改善,再结合 Moonlight 的网络统计处理链路,不能仅用“黑屏”就认定显存不足。Moonlight 故障排除
6. Sunshine 崩溃
我在 Sunshine 0.23.1 上遇到过画面冻结与无法重连。服务管理器仍显示 Running,但事件日志一分钟内有 6 次应用崩溃,Sunshine 日志反复出现完整启动序列。服务被重新拉起会掩盖进程已经崩溃的事实。
在 Windows 上执行:
Get-Service *sunshine*
Get-Process sunshine -ErrorAction SilentlyContinue |
Select-Object Id,StartTime,Responding
Get-WinEvent -FilterHashtable @{
LogName='Application';Id=1000;StartTime=(Get-Date).AddHours(-3)
} | Where-Object Message -match 'Sunshine' |
Select-Object TimeCreated,Id,Message
Get-Content 'C:\Program Files\Sunshine\config\sunshine.log' -Tail 100同时看三件事:进程的 StartTime 是否不断刷新、Application 事件是否对应相同 EXE、日志是否重复初始化。该次异常为 0x80000003,模块和偏移相同;仅凭异常码还不能定位到某个证书或某行代码,需要转储和调用栈继续分析。
处理前保存配置目录和故障日志,再按官方升级步骤更新兼容版本;如果只有某个客户端配对失败,通过 UI 删除对应配对再重配,不要一开始清空全部状态文件。我当时升级到 v2025.628.4510 后连续串流 50 分钟未再次崩溃,但后续仍遇到了编码超时,因此下面这类问题要另外查。
7. 编码超时
frame 1 encode wait timeout 表示编码等待没有及时完成。一次故障时,GPU 读数是显存 3688/4096 MiB、利用率 92%、功耗 60 W。对只有 4 GiB 显存的主机,这是值得同时检查游戏纹理、后台程序和编码配置的信号。
在串流前启动采样,保留故障前后的变化:
nvidia-smi --query-gpu=timestamp,name,memory.used,memory.total,utilization.gpu,power.draw --format=csv -l 2按同一游戏场景逐项尝试:
- 先降低游戏纹理或其他高显存设置,再测原分辨率与帧率。
- 退出不用的 GPU 应用及录屏/覆盖层,观察显存和编码延迟是否一起下降。
- 降低串流分辨率或帧率,确认编码负载变化。
- 核对日志是否真正使用 NVENC,驱动和 Sunshine 是否匹配;出现初始化或版本错误时先解决兼容性。
不要把某一个显存百分比当成所有机器的安全线。高显存读数与超时同时出现,还不足以证明驱动内部一定发生了分配失败;如果进程无法停止,保留错误和 PID,在可接受的维护时间重启主机,再用较低负载复测。
HAGS 与 NVENC 优先级
Sunshine 的 nvenc_realtime_hags 控制 Windows HAGS 开启时 NVENC 使用的调度优先级。出现高负载冻结时,可以在保留其他设置的前提下对比:
nvenc_realtime_hags = disabled这不等于关闭 Windows 的“硬件加速 GPU 调度”,降低优先级也可能牺牲繁忙时的捕获性能。修改后按界面要求重启 Sunshine,再测同一场景;无改善就还原。要比较系统 HAGS 开关,在 Windows 图形设置中单独修改并按要求重启,不要同时换驱动和改一串编码参数。NVENC 调度配置
这台机器修改 Sunshine 优先级后仍有超时,尚不能把 HAGS 认定为唯一根因。
8. 画质与 HDR
先用 Moonlight 统计定位卡顿:网络掉帧增加时,优先降低码率并排查无线链路;解码耗时高时,降低客户端接收的分辨率/帧率或更换格式对比;服务端编码延迟高时,回到 GPU 负载和编码设置。
画质调优从同一场景开始,一次改一个选项:
| 现象 | 优先比较 |
|---|---|
| 快速运动模糊、细节糊 | 在网络余量内增加码率,或降低输出负载 |
| 暗部渐变有色带 | 实际位深、编码格式、HDR/SDR 与显示范围 |
| 开 HDR 后发灰或过曝 | 主机 HDR、客户端 HDR、显示设备与校准是否匹配 |
| 切格式后延迟变大 | 主机编码和 Mac 解码是否都走硬件路径 |
hevc_mode 是 HEVC 能力通告设置,不应写成 4 来强制“10-bit 4:4:4”;Main10 也不等于 4:4:4。保持自动能力检测,再从实际编码器日志与客户端统计确认协商到的格式。NVENC preset 的较高档位还会增加编码成本,先跑稳再调质量,不能假定 P7 在所有游戏中都更合适。编码配置
9. 自动恢复
我的后续运行中,9 月 1—3 日有 8 次编码超时对应的看门狗重启,另有 5 次服务停止后的拉起。这说明自动化减少了人工操作,但仍然发生过故障,不能据此认为问题已经消失。
先解决日志里可定位的问题,再考虑恢复脚本。自动化至少要识别新错误、设置重启间隔、记录动作前后 PID,并验证客户端能重新连接;不要看到旧日志里还有一次 timeout 就反复重启,也不要在游戏进行中悄悄无限重试。
每次更改前保存 Sunshine 配置和 Moonlight 设置;升级回退时注意配置兼容,重新配对后再验证 Desktop、游戏画面、输入与音频。最终以一段实际游戏会话中的帧率、延迟、掉帧和重连结果判断效果,服务显示 Running 只是起点。
