Sunshine 游戏串流完整指南30 分钟从家用主机串出第一帧画面【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine游戏还开着在书房那台电脑里人却瘫在客厅沙发上——拉 HDMI 线嫌乱搬机器更麻烦。Sunshine 是个自托管的游戏串流服务端装在那台主机上负责采集画面并硬件编码你手里的 Moonlight 客户端负责解码显示手柄和键鼠操作原路传回去。一句话定位Sunshine 是串流链路里的主机端Moonlight 是屏幕端。它和 GeForce Now 这类云游戏的本质区别只有一点编码跑在你自己的显卡上画面流不出局域网画质上限、隐私、延迟全都攥在自己手里。动手之前先过一遍自检清单硬件主机最好带硬件编码单元——NVIDIANVENC、IntelQuickSync、AMDAMF或核显 VAAPI 都行CPU 软编码能跑但吃性能只当兜底。系统Windows、Linux 全支持macOS 是实验性状态且暂不支持手柄模拟想用手柄就把主机放在 Windows 或 Linux 上。网络主机和播放设备在同一局域网网线优先。跨网段、跨公网不在本篇范围内。费用全程 0 元。无账号、无订阅、无云服务费。关键信息速览项目说明主机端系统Windows、Linux、macOS实验性、FreeBSD播放端Moonlight 客户端手机、电视、平板、笔记本均可管理入口浏览器打开https://localhost:47990主机本机访问编码通路NVENC / QuickSync / AMF / VAAPI / Vulkan / VideoToolboxCPU 软编码兜底默认自动选第一个可用的采集方式Windows 走桌面复制 APILinux 可选 NvFBC、KMS、X11、WLR、KWinmacOS 用系统屏幕录制费用与协议免费自托管GPL v3 开源实操走流程阶段一按系统装好 Sunshine 主机端 拿到对应系统的安装包装法都很快Windows从项目 Release 页面下Sunshine-Windows-AMD64-installer.msi双击装完。Linux按发行版选 deb、RPM、Flatpak 或 AppImage 之一。macOS把 DMG 里的Sunshine.app拖进 Applications。Flatpak 用户多一步必做动作——沙箱里缺输入组件键鼠回传会失灵补一条命令装上flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine检查点安装过程正常走完没有报错弹窗。阶段二把 Sunshine 服务跑起来 Windows 的 MSI 已经注册好系统服务并开机自启这步直接跳过。Linux 手动拉起服务systemctl --user start app-dev.lizardbyte.app.Sunshine想重启后自动启动加一条 enable--now表示同时立即启动systemctl --user --now enable app-dev.lizardbyte.app.SunshinemacOS 首次启动会弹屏幕录制和麦克风授权都点允许——前者管能不能采到画面后者管能不能采到声音漏一个串流就缺一半。检查点Linux 上执行systemctl --user status app-dev.lizardbyte.app.Sunshine状态是 running。阶段三建账号、配对 Moonlight验证出画面 浏览器打开https://localhost:47990。页面提示不安全是因为自签名证书忽略即可。首次进入让你设置管理员用户名和密码——之后再也看不到这套凭据记好后面配对全靠它。 在客户端设备打开 Moonlight它会自动扫到局域网里的主机。首次连接会弹出一组 4 位 PIN 码回到 Web UI 的 PIN 页面输入顺手给这台设备起个名字出现成功提示即配对完成。 验证Moonlight 里点 Desktop。主机桌面出现在你手里屏幕上声音跟手。检查点画面、声音、操作延迟都到位关掉再连一次能自动识别设备——到这里整个链路就通了。避坑笔记四个反直觉设置一台主机同一时刻只有一条流。新串流会自动顶掉上一个在跑的应用。家里多人共用不用做任何仲裁谁在串谁用用完退出即可。参数留空不是没配置是自动。encoder留空表示自动挑第一个可用编码器日常完全够用手动写nvenc、amdvce、vaapi、vulkan、software只是排障手段不是日常操作。max_bitrate 0的意思是码率听 Moonlight 的。客户端要多少给多少只有你想给带宽封顶比如5000单位 Kbps时才填数字否则别动。想静音主机扬声器改错了参数。audio_sink管的是采哪块声卡别为了静音去改它正确做法是给virtual_sink指向一个虚拟声卡串流走虚拟通道主机喇叭不出声。另有一个容易踩的启动项Steam 这类启动后立刻退出的进程要在应用配置里勾detached脱离式启动否则流刚开就断Flatpak 里写宿主程序命令时前面还得加flatpak-spawn --host前缀沙箱内直接是找不到目标的。三个真实使用场景笔记本带不动 3A 游戏的人。用轻薄本或平板当解码显示端串书房主机跑游戏手柄直接插在客户端上。前提两台设备同一局域网且网络稳定网线最佳。不玩游戏、只想要大屏的人。主机当家庭影音节点串 Desktop 到电视上看片、看网页。静态画面码率很低max_bitrate保持默认 0 就行几乎不占带宽。一家人共用一台主机的人。每个成员在自己的 Moonlight 设备上独立配对一次各起各的设备名。前提同一时间只能一条流串完退出让位别指望同时各看各的。卡住时的排查速查症状最可能原因一条修复动作浏览器打不开47990防火墙拦了管理端口确认 MSI 写入的放行规则还在拿不准就临时关防火墙验证一次再补规则Moonlight 搜不到主机服务没在跑或两台设备不同网段Linux 执行systemctl --user status确认 running再核对设备是否同网段串流卡顿、掉帧十有八九是网络不是 Sunshine主机端跑iperf3 -s起服务客户端跑iperf3 -c 主机IP -t 60 -u -R -b 50M丢包目标低于 5%忘了管理员密码凭据只出现过一次不用重装sunshine --creds {新用户名} {新密码}直接重置Linux 手柄/键鼠回传失灵输入组件没装Flatpak 补跑flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine日志在本地就有Linux 看~/.config/sunshine/sunshine.logWindows 看%ProgramFiles%\Sunshine\config\sunshine.logDocker 部署用docker logs。Web UI 的 Troubleshooting 页面也内置了日志查看和关键词搜索。收尾现在就可以做拿第二台设备再配对一次然后往应用列表里加一条真实游戏完整走一遍配对 → 启动 → 串流 → 退出。动手调画质之前先跑一次 iPerf3稳定性比带宽峰值更决定体验。想走出局域网之前确认配置里upnp enabled——默认是disabled不打开公网就进不来。延伸阅读完整参数表排障指南入门指南各平台采集与编码实现源码【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考