Sunshine游戏串流部署指南：5步把家里的电脑变成私人游戏云主机
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
周五晚上，你想窝在客厅沙发上用电视玩电脑里的《赛博朋克2077》，可主机和游戏都在书房；想躺床上用平板接着打，又懒得爬下床去开电脑。过去，这种念头只能想想——除非你把整台主机搬到客厅。
现在不用了。Sunshine 这个开源项目，能把你的电脑变成一台"私人游戏云主机"，让手机、平板、电视、笔记本都能随时连上来玩 PC 游戏，而游戏数据全程只在你家局域网里打转，不经过任何第三方服务器。这套 Sunshine 游戏串流搭建方案完全免费、数据私有、延迟极低，配合 Moonlight 客户端使用，5 步就能跑通。下面这份实战指南，带你从零开始把这事办成。
它和云游戏平台到底有什么不一样？
先别急着装，搞清楚定位你才知道它值不值得折腾。市面上的云游戏（比如各种"云电脑"）是把你的游戏跑在别人的服务器上，你按月付费，还得忍受排队和画质压缩。
Sunshine 的哲学刚好反过来：游戏跑在你自己的显卡上，编码压成视频流，通过局域网实时发给客户端。你的高端显卡怎么发力，串流画面就怎么呈现，性能不打折扣。
| 对比项 | 商业云游戏 | Sunshine 自建串流 |
|---|---|---|
| 游戏运行位置 | 厂商服务器 | 你自己的电脑 |
| 费用 | 订阅制 | 免费开源 |
| 数据隐私 | 经过第三方 | 局域网内直达 |
| 画质上限 | 平台限定 | 取决于你的显卡 |
| 外网访问 | 开箱即用 | 需自己配置 |
一句话总结：如果你有一台配置还不错的电脑，Sunshine 就是把这份硬件投入价值最大化的一张"提货券"。它对 AMD、Intel、NVIDIA 三家显卡都有原生硬件编码支持（NVENC、AMF、QuickSync），没有独显时也能退回 CPU 软编码，兼容性兜底。
第1步：挑一种方式把 Sunshine 装进你的系统
Sunshine 官方提供 Windows、Linux、macOS、FreeBSD 四种平台的安装包，最省事的路线是直接下载发行版安装程序，跟着向导点下一步即可。
| 你的系统 | 推荐安装方式 | 一句话点评 |
|---|---|---|
| Windows | 官方 MSI 安装包 | 新手首选，自动装好服务与防火墙规则 |
| Linux | Flatpak 或发行版 deb/rpm 包 | 与桌面环境集成最干净 |
| macOS | DMG 拖入 Applications | 首次启动记得授权屏幕录制权限 |
| 全平台 | 克隆源码自行编译 | 适合想定制或二次开发的玩家 |
想从源码走一遍流程也很简单，克隆官方仓库后按docs/building.md的说明配置依赖即可：
git clone https://gitcode.com/GitHub_Trending/su/Sunshine提示：Linux 用户如果桌面环境较新，优先选发行版对应的 deb/rpm 包，而不是 AppImage 或 Flatpak——后两者不支持 KMS 直通采集，部分高级功能用不了。
装好后，在终端执行sunshine（Windows 安装包会注册为后台服务，无需手动启动），然后打开浏览器访问http://localhost:47990。
第2步：花两分钟完成首次登录与配对
第一次打开管理页面，你会看到欢迎界面。这一步要做的事只有一件：设置一个用户名和密码。默认用户名是sunshine，密码务必换成只有你知道的组合——它不仅是管理面板的钥匙，也参与后续客户端配对校验。
注意：浏览器可能会提示"证书不受信任"，这是正常现象。Sunshine 默认使用自签名证书做 HTTPS 加密，点击"继续访问"即可，不用担心安全问题。
登录之后，管理面板的导航栏会依次出现 PIN、Applications、Configuration、Troubleshooting 等入口。此刻你还不需要细看每一项，先把客户端连上再说：
- 在手机或电脑上安装Moonlight 客户端（官方"精选应用"页面有各平台下载入口）；
- 打开 Moonlight，它会自动扫描局域网，认出你的 Sunshine 主机（认不出就手动填电脑的局域网 IP）；
- Moonlight 会弹出一串 4 位 PIN 码，回到 Sunshine 管理页面的PIN标签页，输入这串码并给设备起个名字；
- 点击确认后，客户端里就会列出 Sunshine 里的"应用"，选一个点开，画面就来了。
从安装到出画面，熟练的话全程不到 5 分钟。这就是"快速成功"的体验——先别管那些眼花缭乱的参数，跑通链路最重要。
第3步：用一张流程图理解"串流"到底在干什么
在动手调优之前，先建立正确的心理模型。你不需要成为编码专家，但知道数据走了哪几站，排查问题时就能少走一半弯路：
游戏画面 → 显卡采集 → 硬件编码器压缩 → 网络传输 → 客户端解码 → 屏幕显示 ↑ ↓ 手柄/键盘输入 ←──────────────────── 输入回传- 采集：Sunshine 从显卡输出里抓取画面帧；
- 编码：用 NVENC/AMF/QuickSync 把原始画面压成 H.264、HEVC 或 AV1 视频流；
- 传输：通过 RTSP 协议走局域网发给客户端；
- 解码：Moonlight 客户端解压视频流并渲染到屏幕；
- 输入回传：你的按键和手柄操作以近乎实时的速度传回主机，形成闭环。
记住这条链路，后面所有优化都围绕其中一环展开：延迟高先查网络，画质糊先看码率，卡顿先看编码器，断连先看端口。按图索骥，问题一抓一个准。
第4步：破解三个 90% 新手都会踩的配置误区
跑通之后，很多人会一头扎进配置页开始乱调。我的建议是：先理解下面三个最常见的误区，再动手。
误区一：分辨率开得越高越好？
真相：码率跟不上，高分辨率只会更糊。画面的清晰度由"分辨率 × 码率"共同决定。你在 4K 电视上串流 1080p 画面，如果码率只有 5 Mbps，边缘全是马赛克；反过来，码率给够，720p 也能锐利得吓人。参考这组起步值，再根据自己的网络实测调整：
| 客户端设备 | 起步分辨率 | 起步码率 | 适用网络 |
|---|---|---|---|
| 手机/平板 | 1080p | 10–20 Mbps | 稳定的 5GHz WiFi |
| 笔记本 | 1080p–1440p | 20–40 Mbps | 有线或高质量 WiFi |
| 电视/大屏 | 1440p–4K | 40–80 Mbps | 千兆有线优先 |
误区二：有独显就一定能硬件编码？
真相：驱动和编码器缺一不可。在管理面板的 Configuration 里搜索"encoder"，可以看到 Sunshine 当前检测到的编码器列表。NVIDIA 显卡需要较新的驱动支持 NVENC，AMD 需要装好 AMF 运行时，Intel 核显则需要对应媒体驱动。如果列表里是空的，去 TroubleShooting 日志页翻一下，多半能看到类似 "Encoder not found" 的报错，按提示补驱动即可。
误区三：启用 UPnP 就能随时随地远程串流？
真相：UPnP 只负责自动做端口转发，外网访问还需要更多配置。在配置页搜索"UPnP"并开启后，路由器会自动为你开放端口，方便你在外网连回家里的主机。但这只是第一步——外网串流还涉及动态 IP、加密模式、带宽上行等一堆变量，建议先在局域网内把体验调到满意，再研究远程方案。
小技巧：配置页自带搜索框，想改任何参数直接搜关键词，比逐项翻找高效得多。改完记得点右下角的 Save。
第5步：把常用游戏和应用都请进"应用管理"
管理面板的 Applications 页面，就是你的"游戏启动器"。默认只有 Desktop 和 Steam 两个应用，你可以把任意游戏、模拟器甚至生产力软件加进来，每个应用都能配置独立的启动命令和工作目录。
几个实用配置思路：
- 直接串流整个桌面：什么都不用配，选 Desktop 即可，适合办公、看视频这类场景；
- Steam 大屏模式：给 Steam 单独建一个应用，用
steam -bigpicture作为启动命令，客厅体验拉满； - 自定义游戏：以
cmd方式运行启动器，或用detached方式让游戏独立于流会话运行，适合需要热切换的场景； - 环境变量：支持
$(HOME)这类占位符和自定义 env，灵活性相当高。
注意：同时只能有一个应用在跑——新应用启动时，正在运行的旧应用会被自动结束，这是设计如此，不是 bug。
进阶玩法：手柄、HDR 与延迟调优三板斧
基础链路稳了，接下来就是"把体验再往上顶一档"的时间。
手柄支持：一份主机，全平台手柄通吃
Sunshine 在 Windows 上通过 ViGEmBus 驱动模拟虚拟手柄，在 Linux 上通过 inputtino 实现，支持 Xbox 360/One/Series、DualShock 4、DualSense、Switch Pro 等多种协议。Windows 用户如果发现手柄没反应，多半是 ViGEmBus 没装——进 Troubleshooting 页面，一键安装即可。
HDR 串流：把高动态范围也搬到大屏上
Sunshine 在 Windows 上官方支持 HDR 串流，Linux 上为实验性支持。想点亮 HDR，前提是主机系统已开启 HDR（可能需要支持 HDR 的显示器或 HDMI 诱骗器），且客户端 Moonlight 里也打开了 HDR 开关。两端都就绪，电影级的光影对比度就能原汁原味地传过去。
延迟调优：三招把输入延迟压到感知不到
- 网络优先：主机端务必有线连接，客户端能插网线就插网线，实在不行用 5GHz WiFi；
- 编码档位：在 Configuration 里搜索
nvenc_preset（NVIDIA）或对应的编码预设，从"质量"切到"性能"，延迟立降； - 开启低延迟模式：Moonlight 客户端里的低延迟选项配合 Sunshine 的
fec_percentage等参数微调，能进一步挤压延迟水分。
踩坑实录：三个高频问题与解决思路
把社区里出现频率最高的几个问题汇总成表，遇到直接对照处理：
| 症状 | 大概率原因 | 解决思路 |
|---|---|---|
| 客户端搜不到主机 | 防火墙挡了端口 / 不在同一网段 | 放行 47989–48010 端口段，确认设备在同一局域网 |
| 画面频繁卡顿 | 码率超出网络能力 / 编码器异常 | 降码率，检查 Troubleshooting 日志里的编码器报错 |
| 手柄没反应 | 缺虚拟手柄驱动 / 权限不足 | Windows 装 ViGEmBus；Linux 确认用户加入input组 |
遇到说不清的问题，直接打开管理面板的 Troubleshooting 日志页。这里记录了 Sunshine 运行期间的完整警告与错误，按时间戳逐条翻，问题基本无处遁形。
提示：日志文件本身也存在磁盘上——Windows 在安装目录的 config 文件夹，Linux/macOS 在
~/.config/sunshine/，必要时可以拷出来分析或反馈给社区。
收尾：一张行动清单，开启你的家庭串流时代
到这里，Sunshine 的安装、配对、调优、排障全链路你都已经走了一遍。剩下的就是动手实践了。给你一张可以直接照做的行动清单：
- 今晚就装：按第 1 步选一种方式安装，跑通配对出画面；
- 明晚调优：按第 4 步的表格设置分辨率与码率，实测对比画质；
- 周末进阶：把手柄、HDR、低延迟三板斧逐个点亮；
- 长期探索：多设备家庭共享、外网远程串流、甚至给每台设备分配独立 PIN 权限。
想深入研究的，仓库里还有不少宝藏：完整的配置项文档在 docs/configuration.md，应用配置说明在 docs/getting_started.md，编码器实现细节在 src/nvenc/，排障手册在 docs/troubleshooting.md。
最后说句掏心窝的话：Sunshine 最大的魅力不在于"技术多炫"，而在于它把"游戏在哪里玩"的选择权还给了你。周末下午，躺在客厅沙发上，用手机连上书房的主机，窗外阳光正好——这种自由，值得花一个晚上去搭建。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
 amide (des-acetyl-α-MSH))
