从装好到串出第一帧Sunshine 游戏串流实操手册【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款自托管的游戏串流服务端和 Moonlight 客户端搭配在你自己的主机上完成屏幕采集与硬件编码把画面送进局域网里的另一块屏幕。它开源、无订阅、数据不出家门NVIDIA、AMD、Intel 各有硬件编码通路没有独显也能用 CPU 软编码兜底。读完这篇你能独立装好主机端、完成客户端配对、加上第一个游戏并调准关键参数。一台主机变串流服务器Sunshine 凭什么把游戏 PC 塞在桌下屏幕却想在另一间屋子看——搬机器太重再买显示器太贵拉 HDMI 又碍事。Sunshine 的思路是把这台 PC 直接变成串流服务器画面在主机上采集、编码走局域网送到装了 Moonlight 的设备上线一根不用接。和上云游戏最大的差别是机房在你家客厅带宽自己说了算。场景传统做法用 Sunshine换台设备看搬主机、重插线新设备装个 Moonlight 配对即可加一块屏买显示器加布线装客户端、配对、选应用费用硬件投入或云端订阅开源免费自托管主机端支持 Windows、Linux、macOS实验性暂不支持手柄模拟、FreeBSD客户端跟着 Moonlight 走手机、平板、盒子、电视都能连。编码上 NVENC、QuickSync、AMF、VAAPI、Vulkan Video、VideoToolbox 各有通路外加 CPU 软编码兜底默认自动挑第一个可用的采集上 Windows 走桌面复制 APILinux 可选 NvFBC、KMS、X11、Wayland、KWin、Portal 后端macOS 走系统屏幕录制。所有配置都在浏览器 Web UI 里完成不用碰命令行。安装 Sunshine 并启动服务先按平台装好主机端。Windows 到 Release 页面下Sunshine-Windows-AMD64-installer.msi双击安装按提示勾选组件防火墙规则由安装器写好、服务开机自启Linux 有对应发行版包就优先用它deb、copr、pacmanAppImage 和 Flatpak 都不支持 KMS 采集macOS 把 DMG 里的Sunshine.app拖进 Applications 即可。装 Flatpak 版要补跑一次输入依赖安装否则键鼠手柄可能失效Linux 上接着启动串流服务下面两条命令分别对应这两个平台动作# Flatpak 版补装输入依赖非 Flatpak 可跳过 flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine # Linux 启动串流服务 systemctl --user start app-dev.lizardbyte.app.Sunshine✅ 成功标志命令无报错返回后浏览器访问https://localhost:47990能看到页面。Windows 和 macOS 装完直接开程序就行不用敲服务命令。打开 Web UI完成 Moonlight 首次配对浏览器访问https://localhost:47990提示不安全属正常自签名证书导致忽略即可。首次进入会让你设置管理员用户名和密码这套凭据后面配对全靠记好。回客户端设备打开 Moonlight它会自动发现局域网里的 Sunshine发现不了就在 Moonlight 里手动填主机 IP 添加。首次连接时 Moonlight 弹出一个四位 PIN 码回 Web UI 顶部导航的 PIN 页输入 PIN、给设备起个名字看到成功提示就算跑通。此时 Moonlight 里能列出主机和它自带的 Desktop 应用点进去就能串出整块桌面——这是不启动任何程序、直接看主机画面的模式。添加第一个游戏调准三个关键参数配对通了只够串桌面。想串具体游戏进 Applications 页新建一条填应用路径、工作目录、启动参数支持$(HOME)这类环境变量。⚠️ 三条容易踩的坑直接拉steam这类会立即退出的进程要用detached启动否则串流马上断Flatpak 主机应用命令要加flatpak-spawn --host前缀否则沙箱里找不到宿主程序新串流会终止上一个应用一次只有一个。调参走配置页顶部搜索框敲关键词直达。重点盯三个参数max_bitrateKbps默认0表示完全采用 Moonlight 端请求的码率想给主机端封顶带宽时设成如5000。encoder默认自动选第一个可用编码器想锁通路时手动填nvenc、quicksync、amdvce、vaapi、vulkan或software。nvenc_preset1 最快到 7 压缩率最高默认1只有网络或解码端顶不住时才往大调否则提高码率更划算。连不上、卡顿、没声音的排查路径Web UI 打不开47990 访问不了大概率是防火墙拦了端口先确认 Windows 安装时防火墙规则已写入不行就临时关防火墙验证一次通了再回头放行 47990。发现不了主机大概率是两台设备不同网段或服务没在跑Linux 上敲systemctl --user status app-dev.lizardbyte.app.Sunshine看状态确认服务在运行、网络同段再重启服务和路由器。串流卡顿、掉帧先怀疑网络而不是 Sunshine。用 iPerf3 做一次 60 秒 UDP 反向测试主机端起服务端、客户端发起看输出里的丢包和抖动理想是丢包低于 5%、抖动低于 1ms# 主机端 iperf3 -s # 客户端侧 iperf3 -c {主机IP} -t 60 -u -R -b 50M丢包高时主机 2.5G 网卡 客户端 WiFi这种两头速度不匹配是典型诱因降一档网卡速率或把主机改有线通常立竿见影。忘了管理员密码不用重装直接sunshine --creds {新用户名} {新密码}重置尖括号内容替换成你的。还搞不定就翻日志Web UI 的 Troubleshooting 页内置日志和告警提示文件位置——Windows 在%ProgramFiles%\Sunshine\config\sunshine.logLinux / macOS / FreeBSD 在~/.config/sunshine/sunshine.logDocker 用docker logs sunshine。记住这几句就够网络稳定性比带宽峰值更决定体验先跑一次 iPerf3 再谈画质。编码器拿不准就留空自动选择足够聪明手动指定是排障手段不是日常操作。max_bitrate为 0 表示码率听 Moonlight 的想封顶带宽才碰它。远程串流前把upnp设为enabled默认disabled否则公网连不进来。串流前确认两台设备同网段、服务在跑大部分连不上都出在这一步。现在就打开第二台设备装好 Moonlight回 Web UI 配一次对、给应用列表加一条真实游戏把配对 → 启动 → 串流 → 退出完整走一遍。完整参数表见 docs/configuration.md疑难索引在 docs/troubleshooting.md想看采集与编码怎么实现的翻 src/platform/ 目录。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考