Sunshine 游戏串流服务端教程:30 分钟免费串出第一帧画面
发布时间:2026/9/12 18:01:44 锦皓数字建站

Sunshine 游戏串流服务端教程30 分钟免费串出第一帧画面【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine游戏主机塞在书房、人却瘫在沙发抬机器太重、拉 HDMI 太乱、再买套显示设备又贵。Sunshine 是一个自托管的游戏串流服务端装在主机上负责采集画面、硬件编码再把流推给你手里的 Moonlight 客户端。照这篇走一遍你能在自己电脑上免费串出第一帧画面并且以后想调任何参数都知道去哪儿改。先花 30 秒判断要不要继续读适合主机带硬编码能力的显卡NVENC / QuickSync / AMF / VAAPI想把键鼠或手柄操作从沙发上的设备传回去。适合主机和观看端在同一局域网追求免费、无账号、无订阅。不适合主机是 macOS 且必须用手柄——macOS 端目前是实验性的手柄不被支持要用虚拟手柄请选 Windows 或 Linux 主机。不适合只想要跨互联网串流却不愿配置网络——默认upnp disabled公网连接需要额外设置。项目速览维度内容主机端平台Windows、Linux、macOS实验性、FreeBSD编码通路NVENC、QuickSync、AMF、VAAPI、Vulkan Video、VideoToolbox软编码兜底画面采集Windows 桌面复制 APILinux 可选 KMS、NvFBC、X11、WLR、KWinmacOS 系统屏幕录制管理入口浏览器 Web UI默认https://localhost:47990开源协议GPL v3费用免费自托管无账号无订阅它和云端串流服务的区别一句话编码跑在你自己的显卡上画质上限和隐私都留在局域网里。从安装到出画面的分阶段流程阶段一装主机端软件 Step 1按系统拿安装包Windows从 Release 页下载Sunshine-Windows-AMD64-installer.msi双击安装安装器会写好防火墙规则并把 Sunshine 注册成系统服务。Linux按发行版选 deb、RPM、Flatpak 或 AppImage 包。macOS把 DMG 里的Sunshine.app拖进 Applications。Flatpak 用户装完必须再跑一条输入依赖安装命令否则键鼠注入会缺组件flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine检查点安装过程正常结束没有报错弹窗。阶段二把服务跑起来 Step 2启动 Sunshine 服务Windows 的 MSI 已经注册好服务并开机自启直接跳过。Linux 手动拉起服务systemctl --user start app-dev.lizardbyte.app.Sunshine想开机自启再执行systemctl --user --now enable app-dev.lizardbyte.app.Sunshine。macOS 首次启动会弹屏幕录制和麦克风授权都点允许否则采集不到画面和声音。检查点Linux 上执行systemctl --user status app-dev.lizardbyte.app.Sunshine状态显示 running。阶段三建账号、配对、出画面 Step 3设置管理员账号并配对客户端浏览器打开https://localhost:47990浏览器提示不安全是自签名证书导致忽略即可。首次进入会让你设置管理员用户名和密码记好后面配对全靠它。然后打开 Moonlight 客户端它会自动扫到局域网里的主机首次连接会弹一个四位 PIN 码——回 Web UI 顶部的 PIN 页输入顺手给设备起个名字看到成功提示即配对完成。检查点Moonlight 里点 Desktop客户端屏幕上出现主机桌面画面和声音都到位。装完必知的四个反直觉行为encoder留空不是没配置而是自动选第一个可用。默认行为是自动挑编码器日常够用手动填nvenc、quicksync、amdvce、vaapi、vulkan、software只是排障时用的手段别为了显得专业去锁死。max_bitrate默认0意思是码率听 Moonlight 的。为0时 Sunshine 按客户端请求的码率编码只有你想给带宽封顶时才填具体数比如max_bitrate 5000表示最高 5000 Kbps。串启动即退出的应用要勾 detached。Steam 这类启动器进程会立刻退出若按普通应用方式启动流刚开就断在应用配置里勾上detached脱离式启动即可。另外 Flatpak 里写的宿主程序命令必须加flatpak-spawn --host前缀否则沙箱内找不到目标。多声卡时audio_sink默认值会骗你。它默认取系统默认设备决定的是采哪个声卡的音想让主机扬声器静音别动它改用virtual_sink指向虚拟声卡。多声卡时 Linux 先用pactl info | grep Sink查设备名再填。典型使用场景轻薄本带不动 3A拿轻薄本做解码显示端串流书房主机跑游戏。前提两台设备同一局域网且网络稳定。只想要家庭大屏主机当影音节点串 Desktop 到电视看片、看网页。前提静态内容带宽占用很小max_bitrate保持默认0即可。一家人共用一台主机每个成员在自己的 Moonlight 设备上独立配对。前提同一时间只有一条流——新串流会自动终止上一个在跑的应用谁连着谁用用完退出。出事了按这个顺序查症状最可能原因一条修复动作https://localhost:47990打不开防火墙拦了 47990检查防火墙规则Windows 先确认 MSI 写入的规则还在Moonlight 发现不了主机不同网段或服务没在跑Linux 执行systemctl --user status确认 running再核对两台设备同网段串流卡顿、掉帧大概率是网络不是 Sunshine跑 iPerf3目标是丢包低于 5%、抖动低于 1 ms忘了管理员密码凭据丢失不用重装执行sunshine --creds {新用户名} {新密码}直接重置网络体检主机端先起iperf3 -s客户端侧执行iperf3 -c 主机IP -t 60 -u -R -b 50M。丢包高常因两头速度不匹配比如 2.5G 网卡配 WiFi 客户端——把主机网卡降一档速率通常立刻见效。日志位置Windows 在%ProgramFiles%\Sunshine\config\sunshine.logLinux/macOS/FreeBSD 在~/.config/sunshine/sunshine.log。Web UI 的 Troubleshooting 页也能直接翻告警。装完后的第一个小时现在就可以做拿第二台设备完整走一遍配对 → 启动 Desktop → 串流 → 退出再往应用列表里加一条真实游戏。三个原则先跑 iPerf3 再调画质稳定性比带宽峰值更决定体验编码器拿不准就留空走出局域网前确认upnp enabled默认是disabled公网连不进来。想深入完整参数表、疑难杂症索引、采集与编码的平台实现。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
锦
锦皓数字建站
深耕本土企业品牌数字化升级,专注原创端正雅致商务官网,从视觉设计到稳定运维全程保驾护航。