企业官网建设流程全解析

Sunshine 首次启动 macOS 时如何授权屏幕录制与麦克风并配置系统音频采集？

【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine

在 macOS 上安装 Sunshine 后，第一次启动时系统会要求授予屏幕录制与麦克风访问权限；如果授权不完整，Moonlight 客户端将看不到画面或听不到声音。本文基于项目文档 docs/getting_started.md 与 docs/configuration.md，说明从安装到完成系统音频采集的完整路径：安装 Sunshine、在首次启动时授予权限、在 Web UI 中配置Audio Sink，使串流包含 Mac 的系统声音。

文档明确标注：macOS 版 Sunshine 为实验性支持，且当前不支持游戏手柄（Gamepads are not currently supported）。操作前请确认这一限制可以接受。

安装 Sunshine

文档提供两条安装路径，任选其一。

路径一：DMG 安装包（推荐）

1. 按你的芯片架构下载对应安装包：

   Architecture	Package
   arm64 (Apple Silicon)	Sunshine-macOS-arm64.dmg
   x86_64 (Intel)	Sunshine-macOS-x86_64.dmg

   下载链接在 docs/getting_started.md 的 macOS 安装章节中给出。

2. 打开下载的.dmg文件。

3. 将Sunshine.app拖入Applications文件夹。

4. 弹出磁盘映像。

路径二：Homebrew（可选）

前提：已安装 Homebrew。

brew update brew upgrade brew tap LizardByte/homebrew brew install sunshine

若需要安装测试版，可把sunshine替换为sunshine-beta。

首次启动并授予屏幕录制与麦克风权限

运行Sunshine.app（或sunshine命令）。文档给出的原文说明是：

The first time you start Sunshine, you will be asked to grant access to screen recording and your microphone.

也就是说，第一次启动时 macOS 会依次弹出授权对话框，要求授予：

1. 屏幕录制（Screen Recording）：没有它 Sunshine 无法捕获桌面画面。
2. 麦克风（Microphone）：文档说明在 macOS 上 Sunshine 只能访问麦克风类设备，这是系统权限模型的直接结果；麦克风权限是音频链路的前提。

两项都要选择允许。文档没有给出绕过系统对话框的其他授权方式，按系统弹窗操作即可；若之前拒绝过，需要在 macOS 的「系统设置 → 隐私与安全性」中重新打开对应开关（此为 macOS 系统行为，非 Sunshine 文档内容）。

启动时还需注意：第一次运行 Web UI 时会要求设置账号，文档特别提醒If running for the first time, make sure to note the username and password that you created，请务必记下用户名和密码，后续配置音频就要用它登录。

配置系统音频采集

Sunshine 通过 Web UI 配置，默认地址为 https://localhost:47990（浏览器会提示“不安全网站”，文档说明这是因为使用了自签名证书，可忽略）。

主路径：macOS 14.0 (Sonoma) 及更新版本 —— 留空 Audio Sink

文档说明：

Sunshine supports native system audio capture on macOS 14.0 (Sonoma) and newer via Apple's Audio Tap API. To use it, simply leave theAudio Sinksetting blank.

操作：

1. 打开 Web UI 并登录。
2. 在配置项中搜索Audio Sink（docs/configuration.md 中的audio_sink字段）。
3. 保持该项为空，不做任何修改。

audio_sink的默认行为是 “Sunshine will select the default audio device”；在 macOS 14.0+ 上留空即走 Apple Audio Tap API 的原生系统音频采集，无需安装任何第三方音频驱动。

可选分支：旧系统或自行管理回环设备

如果你希望自行管理回环（loopback）设备，文档支持 Soundflower 或 BlackHole：安装其中一个工具后，把它生成的设备名填入audio_sink字段。文档给出的 macOS 示例是：

audio_sink = BlackHole 2ch

配置方式二选一：

• 通过 Web UI：在audio_sink字段中填入回环设备名称。
• 手动编辑配置文件：macOS 上配置文件位于~/.config/sunshine目录，用文本编辑器打开 conf 文件加入上面的行即可。文档说明“虽然推荐使用配置界面，但也可以手动编辑 conf 文件”。

注意 docs/configuration.md 在audio_sink的 macOS 说明中保留了较早期的表述 “Sunshine can only access microphones on macOS due to system limitations”，即不装回环设备时只能采到麦克风。这与 docs/getting_started.md 中 “macOS 14.0+ 留空即可原生采集系统音频” 的说法并存，适用条件不同：前者对应不启用 Audio Tap API 的场景，实际配置时以你的 macOS 版本是否为 14.0 及以上来判断走哪条路径。

验证与连接测试

1. 在 Moonlight 客户端添加本机后发起连接。若 Moonlight 请求 PIN，按文档流程操作：
   • 登录 Web UI；
   • 点 Navbar 中的 “PIN”；
   • 输入 PIN 并回车，为该设备起一个名字，看到 Success Message 即配对成功；
   • 在 Moonlight 中选择一个 Application 开始串流。
2. 串流中检查：画面是否正常出现（验证屏幕录制授权），系统声音是否传出（验证音频链路；若只有麦克风声音，回到上一步检查 Audio Sink 配置）。
3. 遇到异常时，Web UI 的Troubleshooting页签提供日志，文档建议 “navigate through each warning/error message for clues to the issue”，逐条查看警告与错误定位问题。

已知限制

• 游戏手柄在 macOS 版上当前不受支持，无法通过 Sunshine 回传手柄输入。
• Command 键不会被 Moonlight 转发；文档说明 Right Option-Key 被映射为 CMD-Key，需要呼出 macOS 快捷键时使用右 Option。
• macOS 版整体为实验性支持，功能与稳定性以文档标注为准。

以上步骤完成后，Sunshine 在 macOS 上即可实现画面加系统声音的完整串流；配置细节可继续参考 docs/configuration.md，遇到问题可查阅 docs/troubleshooting.md 的 macOS 章节。

【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine