Sunshine macOS 安装配置全流程6 步跑通游戏串流3 个报错一次讲透【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想在 Mac 上把 Mac 当串流主机让 Moonlight 客户端低延迟拉流却不想啃 CMake 报错本文带你把 Sunshine macOS 安装这条路一次走通跑通 Web UI、搞定系统权限、把编码器调到顺手报错时直接对号入座全程不用翻源码。动手前先把这几项过一遍装之前花两分钟核对下环境省得中途反复返工检查项最低要求备注系统版本macOS 11.0Big Sur及以上系统音频原生采集需 macOS 14芯片架构Apple Silicon 或 Intel两者均走 VideoToolbox 硬编依赖工具Homebrew 或 MacPorts 二选一官方构建脚本默认走 Homebrew构建工具CMake 3.25、Ninja装源码构建时才需要编译器Apple Clang 15C23Xcode Command Line Tools 自带端口47990HTTP、48010RTSP被占用需改配置见后文从 0 到 1 跑通两条路任选路线 A不想编译的直接拿现成的。下载与你芯片对应的 DMGarm64 给 Apple Siliconx86_64 给 Intel。为什么预编译包已含签名跳过所有构建坑。# 按芯片二选一下载 Sunshine-macOS-arm64.dmg 或 Sunshine-macOS-x86_64.dmg打开.dmg把Sunshine.app拖进Applications弹出镜像。为什么macOS 应用标准安装姿势。如果这步卡住 → 见下方应用被拦截那条。首次启动依次放行屏幕录制输入监控键鼠权限macOS 15 还会弹本地网络。为什么采集画面和注入输入都靠这些权限。如果这步卡住 → 见下方权限已给但仍被拒那条。浏览器打开https://localhost:47990记下首次生成的用户名密码浏览器警告不安全属正常自签证书。为什么Web UI 是后续所有配置的入口。路线 B想自己编译的三步搞定。克隆仓库并装齐依赖构建文档里的 macOS 依赖清单git clone https://gitcode.com/GitHub_Trending/su/Sunshine.git --recurse-submodules cd Sunshine brew install boost cmake ninja node openssl3 opus pkgconf qtbase qtsvg miniupnpc为什么这些就是官方 scripts/macos_build.sh 脚本用的同一套公式。如果这步卡住 → 见下方cmake 阶段报错那条。配置并编译产物在build/目录cmake -B build -G Ninja -S . -DCMAKE_BUILD_TYPERelease cmake --build build -j 4 # -j 后的数字可换成你的 CPU 核数为什么Ninja 比默认生成器快Release 保证串流性能。跑起来后Web UI 里加你的应用参考 macOS 应用清单模板Moonlight 客户端输入 PIN 配对就能开始串流了。跑通之后把它调好用配置集中在~/.config/sunshine/sunshine.conf也可以直接在 Web UI 里搜着改详见 配置文档。Mac 上最常被动的几项配置项作用推荐值vt_softwareVideoToolbox 是否允许回退软编auto硬件不够用时自动兜底vt_coder熵编码方式auto画质优先可试cavlcaudio_sink系统音频采集设备macOS 14 留空走原生采集老系统填 BlackHole 设备名max_bitrate码率上限Kbps0跟随 Moonlight 请求弱网可设5000ping_timeout客户端心跳超时ms跨设备串流不稳时适当调大min_log_level日志级别排查时改trace平时infoApple Silicon 用户加分项M 系列的 VideoToolbox 硬编足够应付 1080p60保持vt_software auto即可真要压帧数时优先动max_bitrate别动编码器本身。报错了先对号入座症状浏览器打不开 47990或提示无法访问根因首次启动时权限没给全服务没起来或者 47990 被别的程序占了。看 Web UI 的 Troubleshooting 页或终端日志里有没有Permission denied字样能直接定位。解法先补权限再重启 Sunshine确认端口用lsof -i :47990被占就改配置里对应端口号。症状权限明明都给了仍提示采集被拒根因macOS 的隐私开关和 Sunshine 的条目对不上——常见于重装或更新后旧条目失效日志里表现为反复access denied。解法到系统设置 隐私与安全性里删掉 Sunshine 的旧条目重新添加当前安装的应用然后选 macOS 给出的退出并重新打开让它带着新权限重启。症状源码构建在 cmake 阶段就炸找不到头文件或库根因通常是依赖没装全或 OpenSSL 是 keg-only、头文件没被找到看报错第一行缺的是哪个路径基本能对上号。解法对照第 5 步把brew install重跑一遍仍缺 SSL 头文件时按芯片补一个符号链接# Apple Silicon ln -s /opt/homebrew/opt/openssl/include/openssl /opt/homebrew/include/opensslIntel 用户把路径换成/usr/local/前缀即可。装好后每两周跑一次brew outdated sunshine源码构建用户就git pull看看有新版再更新别等串流卡了才想起来。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考