Sunshine 游戏串流服务器从装机到 Moonlight 配对的四道关口【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine把一台闲置的 Windows 游戏机变成局域网里的自托管游戏串流服务器Sunshine 就是干这个的——它在本机抓取屏幕画面、走 GPU 硬编码再通过 Moonlight 客户端实时推到电视、平板和手机。游戏始终跑在你自己的显卡上不收订阅费延迟取决于你自己的网络。从安装到电视出画整条路就四道关口服务起来、后台进得去、设备配得上、网络扛得住。这篇按关口拆每个关口都给出自检办法。先判断这玩意适不适合你你的机器/需求结论有一台带独立显卡、性能有富余的台式机不想再买游戏主机值得搭想让电视或平板变成第二块游戏屏值得搭受够了云游戏按月扣费愿意自己维护一台串流主机值得搭只有一台轻薄本显卡常年高负载先别搭编码会吃掉游戏帧数Sunshine 只负责抓屏 编码 推流真正在电视、平板、手机上播放的是 Moonlight 客户端。两者是固定搭档Sunshine 端没有 Moonlight 端就等于白装。安装 Sunshine 游戏串流服务器Windows官方安装包一把梭下载对应架构的官方安装包Intel/AMD 选 AMD64 版装的过程中勾选防火墙规则和开机自启服务两项安装器会顺手把这两件事办了不用回头再折腾。装完去设置 → 应用里能看到 Sunshine 即为成功安装日志默认写在系统临时目录下的Sunshine/logs/install/中途报错了翻这里比猜快。Debian/Ubuntu一条 dpkg 命令sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.deb我装 Linux 主机时选.deb而不是 Flatpak.deb直接落在系统里systemd 服务随开机自启SSH 远程场景最省事Flatpak 虽然沙箱干净但不支持 KMS 捕获无头主机上排查起来更绕。自检systemctl status sunshine输出里看到active (running)就说明串流服务在跑没看到 active 的话服务没拉起来直接看日志journalctl -u sunshine第一次进 Web 后台把账号立起来浏览器打开https://localhost:47990首次访问会让你创建用户名和密码——当场记下来忘了虽然能救后面排障一节有救法但没必要给自己加戏。浏览器弹连接不安全是正常现象自签名证书而已放行后数据仍走加密通道。自检页面能刷出导航栏Home、PIN、Applications、Configuration 等标签都在说明 Web 服务活着。白屏或连接被拒绝多半是 47990 端口没放行。应用管理先串桌面再串游戏进 Applications 页默认就带着 Desktop 和 Steam 两个入口直接可用。想串具体游戏点 Add New 填启动命令。我的顺序是先用 Desktop 出画别急着串游戏桌面流没有任何启动命令和环境变量依赖能单独验证捕获 → 编码 → 推送这条链路。链路通了再逐个加游戏出问题时你能立刻分清是 Sunshine 的问题还是游戏启动命令的问题。自检新建条目出现在应用列表里就算配好。注意启动命令路径填错时这里不会报错要等点串流那一刻才卡住——所以命令尽量从终端复制别手敲。配对 Moonlight 客户端电视出画在电视或手机上装 Moonlight选手动添加主机填 Sunshine 主机的内网 IP。连接请求建立后Moonlight 会显示一个 4 位 PIN 码。回 Sunshine 后台点导航栏的PIN把这 4 位数字输进去给设备起个名字配对完成。回 Moonlight 里点 Desktop电视应当很快出桌面画面。自检出画后在 5GHz WiFi 上跑 1080p/60fps 最稳——移动端的带宽波动比有线大先保帧率再谈画质网络富余了再上 4K。没出画的话先确认两端放行了47984–47990这段 TCP 端口发现不了服务器基本都卡在这。出画前跑一遍网络基线画质调参之前先给链路做个体检。串流对网络的敏感点不是带宽是稳定性低延迟、低抖动、近乎零丢包。用iperf3测主机端开服务iperf3 -s客户端跑 60 秒反向 UDP 测试50Mbps 示例iperf3 -c {主机IP} -t 60 -u -R -b 50M看客户端输出的丢包率和抖动两项丢包压到 5% 以下、抖动 1ms 以内这条线是后面所有画质调参的前提不达标时去动码率只会更卡。串流数据走 47984–47990 端口段如果客户端还要跨公网接入路由器上记得把 5201 端口的 TCP/UDP 也放行。更多网络细节在 troubleshooting 文档 的 Network performance test 一节。六个高频故障按这个顺序查1. Moonlight 发现不了主机。第一反应往往是重装 Sunshine但九成情况凶手是防火墙。确认 47984–47990 这段 TCP 在主机防火墙上放行Windows 手动安装的场景仓库里 Windows 打包目录自带一键放行脚本见 add-firewall-rule.bat。2. Linux 下键盘、鼠标、手柄没反应。先别查手柄驱动跑一下groups看当前用户是否在input组不在就是权限问题sudo usermod -aG input $USER注销再登录生效。3. 卡顿、偶发黑屏。我第一反应也是拉码率但真正的原因常是链路两端速率差太多——主机 2.5G 网口对客户端千兆或 WiFi缓冲区溢出直接丢包。解法是把主机网卡限速到与最慢环节一致或升级网络设备个别电视在低 MTU如 1428下反而不丢包属于末位手段实在没别的招再试。4. 忘记后台密码。不用重装也不用删配置。终端里直接跑sunshine --creds 新用户名 新密码细节见 troubleshooting 文档 的 Forgotten Credentials 一节。5. 无显示器主机要远程拉起。SSH 进去直接跑 sunshine没有图形环境必挂。先起 X server 再启动中间加个 sleep 等画面就绪ssh 用户主机IP startx ; sleep 5; export DISPLAY:0; sunshine更稳的做法是把DISPLAY写进~/.bashrc或~/.bash_profile远程拉起就不用每次手敲。6. 排查前先看后台日志。Troubleshooting 标签页带完整时间戳日志每条 warning/error 都标着发生时刻先扫一眼再动手省掉一半盲猜。最后一张可执行的验收清单按顺序走每步有明确的成功信号别跳步——跳步等于把问题留到后面再排查一遍systemctl status sunshine显示active (running)https://localhost:47990能登录账号密码已记录Moonlight 配对成功电视出桌面画面iperf3丢包 5%、抖动 1ms以上全过再回去动码率、分辨率这些画质参数。参数项太多找不到入口时configuration 文档 列了全部字段后台 Configuration 页顶部也有搜索框直接搜关键词最快。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Sunshine 游戏串流服务器：从装机到 Moonlight 配对的四道关口
Sunshine 游戏串流服务器从装机到 Moonlight 配对的四道关口【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine把一台闲置的 Windows 游戏机变成局域网里的自托管游戏串流服务器Sunshine 就是干这个的——它在本机抓取屏幕画面、走 GPU 硬编码再通过 Moonlight 客户端实时推到电视、平板和手机。游戏始终跑在你自己的显卡上不收订阅费延迟取决于你自己的网络。从安装到电视出画整条路就四道关口服务起来、后台进得去、设备配得上、网络扛得住。这篇按关口拆每个关口都给出自检办法。先判断这玩意适不适合你你的机器/需求结论有一台带独立显卡、性能有富余的台式机不想再买游戏主机值得搭想让电视或平板变成第二块游戏屏值得搭受够了云游戏按月扣费愿意自己维护一台串流主机值得搭只有一台轻薄本显卡常年高负载先别搭编码会吃掉游戏帧数Sunshine 只负责抓屏 编码 推流真正在电视、平板、手机上播放的是 Moonlight 客户端。两者是固定搭档Sunshine 端没有 Moonlight 端就等于白装。安装 Sunshine 游戏串流服务器Windows官方安装包一把梭下载对应架构的官方安装包Intel/AMD 选 AMD64 版装的过程中勾选防火墙规则和开机自启服务两项安装器会顺手把这两件事办了不用回头再折腾。装完去设置 → 应用里能看到 Sunshine 即为成功安装日志默认写在系统临时目录下的Sunshine/logs/install/中途报错了翻这里比猜快。Debian/Ubuntu一条 dpkg 命令sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.deb我装 Linux 主机时选.deb而不是 Flatpak.deb直接落在系统里systemd 服务随开机自启SSH 远程场景最省事Flatpak 虽然沙箱干净但不支持 KMS 捕获无头主机上排查起来更绕。自检systemctl status sunshine输出里看到active (running)就说明串流服务在跑没看到 active 的话服务没拉起来直接看日志journalctl -u sunshine第一次进 Web 后台把账号立起来浏览器打开https://localhost:47990首次访问会让你创建用户名和密码——当场记下来忘了虽然能救后面排障一节有救法但没必要给自己加戏。浏览器弹连接不安全是正常现象自签名证书而已放行后数据仍走加密通道。自检页面能刷出导航栏Home、PIN、Applications、Configuration 等标签都在说明 Web 服务活着。白屏或连接被拒绝多半是 47990 端口没放行。应用管理先串桌面再串游戏进 Applications 页默认就带着 Desktop 和 Steam 两个入口直接可用。想串具体游戏点 Add New 填启动命令。我的顺序是先用 Desktop 出画别急着串游戏桌面流没有任何启动命令和环境变量依赖能单独验证捕获 → 编码 → 推送这条链路。链路通了再逐个加游戏出问题时你能立刻分清是 Sunshine 的问题还是游戏启动命令的问题。自检新建条目出现在应用列表里就算配好。注意启动命令路径填错时这里不会报错要等点串流那一刻才卡住——所以命令尽量从终端复制别手敲。配对 Moonlight 客户端电视出画在电视或手机上装 Moonlight选手动添加主机填 Sunshine 主机的内网 IP。连接请求建立后Moonlight 会显示一个 4 位 PIN 码。回 Sunshine 后台点导航栏的PIN把这 4 位数字输进去给设备起个名字配对完成。回 Moonlight 里点 Desktop电视应当很快出桌面画面。自检出画后在 5GHz WiFi 上跑 1080p/60fps 最稳——移动端的带宽波动比有线大先保帧率再谈画质网络富余了再上 4K。没出画的话先确认两端放行了47984–47990这段 TCP 端口发现不了服务器基本都卡在这。出画前跑一遍网络基线画质调参之前先给链路做个体检。串流对网络的敏感点不是带宽是稳定性低延迟、低抖动、近乎零丢包。用iperf3测主机端开服务iperf3 -s客户端跑 60 秒反向 UDP 测试50Mbps 示例iperf3 -c {主机IP} -t 60 -u -R -b 50M看客户端输出的丢包率和抖动两项丢包压到 5% 以下、抖动 1ms 以内这条线是后面所有画质调参的前提不达标时去动码率只会更卡。串流数据走 47984–47990 端口段如果客户端还要跨公网接入路由器上记得把 5201 端口的 TCP/UDP 也放行。更多网络细节在 troubleshooting 文档 的 Network performance test 一节。六个高频故障按这个顺序查1. Moonlight 发现不了主机。第一反应往往是重装 Sunshine但九成情况凶手是防火墙。确认 47984–47990 这段 TCP 在主机防火墙上放行Windows 手动安装的场景仓库里 Windows 打包目录自带一键放行脚本见 add-firewall-rule.bat。2. Linux 下键盘、鼠标、手柄没反应。先别查手柄驱动跑一下groups看当前用户是否在input组不在就是权限问题sudo usermod -aG input $USER注销再登录生效。3. 卡顿、偶发黑屏。我第一反应也是拉码率但真正的原因常是链路两端速率差太多——主机 2.5G 网口对客户端千兆或 WiFi缓冲区溢出直接丢包。解法是把主机网卡限速到与最慢环节一致或升级网络设备个别电视在低 MTU如 1428下反而不丢包属于末位手段实在没别的招再试。4. 忘记后台密码。不用重装也不用删配置。终端里直接跑sunshine --creds 新用户名 新密码细节见 troubleshooting 文档 的 Forgotten Credentials 一节。5. 无显示器主机要远程拉起。SSH 进去直接跑 sunshine没有图形环境必挂。先起 X server 再启动中间加个 sleep 等画面就绪ssh 用户主机IP startx ; sleep 5; export DISPLAY:0; sunshine更稳的做法是把DISPLAY写进~/.bashrc或~/.bash_profile远程拉起就不用每次手敲。6. 排查前先看后台日志。Troubleshooting 标签页带完整时间戳日志每条 warning/error 都标着发生时刻先扫一眼再动手省掉一半盲猜。最后一张可执行的验收清单按顺序走每步有明确的成功信号别跳步——跳步等于把问题留到后面再排查一遍systemctl status sunshine显示active (running)https://localhost:47990能登录账号密码已记录Moonlight 配对成功电视出桌面画面iperf3丢包 5%、抖动 1ms以上全过再回去动码率、分辨率这些画质参数。参数项太多找不到入口时configuration 文档 列了全部字段后台 Configuration 页顶部也有搜索框直接搜关键词最快。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考