把 Mac 变成家庭游戏串流主机一次搞定Sunshine macOS 安装与配对完整教程【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想在客厅的大屏电视或平板上玩 Mac 里的游戏用 Sunshine 就能把 Mac 变成低延迟串流主机同一局域网里任何装有 Moonlight 客户端的设备都能远程操作你的 Mac 桌面和游戏。这篇教程带你走完从安装到首次配对成功的完整流程。出发前安装前的 30 秒自查检查项要求为什么需要系统版本macOS 14.2 或更高官方最低系统要求低版本无法运行当前构建芯片架构Apple Siliconarm64或 Intelx86_64官方 DMG 按架构分发包装错无法启动网络有线局域网或 5GHz WiFi串流对延迟极敏感官方推荐主机与客户端都走 5GHz 802.11ac接收设备装好 Moonlight 客户端Sunshine 只负责采集与编码解码显示由 Moonlight 完成编译器仅源码构建需要Apple Clang 15项目代码要求 C23 支持从安装到首次配对完整 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:4799047990 是 Sunshine 默认 Web UI 端口。浏览器会提示证书不安全这是自签名证书导致的点继续访问。首个界面让你设置用户名和密码务必记下来后面配对要用。成功标志进入主配置界面能看到主题、语言等选项。卡住了页面打不开就确认菜单栏图标在运行改过端口的话按配置项调整后再访问。第 4 步添加要串流的应用在左侧栏进入Applications页面把想串流的游戏或常用应用添加进去比如打开某个 .app 或执行一条命令。默认的 Desktop 条目无需配置可直接串流整个桌面。成功标志新应用出现在应用列表中。卡住了应用列表保存在配置文件同目录的apps.jsonmacOS 默认位于~/.config/sunshine/也可以直接编辑该文件。第 5 步用 PIN 完成 Moonlight 配对在接收设备的 Moonlight 客户端里选中你的 Mac当它索要 PIN 时切到 Sunshine Web UI 的PIN页面输入 Moonlight 显示的 PIN 并按 Enter再给设备起个名字。成功标志Moonlight 弹出成功提示列表里可以选应用开始串流。✅卡住了发现不了设备时先确认两端在同一局域网并且已允许本地网络权限。验证成功3 个检查点浏览器能打开https://localhost:47990菜单栏图标正常显示。Moonlight 客户端能发现主机PIN 配对成功。串流画面正常出现且音画同步通过 Homebrew 安装的可在终端运行sunshine --version输出版本号。进阶区非必需备选用 Homebrew 一条命令装这组命令会更新 Homebrew、添加 LizardByte 官方 tap 并安装 Sunshinebrew 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需付费授权。常见问题快速排障表现象原因处置Web UI 打不开Sunshine 未运行或端口被改确认菜单栏图标在运行默认端口 47990串流黑屏、无画面屏幕录制权限未授予在Troubleshooting Permissions打开授权页允许后选 Quit ReopenMoonlight 找不到设备macOS 15 未允许本地网络Bonjour访问系统设置 隐私与安全性 本地网络中允许 Sunshine串流无声音系统音频录制权限未给或 Audio Sink 填错Audio Sink 留空使用内建 Audio TapmacOS 14或改用 BlackHole输入不响应辅助功能/键盘鼠标权限未授予系统设置 隐私与安全性 辅助功能中添加 Sunshine源码构建失败依赖缺失或编译器过旧重装上面依赖清单确认 Apple Clang 15需 C23终端警告刷屏日志噪音不一定是错误看Troubleshooting页的分类日志按提示处理收尾到这里你的 Mac 已经是一台可用的 Moonlight 串流主机同网络下任何设备都能随时开串。更细的配置项和平台差异继续看仓库里的 官方入门指南 即可。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
