Sunshine 游戏串流主机完整指南30 分钟免费串出第一帧画面【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine游戏装在书桌上的电脑上手柄也插在电脑上可你想在床上打——搬机器太沉拉 HDMI 太乱再买一套屏幕硬件更贵。Sunshine 是一个自托管的游戏串流服务端装在主机上负责采集画面并硬件编码再走局域网把视频流推给你手里的 Moonlight 客户端手机、平板或电视盒子让你在哪都能玩。这篇实操指南几乎不用代码带你从一台干净的机器走到串出第一帧。值不值得折腾先核对两份信号清单✅ 能上满足大部分就可以动手主机有硬件编码能力NVIDIA 核显/独显NVENC、IntelQuickSync、AMDAMF / VAAPI都行没有独显也可以用 CPU 软编码兜底主机和客户端Moonlight在同一个局域网网口或 WiFi 稳定想免费、自托管、无账号无订阅串流操作包括手柄和键鼠❌ 别上占一条就先停手主机是 macOS 且必须用手柄macOS 端还是实验性状态手柄模拟暂不支持想用手柄请换 Windows 或 Linux 主机两台设备跨公网且不想做任何网络配置默认配置只保证局域网内可用到这里就能判断该不该装了。项目画像它和云端串流差在哪一句话区别云端串流把画面编码放在别人的服务器上Sunshine 的编码跑在你自己的主机上——画质上限、延迟、隐私全部留在局域网里月租是零。能力对照按维度看主机端平台Windows、Linux、FreeBSDmacOS 为实验性支持编码通路NVENC、QuickSync、AMF、VAAPI、Vulkan Video、VideoToolbox外加 CPU 软编码兜底默认自动选第一个可用的画面采集Windows 走桌面复制 APILinux 可选 NvFBC、KMS、X11、WLR、KWin 等多种方式各平台的实现都在 src/platform/ 下管理入口浏览器 Web UI地址https://localhost:47990开源协议GPL v3免费使用费用0 元自托管无账号无订阅核心流程四个检查点串出第一帧每个检查点都告诉你做什么和怎么算成功全部通过才算跑通。检查点一装完主机端软件安装过程零报错 按系统拿安装包Windows 到项目 Release 页面下Sunshine-Windows-AMD64-installer.msi双击安装Linux 按发行版选 deb、RPM、Flatpak 或 AppImagemacOS 把 DMG 里的Sunshine.app拖进 Applications。Flatpak 用户多一步必做安装后运行下面的命令补输入依赖否则键鼠注入会缺组件flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine怎么算成功安装程序正常退出、没有报错弹窗Flatpak 用户那条脚本跑完无报错。检查点二服务活着且以后会自动活Windows 的 MSI 已经把它注册成系统服务并开机自启这个检查点直接跳过。Linux 手动拉起服务想开机自启就加上enablesystemctl --user start app-dev.lizardbyte.app.Sunshine systemctl --user --now enable app-dev.lizardbyte.app.SunshinemacOS 首次启动会弹屏幕录制和麦克风授权都点允许否则后面采集不到画面和声音。怎么算成功Linux 执行systemctl --user status app-dev.lizardbyte.app.Sunshine状态显示 runningmacOS 的授权弹窗都点了允许。检查点三管理员账号建好了 浏览器打开https://localhost:47990。页面提示不安全是自签名证书导致的忽略即可。首次进入会让你设置管理员用户名和密码——记好它后面配对全靠这组凭据。怎么算成功设置完凭据后重新打开页面不再提示初始化而是正常显示管理界面。检查点四Moonlight 配对成功桌面画面和声音都到位在客户端设备打开 Moonlight它会自动扫到局域网里的主机。首次连接会弹一个四位 PIN 码回到 Web UI 顶部的 PIN 页输入它顺手给这台设备起个名字看到成功提示即完成配对。然后在 Moonlight 里点 Desktop。怎么算成功客户端屏幕上出现主机桌面声音也同步到了客户端——第一帧到手整条链路就跑通了。默认值会骗人的四个地方参数表很长完整清单在 docs/configuration.md但只有这几处默认值最容易误导新手。统一记一个句式别信 X其实……别信encoder 留空是没配置好其实它是自动模式。留空 自动选第一个可用编码器日常完全够用。正确动作保持留空只有排障时才手动填nvenc、quicksync、amdvce、vaapi、vulkan、software之一。别信max_bitrate 0 是忘了填其实 0 就是码率交给 Moonlight 决定。只有想给带宽封顶时才填具体数比如max_bitrate 5000Kbps。正确动作想省带宽就填数不想管就保持 0。别信detached 不用勾其实启动命令会立即退出的应用不勾它就断流。比如 Steam 这类启动器进程会马上退出。正确动作在应用配置里勾上detached脱离式启动如果 Sunshine 跑在 Flatpak 里宿主程序命令还要加flatpak-spawn --host前缀沙箱里直接找不到目标。应用配置细节见 docs/app_examples.md。别信改 audio_sink 能静音主机扬声器其实它只决定采集哪块声卡。串流时想让主机自己不响正确动作是把virtual_sink指向一块虚拟声卡系统声音路由过去主机扬声器自然就静了。多声卡时用pactl info | grep Sink查设备名再填。还有一个隐性默认upnp默认是disabled意思是它不会自动帮你开公网端口。只想局域网串流不用管想出局域网就用改成upnp enabled。谁适合这么玩三种玩法各带前提轻薄本带不动 3A 的人把笔记本只当解码显示端游戏跑在书房主机上。前提两台设备同一局域网且网络稳定。不玩游戏、只想要第二块大屏的人主机当家庭影音节点串 Desktop 到电视上看片、看网页。前提静态内容占用带宽很小max_bitrate保持默认 0 即可。一家人共用一台主机的人每个成员在自己的 Moonlight 设备上独立配对各玩各的。前提同一时间整个主机只有一条串流谁在串谁用用完退出即可。卡住了按信号排查按出问题的优先级从高到低走先查前面的别一上来就改参数。信号 1https://localhost:47990打不开→ 最可能原因防火墙拦了 47990 端口。 → 一条修复动作先确认安装程序写入的防火墙规则还在不确定就临时关防火墙验证一次再补放行规则。信号 2Moonlight 发现不了主机→ 最可能原因服务没在跑或者两台设备不在同一网段。 → 一条修复动作Linux 执行systemctl --user status app-dev.lizardbyte.app.Sunshine确认 running再核对两台设备同网段。信号 3串流卡顿、掉帧→ 最可能原因网络而不是 Sunshine 本身。 → 一条修复动作跑 iPerf3 体检目标是丢包低于 5%、抖动低于 1ms。主机端起服务iperf3 -s客户端侧测速把主机 IP 换进去UDP 反向测 60 秒iperf3 -c 主机IP -t 60 -u -R -b 50M丢包高常是两头速度不匹配比如 2.5G 网卡配 WiFi 客户端降一档网卡速率或把主机端改回有线通常立刻见效。信号 4忘了管理员密码→ 最可能原因凭据丢失。 → 一条修复动作不用重装执行sunshine --creds {新用户名} {新密码}直接重置。排查时翻日志是最后一招Windows 日志在%ProgramFiles%\Sunshine\config\sunshine.logLinux/macOS/FreeBSD 在~/.config/sunshine/sunshine.logDocker 部署用docker logs sunshine。Web UI 也内置了故障排查页把日志条目和定位提示放在一起看更多疑难杂症按 docs/troubleshooting.md 里的索引查。今天就能做的三件事跑一次 iPerf3 网络体检把稳定性基线记下来——以后调画质有依据拿第二台设备配一次对完整走一遍配对 → 启动 → 串流 → 退出往应用列表里加一条真实游戏勾好detached今晚就串一局想继续深挖完整参数表看 docs/configuration.md入门步骤的原文在 docs/getting_started.md各平台的采集与编码实现都在 src/platform/ 里。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考