
Sunshine 游戏串流部署完整指南4 步把 PC 游戏串到电视上【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine昨晚你正打到 boss 战家人却想占用书房那台台式机查资料你又不甘心放下手柄。存档在书房的电脑里人却想赖在客厅的大屏前——这种人在客厅、游戏在书房的拉扯就是 Sunshine 要解决的。Sunshine 是一个开源自托管游戏串流服务器配合 Moonlight 客户端能把你自己电脑的屏幕和声音实时推到电视、手机、平板并把你的键鼠手柄操作送回原机。打个比方Sunshine 就是一根隐形延长线——一头接在电脑的画面上另一头插到任意屏幕上线里还有一条回传通道专门把你的手柄操作送回去。接下来你要做的就是把这根线接好。它与云游戏的关键区别在于画面在你自己的电脑上编码和计算不依赖厂商服务器也不用交月费。先定验收标准串流通了才算完成动手前先明确什么叫完成。全部做完后这 4 条应该都能通过✅ 在电脑本机能打开 Sunshine 的 Web 后台并登录✅ 电视或手机上的 Moonlight 找到主机输入 PIN 配对成功✅ 客户端点Desktop能实时看到电脑桌面✅ 客户端上的手柄操作能作用到电脑画面里第 3 条通了就说明延长线的主干已接通剩下的都是调参。第一次串流的目标是通而不是美先把线接通再谈画质。准备选对系统对应的安装包最快的安装方式是用官方发布包不需要从源码编译。按你的系统选一条路径平台推荐方式关键点Windows官方 MSI 安装器自动配置防火墙规则和开机服务ARM64 为实验性Debian/Ubuntu.deb包按发行版版本和架构选对应文件一条命令装完LinuxFlatpakFlathub装完需再跑一次附加安装脚本不支持 KMS 捕获macOSDMG 或 Homebrew实验阶段手柄暂不支持Docker官方镜像官方不推荐普通用户使用需映射多组端口详见 DOCKER_README.mdWindows 用户直接跟安装向导走到底即可安装器会自动放行防火墙端口并注册服务。Debian/Ubuntu 用户下载对应.deb后执行一条命令sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.debFlatpak 用户从 Flathub 安装并额外执行一次附加安装脚本flatpak install --system flathub dev.lizardbyte.app.Sunshine flatpak run --commandadditional-install.sh dev.lizardbyte.app.SunshineLinux 上还可以把 Sunshine 注册为用户级服务随登录自动启动systemctl --user --now enable app-dev.lizardbyte.app.Sunshine优先选系统原生包沙盒与容器方案靠后。AppImage 与 Flatpak 都不支持 KMS 捕获而 KMS 是 Linux 上最稳的捕获方式。到这一步Sunshine 已经在电脑里跑起来了延长线已经拿到手接下来只管插线。执行4 步完成第一次串流安装完成后启动 SunshineWindows 会以服务形式自动运行然后按下面 4 步走顺利的话 5 分钟内就能出画面打开 Web 后台在本机浏览器访问https://localhost:47990局域网内也可把 localhost 换成电脑 IP。首次访问需要自己创建用户名和密码务必记牢浏览器提示不安全是因为自签名证书点继续即可。装 Moonlight 并添加主机在电视或手机上安装 Moonlight 客户端自动发现不到就手动添加电脑的局域网 IP。输入 PIN 配对Moonlight 会显示一个 4 位 PIN回到 Web 后台顶部导航的 PIN 入口输入这串数字并给设备起个名字配对即完成。选 Desktop 开串配对成功后客户端出现应用列表点击自带的 Desktop 条目电脑桌面立刻出现在大屏上。想串某个具体游戏就在 Applications 页面新建应用填上该游戏的启动命令和工作目录到这里延长线已经接通画面单向走操作回传走家里的任何一块屏幕都能当游戏屏。验收用两组数字验证串流质量能串不代表流畅。两组数字可以客观检验这根延长线的水准。第一组网络。实时串流的关键不是极限带宽而是稳定。主机上起一个测试服务iperf3 -s客户端设备再跑一次 60 秒 UDP 测试替换为主机 IPiperf3 -c 主机IP -t 60 -u -R -b 50M看输出的两个值丢包率理想低于 5%抖动低于 1ms。超标就先治网络换 5GHz Wi-Fi、改插网线别急着调编码参数。第二组硬件。对照仓库 README 里的要求表确认你的显卡是否达标4K 串流的要求更高一档目标显卡CPU网络常规串流Intel/AMD/NVIDIA 任一硬件编码或纯软编兜底Ryzen 3 / i3 及以上内存 4GB 起推荐 5GHz 802.11ac4K 串流NVIDIA GTX 1080 及以上Windows/ RTX 2000 系及以上Linuxi5 / Ryzen 5 及以上网线CAT5e 及以上网络稳定性比峰值带宽更重要。如果主机网卡是 2.5G 而客户端只有千兆建议把主机网卡速率降到与弱侧一致。两组数字都达标串流体验的下限就定了后面调参只是在上限上做文章。常见故障排查按症状查线路延长线第一次接通很容易在中间某处被卡住。以下 4 个症状最高频❌ Moonlight 发现不了主机线被剪断了。检查主机防火墙是否放行了47984-47990端口段Windows 安装器一般已自动配置使用独立版lite则需要手动执行发布包里的防火墙脚本。❌ 画面卡顿、丢包线被捏扁了。最典型的主机与客户端速率不匹配比如 2.5G 网卡对千兆客户端突发流量被中间设备丢弃。把主机网卡速率降到弱侧一致或升级到 0.23.1 之后的版本——新版改进了网络代码可能直接解决。❌ 键盘鼠标手柄无响应回传通道没接通。Linux/FreeBSD 下通常是当前用户不在input组执行下面命令后注销重登sudo usermod -aG input $USER❌ 忘了 Web 后台密码不用重装命令行直接重置sunshine --creds 新用户名 新密码以上都没覆盖你的情况就打开 Web 后台的Troubleshooting标签页看日志每条错误都带时间戳和上下文比盲猜高效得多另有一个高频特例手柄在 Steam 里能用、进游戏就失灵一般是 Steam 的手柄接管配置与 Sunshine 的虚拟手柄抢了第一顺位。到 Steam 设置里关掉 Xbox/PlayStation 手柄支持、只保留通用手柄即可。排查思路和查延长线一样先找到断在哪一段只修那一段别整根换线。进阶让延长线适配每一款游戏主线跑通后下面这些设置决定这台工具是否真正合你身。为每个游戏单独配置启动命令Applications 页面里每个游戏可以单独设置工作目录、启动命令与环境变量支持$(HOME)之类的变量替换。两个细节值得记住应用启动时旧实例会被先终止prep 命令失败会中止启动。如果误删了 Desktop 条目新建一个名为 Desktop、不带任何命令的应用即可找回。用搜索框调参数主题随手切Configuration 页面顶部有搜索框几十个参数不用翻菜单搜关键词直接定位导航栏的主题下拉菜单可以随时在深浅两套主题间切换两个高频快捷键CtrlAltShiftN隐藏/显示鼠标光标远程桌面用法下很实用CtrlAltShiftF1~F12串流中切换到不同显示器想系统看参数或调编码仓库里这两份文档最值得读docs/configuration.md全部配置项与 docs/performance_tuning.md编码器调优。调完这些一根通用延长线就变成了为每个游戏定做的延长线。现在开始今晚就能做的 3 件事装好与系统对应的 Sunshine 包登录后台创建账号密码在电视或手机上装 Moonlight用 PIN 配对先串通 Desktop 并对照前文的 4 条验收标准跑一次 60 秒 iperf3 测试记录丢包与抖动基线再逐步上调分辨率和码率以后游戏在书房的电脑里跑你也不必离开客厅的沙发——拿起手柄就行那根延长线早就通到了大屏上。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考