Sunshine 游戏串流搭建指南10 分钟搭好你的家用串流主机【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想在平板、电视或笔记本上玩 PC 游戏你只需要一台跑 Sunshine 的主机和同一局域网里的 Moonlight 客户端。Sunshine 是开源的自托管游戏串流主机负责把你电脑的画面用显卡硬件编码成视频流并把客户端的键盘、手柄输入转发回主机让你在任意能装 Moonlight 的屏幕上串流游戏。它解决的核心问题就一个不花云游戏月费在自家网络里实现低延迟的 PC 串流。1. 把 Sunshine 装到游戏主机上Sunshine 要装在你玩游戏的那台电脑上而不是你串流到的设备上。各平台的官方安装方式如下都从最新版 Release 页面下载对应安装包。Windows推荐 MSI 安装器下载Sunshine-Windows-AMD64-installer.msi双击安装即可。安装器会自动建防火墙规则和开机服务。⚠️ 安装选项请逐项看清楚再勾选不要盲目全装官方明确不推荐 lite便携zip 版性能有损且需要你手动跑防火墙脚本。Linux优先用发行版专属包Ubuntu/Debian 下载对应的sunshine-ubuntu-24.04-{arch}.deb后执行sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.debArch 走 AUR 或 LizardByte 的 pacman-repoFedora 可以用 copr 仓库。装好后把它设成开机自启的 user servicesystemctl --user --now enable app-dev.lizardbyte.app.Sunshine⚠️ Flatpak 和 AppImage 两种方式都不支持 KMS 抓屏Linux 上最通用的捕获方式如果发行版有官方包请优先用官方包。macOS下载 DMG 拖进应用程序即可。注意官方标注 macOS 版仍是实验性质手柄暂不支持首次启动时记得授予录屏和麦克风权限。成功的样子程序跑起来后浏览器打开https://localhost:47990能看到 Sunshine 的网页界面。2. 首次启动建管理员账户进 Web UI首次访问 47990 端口时Sunshine 会让你自己设置用户名和密码没有预设的默认账号。把这套凭据记下来后面每次登录 Web UI 都要用。两个常见疑惑先说清楚浏览器提示连接不安全是正常的Sunshine 用的是自签名证书点继续访问即可。47990 是 Web UI 端口串流本身走 47989 起始的一组 UDP 端口同一局域网内不需要任何端口转发。Web UI 里可以改主题右上角下拉菜单、查设置、管应用主题偏好不影响串流先跳过。3. 添加第一个可串流的应用Moonlight 连接后看到的不是一个桌面而是应用列表所以你要先告诉 Sunshine 有哪些东西可以串。桌面最省事预置的 Desktop 应用不做任何启动动作直接串流当前屏幕。如果你把它删了可以新建一个同名应用、图片选desktop.png找回来。Steam 大屏模式新建应用启动命令填steam://open/bigpicture并选择以分离detached方式运行。⚠️ Steam 必须用 detached 模式否则串流会立即断开——因为 Sunshine 的普通命令模式会在进程退出时结束串流而 Steam 启动器本身不会立即退出。自定义游戏填游戏可执行文件路径和启动参数即可支持环境变量如$(HOME)。启动命令里如果带了 prep 命令且执行失败应用会直接放弃启动。4. 用 Moonlight 配对并完成第一次串流在客户端设备上装 MoonlightWeb UI 的 Featured Apps 页签里列出了各平台的下载入口。配对流程在 Moonlight 里搜索主机搜不到就手动添加 Sunshine 主机的局域网 IP。Moonlight 请求配对时会显示一个 6 位 PIN。回到 Sunshine Web UI打开导航栏的 PIN 页把 PIN 输进去、给设备起个名字提交后会看到成功提示。回 Moonlight 选择刚添加的主机和应用开始串流。成功的样子屏幕上出现你主机桌面或游戏的实时画面延迟低到可以打游戏。串流中可以用的快捷键和 Moonlight 一致都以CtrlAltShift开头比如CtrlAltShiftF1/F12切换串流哪块显示器。5. 编码器怎么选Sunshine 会自动检测可用的硬件编码器但你仍应该知道各家的对应关系方便在设置页里确认它选对了。对照表如下摘自仓库的功能兼容矩阵显卡WindowsLinuxmacOSNVIDIANVENCNVENC不适用AMDAMFVAAPI / Vulkan Video不适用IntelQuickSyncVAAPI不适用Apple 集显不适用不适用Video Toolbox任意兜底软件编码软件编码软件编码几点实用建议Linux 上尽量用 KMS 捕获它对 VAAPI、Vulkan Video、NVENC 全兼容NvFBC 只能配 NVENC 或软件编码。软件编码什么显卡都能跑但 CPU 占用高只当作没有硬编时的兜底。设置页顶部有搜索框直接搜encoders就能定位到编码器设置不用一页页翻。6. 常见问题按现象找原因打不开 47990 端口 / 客户端连不上主机先确认两边在同一局域网Windows 上确认安装器建的防火墙规则还在lite 版要手动跑add-firewall-rule.bat。浏览器能打开https://localhost:47990但别的设备打不开基本就是防火墙或路由器隔离AP 隔离问题。画面正常但输入没反应Linux 上把运行 Sunshine 的用户加入input组后重新登录Windows 上要获得完整的手柄和 Raw Input 键鼠需要单独安装官方 Virtual HID DriverViGEmBus 只是有限的降级方案。双显卡只串到集显画面Windows 用 Desktop Duplication API 抓屏只抓显示输出所在的那块 GPU。要串 eGPU 的话得把显示器或假负载 dongle接到 eGPU 上。macOS 手柄无效这是官方声明的当前限制不是配置问题。看日志Web UI 的 Troubleshooting 页能逐条查看告警和错误日志文件在主机数据目录下的sunshine.logLinux 为~/.config/sunshine/sunshine.log。7. 延伸阅读与下一步仓库自带的文档比任何教程都全建议按需查阅快速上手文档各平台安装细节、SSH 无头主机启动、HDR 说明配置参考所有配置项的含义和取值故障排查手册按错误信息索引的原因分析编码器实现想看源码可以逛 src/nvenc/ 和 src/platform/需要参与开发的话把仓库克隆下来从源码构建git clone https://gitcode.com/GitHub_Trending/su/Sunshine下一步清单确认 Web UI 里编码器一栏显示的是你的显卡而不是软件编码。给 2~3 个常玩游戏建好 detached 应用图标换掉默认的。在客厅设备上完成一次完整的搜索—配对—串流流程。用有线接主机、5GHz 接客户端把 1080p/60 跑稳后再考虑 4K 或 HDR。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
