把 Mac 变成家庭游戏串流主机，一次搞定：Sunshine macOS 安装与配对完整教程

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

想在客厅的大屏电视或平板上玩 Mac 里的游戏？用 Sunshine 就能把 Mac 变成低延迟串流主机，同一局域网里任何装有 Moonlight 客户端的设备都能远程操作你的 Mac 桌面和游戏。这篇教程带你走完从安装到首次配对成功的完整流程。

出发前：安装前的 30 秒自查

从安装到首次配对：完整 5 步流程

第 1 步：下载匹配架构的 DMG 并安装

先打开「系统设置 > 关于本机」确认自己是 Apple Silicon 还是 Intel，再下载对应的官方安装包Sunshine-macOS-arm64.dmg或Sunshine-macOS-x86_64.dmg。打开后把Sunshine.app拖进 Applications 文件夹，再弹出磁盘镜像。

成功标志：Applications 里出现Sunshine.app。卡住了：双击打不开，多半是架构和芯片不匹配，核对后重新下载正确的那个。

第 2 步：首次启动，授予系统权限

首次启动时，macOS 会依次申请屏幕录制、键盘与鼠标控制权限，macOS 15 及以上还会申请本地网络访问。逐项允许即可。🎯

成功标志：菜单栏出现 Sunshine 图标，Web UI 首页没有红色权限告警。卡住了：允许屏幕录制后 macOS 弹出「Quit & Reopen」时，选它——运行中的进程只有重开才能拿到新权限。

第 3 步：打开 Web UI 完成初始设置

在浏览器地址栏输入https://localhost:47990（47990 是 Sunshine 默认 Web UI 端口）。浏览器会提示证书不安全，这是自签名证书导致的，点继续访问。首个界面让你设置用户名和密码，务必记下来，后面配对要用。

成功标志：进入主配置界面，能看到主题、语言等选项。卡住了：页面打不开就确认菜单栏图标在运行；改过端口的话按配置项调整后再访问。

第 4 步：添加要串流的应用

在左侧栏进入Applications页面，把想串流的游戏或常用应用添加进去，比如打开某个 .app 或执行一条命令。默认的 Desktop 条目无需配置，可直接串流整个桌面。

成功标志：新应用出现在应用列表中。卡住了：应用列表保存在配置文件同目录的apps.json（macOS 默认位于~/.config/sunshine/），也可以直接编辑该文件。

第 5 步：用 PIN 完成 Moonlight 配对

在接收设备的 Moonlight 客户端里选中你的 Mac，当它索要 PIN 时，切到 Sunshine Web UI 的PIN页面，输入 Moonlight 显示的 PIN 并按 Enter，再给设备起个名字。

成功标志：Moonlight 弹出成功提示，列表里可以选应用开始串流。✅卡住了：发现不了设备时，先确认两端在同一局域网，并且已允许本地网络权限。

验证成功：3 个检查点

1. 浏览器能打开https://localhost:47990，菜单栏图标正常显示。
2. Moonlight 客户端能发现主机，PIN 配对成功。
3. 串流画面正常出现且音画同步；通过 Homebrew 安装的，可在终端运行sunshine --version输出版本号。

进阶区（非必需）

备选：用 Homebrew 一条命令装

这组命令会更新 Homebrew、添加 LizardByte 官方 tap 并安装 Sunshine：

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

备选：用 MacPorts 源码构建

这条命令会更新 MacPorts 的端口索引（相当于刷新软件包列表）：

sudo port selfupdate

这条命令安装构建所需的核心依赖（Qt、Opus、curl、miniupnpc、Node.js 等）：

sudo port install cmake curl libopus miniupnpc ninja npm9 pkgconfig qt6-qtbase qt6-qtsvg

然后克隆仓库（--recurse-submodules用于同时拉取子模块）并构建：

git clone --recurse-submodules https://gitcode.com/GitHub_Trending/su/Sunshine cd sunshine cmake -B build -G Ninja -S . ninja -C build

更多构建选项见 构建指南。

几个调优点

• 系统声音：macOS 14 及以上把Audio Sink留空即可启用内建系统音频采集；想自己管理虚拟音频设备时，装 BlackHole 并把设备名填进该字段。
• 忘记 Web UI 密码：命令行安装方式下运行sunshine --creds {new-username} {new-password}即可重置管理员凭据。
• 按键映射：Command 键不会被 Moonlight 转发，用右 Option 键顶替 CMD。
• 手柄：macOS 上键盘鼠标开箱即用，手柄模拟需另装 Virtual HID Broker（需付费授权）。

常见问题快速排障表

收尾

到这里，你的 Mac 已经是一台可用的 Moonlight 串流主机，同网络下任何设备都能随时开串。更细的配置项和平台差异，继续看仓库里的 官方入门指南 即可。

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