Sunshine 游戏串流服务器 5 分钟从零跑通：免费自托管完整搭建指南
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
书房的性能怪兽一周开不了两天，客厅 75 寸电视却只能刷剧。把 PC 游戏搬上电视，其实不必抱主机，也不必再掏几千块买游戏机：Sunshine是开源免费的自托管游戏串流服务器，把画面经局域网实时推到电视、平板、手机，你的按键和手柄操作再原路传回去——装好它，全家共用一台游戏中枢。
把电脑变成"家庭游戏中枢"：Sunshine 到底省你什么
理解 Sunshine 最简单的方式，是把它当成一根超长的"隐形 HDMI 线"：一头插在你的 PC 上，另一头能插到家里任何一块屏幕，而且这根线走的是你家的路由器，除了传画面，连你的按键都反着送回去。和云游戏最大的差别在于——算力始终花在你自己的硬件上，不排队进厂商机房，也没有月费。
| 需求 | 传统做法 | 装上 Sunshine 之后 |
|---|---|---|
| 想在客厅玩 PC 游戏 | 抱主机、拖 HDMI 线、切信号源 | 电视装个客户端，三步进画面 |
| 躺床上接档一局 | 爬回书房坐下 | 手机、平板随时接管进度 |
| 两个人同时用这台 PC | 抢屏、排队、等人 | 各连各的屏幕互不干扰 |
| 角落里那台无头主机 | 塞假负载或接显示器才能点亮 | 一条 SSH 命令远程拉起 |
一句话总结：不重复买硬件、不交订阅费，Sunshine 只是把你已经拥有的性能接到更多屏幕上。
它支持 AMD、Intel、NVIDIA 三家显卡的硬件编码，纯软件编码兜底也有。✅ 适合你，如果命中下面任意两条：
- ✅ 有一台带独显（或能打的核显）的 PC，不想为客厅再花几千块
- ✅ 家里是千兆有线，或客厅能被 5GHz WiFi 覆盖
- ✅ 经常要在 PC、电视、手机、平板之间切换屏幕，且愿意花半小时折腾一个免费方案
Sunshine 安装教程：Windows、Linux、macOS 三条最短路径
按系统挑安装包，5 分钟出登录界面。官方发布页对每个系统都有现成构建，不必从源码编译：
- Windows（推荐）：下载 AMD64 版
.msi，运行安装向导。向导会逐项询问是否添加防火墙规则、创建后台服务，按需求勾选即可，别全默认。 - Debian / Ubuntu：下载对应
.deb后安装，并让服务随开机自启：
sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.deb systemctl --user --now enable app-dev.lizardbyte.app.Sunshine- Flatpak：
flatpak install flathub dev.lizardbyte.app.Sunshine。沙盒依赖完整，但不支持 KMS 抓取；发行版有原生包时优先用原生包。 - macOS：
.dmg拖进 Applications，或用 Homebrew 安装。⚠️ macOS 版属实验阶段，暂不支持手柄。 - Docker：只建议进阶用户，需同时映射 TCP
47984-47990、UDP47998-48000与48010，详见 DOCKER_README.md。
首次登录：给后台设一把钥匙。启动后浏览器打开https://localhost:47990（localhost可换成 PC 的内网 IP）。浏览器提示"连接不安全"是正常的——Sunshine 用的是自签名证书，点继续访问即可，串流通道本身加密。首次进入要创建用户名和密码，这是进管理后台的唯一凭证，务必抄下来。
配对 Moonlight 客户端：
- 在电视/手机/平板上装Moonlight客户端，官方验证过的客户端清单都挂在后台 Featured Apps 页
- 手动添加主机，填 PC 的内网 IP
- 客户端显示 4 位 PIN，回到 Sunshine 后台点导航栏 PIN，输入并给设备命名
- 配对成功，客户端里直接出现应用列表
三步走完，你的电脑就变成一台 24 小时待命的游戏服务器。完整流程参考 docs/getting_started.md。
Sunshine 串流参数怎么配：客厅 4K、手机低延迟、无头主机 3 个场景
加游戏的入口在后台Applications页：点 "Add New" 填启动命令、工作目录即可。Sunshine 自带 "Desktop"（无命令、直接串桌面）和 "Steam Big Picture" 两个入口，开箱就能用。
场景一：电视大屏，画质优先
- 推荐配置：4K + 60fps + 高码率；编码按卡选——NVIDIA 走 NVENC，Windows 上 AMD 走 AMF，Linux 用 VAAPI 或 Vulkan
- 前提条件：主机与电视同网段，千兆有线优先，能插网线就别用 WiFi
- 预期效果：画面接近直连显示器，手柄操作几乎无感延迟
场景二：手机平板，稳定优先
移动端的关键词是用码率换稳定，码率拉满只会让弱信号下的丢包更惨。
- 推荐配置：1080p + 60fps + 中等码率，预设切性能优先
- 前提条件：连 5GHz WiFi，尽量待在路由器覆盖范围内；实测可用 iperf3（主机
iperf3 -s，客户端iperf3 -c 主机IP -t 60 -u -R -b 50M），丢包低于 5%、抖动低于 1ms 再谈画质 - 预期效果：画面偶有压缩痕迹，但操作跟手、不掉帧，比云游戏稳得多
场景三：无头主机，SSH 一条命令点亮
角落里那台没接显示器的旧台式机，是天然的专用串流机：
ssh user@主机IP 'export DISPLAY=:0; sunshine'只有纯文本终端时，先startx再启动，中间加个sleep给 X server 留就绪时间。
顺手记两个快捷键（都以Ctrl+Alt+Shift开头）：N隐藏/显示鼠标光标；F1~F12多显示器下切换串哪块屏。另有两个坑值得提前知道：新应用启动时同名旧实例会被先终止；prep 命令失败会直接中止启动。更多现成例子见 docs/app_examples.md。
Sunshine 串流连不上、掉帧、手柄失灵：5 个高频症状逐条解
按"症状 → 原因 → 解法"整理，多数 10 分钟内解决。
症状 1：客户端发现不了主机，或后台打不开原因：防火墙没放行，或两端不在同一网段。解法：确认主机放通 TCP47984-47990与 UDP47998-48000；Windows 手动部署的可用 add-firewall-rule.bat 补规则。
症状 2：画面卡顿、大量丢包原因：Sunshine 每 16ms 突发推一帧流，主机网卡远快于客户端时（如 2.5G 对千兆），中间设备缓冲溢出直接丢数据。解法：把主机网卡速率降到与弱侧一致；或直接升级到 0.23.1 之后版本，网络层已有优化，很多机器升级后直接痊愈。
症状 3：手柄在 Steam 里正常、进游戏失灵原因：Steam 的手柄接管配置抢占了 Sunshine 的虚拟手柄。解法：Steam 控制器设置里关掉 Xbox/PlayStation 支持，只留通用控制器，让 Sunshine 提供的手柄排"第一顺位"。
症状 4：键鼠手柄全无反应（Linux）原因：当前用户不在input组，无权创建虚拟输入设备。解法：
sudo usermod -aG input $USER注销重登生效。
症状 5：忘了 Web 后台密码不用重装，命令行直接重置：
sunshine --creds 新用户名 新密码以上都没命中，就进后台Troubleshooting页翻日志——每条错误带时间戳、可按级别筛选，比盲猜高效得多。
每项的展开分析在 docs/troubleshooting.md。
今晚就能跑通的 3 件小事
- 花 5 分钟装好 Sunshine，打开
https://localhost:47990完成首次登录，把账号密码抄进备忘录 - 电视装 Moonlight，PIN 配对，先串一把 "Desktop"，确认画面与延迟手感
- 从 1080p 中码率起步，逐级加到 4K；参数拿不准就用后台配置搜索框逐条查，细节读 docs/configuration.md 与 docs/performance_tuning.md
你家最强那台游戏机其实一直开着机，只是接错了屏幕。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
