Sunshine 游戏串流三步搭建指南：把高性能 PC 变成全家可用的家庭游戏服务器
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
晚上十点，客厅电视被家人占着，你却在书房电脑前刚打完一局《博德之门 3》的 Boss 战，正卡在最上头的时候——而 Sunshine 这样的自托管游戏串流服务端，正是为这种时刻准备的。它专为 Moonlight 客户端设计，支持 AMD、Intel、NVIDIA 显卡硬件编码与纯软件编码，覆盖 Windows、Linux、macOS 与 FreeBSD。装上它，你的高性能 PC 就变成一台家庭游戏服务器，电视、平板、手机都能以低延迟接入你的游戏库。
下面这篇文章会沿着一条真实的玩家旅程展开：从纠结选型，到装好跑通第一场串流，再到踩坑、调优、让全家一起用。你跟着走完这几站，今晚就能把客厅变成游戏房的延伸。
第一站：选型纠结——Steam Link 与云串流都试过之后，为什么最终选了自托管 Sunshine
先说清楚一个容易混淆的点：Sunshine 只负责"服务端"，也就是把 PC 的画面、声音和操作收进来再推出去；负责"接收端"的是 Moonlight 客户端，你可以在手机、平板、电视盒、笔记本上装它。两者是一对黄金搭档。
在决定自建之前，大多数人和你一样会先试这几条路，然后发现问题：
| 方案 | 典型痛点 |
|---|---|
| Steam Link | 免费但闭源，只能串流 Steam 库内游戏，非 Steam 游戏和桌面应用支持受限 |
| 云游戏平台 | 要月费、游戏库由平台定，网络一抖就糊，热门大作常常"想玩的不在库里" |
| NVIDIA GameStream | 曾经好用，但官方已经停止服务，N 卡老用户被迫找替代品 |
| 自托管 Sunshine | 完全开源、装在自己机器上，不依赖任何厂商服务器，游戏库想加什么加什么 |
如果你已经有一台配置还过得去的游戏 PC，自托管几乎是零边际成本的选择：不花钱、数据不出家门、断外网也能在局域网里玩。而 Sunshine 能成为主流方案，靠的是三点硬实力——三家显卡的硬件编码全支持（N 卡 NVENC、A 卡 AMF、Intel 核显 QuickSync，还有兜底的软件编码）、配置自由度极高（从编码参数到启动命令都能改）、配套的 Moonlight 客户端生态非常成熟（桌面、移动、嵌入式设备都有）。
第二站：安装首跑——Windows、Linux、macOS 三种安装路径怎么选，别踩的坑
Sunshine 的安装方式很多，别一上来就头大，按你的系统对号入座即可：
| 操作系统 | 推荐方式 | 一句话说明 |
|---|---|---|
| Windows | 官方.msi安装包 | 双击安装、自动注册服务，最省心；装完建议重启一次 |
| Linux | 发行版安装包 / Flatpak | Debian/Ubuntu 用.deb，Fedora 用.rpm，其余可走 Flatpak |
| macOS | DMG 拖入 Applications / Homebrew | 目前属于实验性支持，注意手柄暂不可用 |
| 想折腾源码 | git clone https://gitcode.com/GitHub_Trending/su/Sunshine自行编译 | 适合想改代码或追新功能的玩家，构建步骤见项目内 building 文档 |
几个容易卡住的点提前说：
- Windows 的手柄驱动：Windows 上串流要虚拟手柄，需要单独装 Virtual HID 驱动（项目文档里叫 libvirtualhid），旧的 ViGEmBus 只是兜底方案。装完驱动后建议重启电脑再跑串流，否则手柄可能没反应。
- Linux 的权限：Linux 用户要用虚拟键盘/鼠标/手柄，得把运行 Sunshine 的用户加进
input组，然后注销重登才会生效。 - macOS 的首次授权：第一次启动会弹窗要求授予"屏幕录制"和"麦克风"权限，全部允许即可，否则串流过去会是黑屏或没有声音。
装好后启动服务，浏览器打开https://localhost:47990，浏览器会提示证书不安全——这是自签名证书的正常现象，直接忽略继续即可。看到欢迎页，说明你已经走完了最难的一步。
第三站：第一场实战——五步完成 Moonlight 客户端与 Sunshine 的配对串流
第一次把"主机"和"客户端"连起来，核心就是做一次配对，全程不超过五分钟。
第 1 步：创建你的管理员账号。在欢迎页上设置用户名和密码，这是第一次也是唯一一次，一定记牢——忘了的话要在命令行用--creds参数重置。
第 2 步：安装 Moonlight 客户端。手机、平板去应用商店搜 Moonlight，PC 上装桌面版。也可以在 Sunshine 的 Web 界面里打开"精选应用"标签页，里面有官方整理好的全平台客户端下载入口。
第 3 步：添加主机。打开 Moonlight，它会自动发现局域网里的 Sunshine；发现不了也没关系，点手动添加，填主机 IP 即可。
第 4 步：输入配对 PIN。Moonlight 会弹出一个 4 位 PIN 码，切回 Sunshine 的 Web 界面，进入导航栏的 PIN 页面输入它，再给这台设备起个名字（比如"客厅电视"），回车看到成功提示就完成了。
第 5 步：选择应用开始串流。配对后 Moonlight 里会出现 Sunshine 上的应用列表——默认自带"桌面"和"Steam"两个入口，点进去就是实时的桌面画面。
两个马上用得上的快捷键：Ctrl+Alt+Shift+N隐藏/显示鼠标指针；Ctrl+Alt+Shift+F1到F12在多个显示器之间切换串流目标。
第四站：踩坑记录——"客户端找不到服务器"等五个高频问题的排查清单
串流这东西，九成问题出在网络、驱动和权限三件事上。下面五条是按出现频率排的，直接对照着查：
1. 客户端发现不了服务器。先确认两端在同一个网段；再检查主机防火墙是否放行了 47990 端口（Web 管理），以及 Moonlight 串流用的 47984–48010 端口段。Windows 上装官方安装包会自动配好防火墙规则，Linux 则需要自己放行。
2. 画面卡顿、掉帧明显。别急着怪网络，先看日志。Web 界面的"故障排查"标签页会列出错误和警告条目，里面通常直接写着编码器初始化失败、带宽不足这类根因。
3. 键盘鼠标完全没反应。Linux 老玩家的经典坑——运行 Sunshine 的用户不在input组里，把用户加进去、注销重登即可。
4. 手柄连上但游戏认不出。先确认驱动装没装全（Windows 的 Virtual HID / Linux 的 uinput 权限），装完记得重启；再回到游戏里重新插拔手柄试试。
5. 启动游戏后串流立刻断掉。多半是应用启动方式不对，比如把 Steam 配成了cmd而不是detached，进程一退出流就跟着断。到应用编辑里把启动方式改成 detached 就稳了。
第五站：进阶玩法——按游戏类型匹配编码器与码率的四张实用配方表
跑通第一场串流只是开始，真正让体验"顺滑得像本地"的，是把编码器和码率调到跟你的游戏、显卡、网络三者匹配。先定编码器：
| 你的显卡 | 推荐编码器 | 特点 | 适合场景 |
|---|---|---|---|
| NVIDIA | NVENC | 延迟最低、性能开销小 | 竞技游戏、高帧率需求 |
| AMD | AMF / VAAPI | 画质与效率均衡 | 单机大作、画质优先 |
| Intel | QuickSync | 核显即可、功耗低 | 轻薄本、省电场景 |
| 无独显/老硬件 | CPU 软件编码 | 兼容性最强 | 测试环境、临时救急 |
编码器定了，再按游戏类型给画质参数，这套配方直接抄作业：
| 游戏类型 | 分辨率 | 帧率 | 码率 | 编码预设 |
|---|---|---|---|---|
| 竞技类（CS、格斗） | 1080p | 120fps | 25Mbps | 性能优先 |
| 单机大作（3A 剧情） | 1440p | 60fps | 35Mbps | 质量优先 |
| 独立/休闲游戏 | 1080p | 60fps | 15Mbps | 均衡 |
| 平板/手机端 | 720p | 60fps | 10Mbps | 性能优先 |
网络侧记住一句话：能插网线就插网线（主机端至少 CAT6），走无线就锁 5GHz 频段、保证信号强度 70% 以上，路由器支持的话给串流设备的流量开 QoS 优先。所有设置都可以在 Web 界面的配置页里改，右上角有搜索框，想调什么直接搜，比翻菜单快得多。
追求画质的玩家还可以试 HDR 串流：Windows 主机上已正式支持，Linux 上属于实验特性（需要 KMS 捕获配合支持 HDR 的桌面环境）。要求是主机端先开启 HDR、客户端也打开 HDR 选项，否则画面会发灰。
第六站：全家共享——把 Sunshine 部署成家庭游戏中心的最后一步
串流这个事，最有成就感的是把一个人的装备变成一家人的娱乐设施。给家里每台设备（电视盒、平板、笔记本、手机）分别完成一次配对、起好名字，谁想玩谁就连上来；每个游戏应用都能设置独立的启动参数和图标，给妻子配独立游戏、给孩子配休闲游戏、给自己留 3A 大作，互不打扰。
Moonlight 客户端的覆盖面相当广，桌面端、移动端、还有面向树莓派等嵌入式设备的版本都有，Sunshine 的"精选应用"页面把这些官方验证过的客户端和工具都整理好了：
给你的行动清单：
- 今晚就按第二站装好 Sunshine，访问
https://localhost:47990建好账号； - 用第三站的五步流程在手机上完成第一次配对，串流桌面试试手；
- 进配置页把码率按第四、五站的配方调一轮，感受一下差别；
- 把这份经验顺手分享给同样在折腾串流的朋友。
相关资源入口（项目内文档）：
- 快速上手与安装明细：docs/getting_started.md
- 全部配置项逐个说明：docs/configuration.md
- 报错时的排查手册：docs/troubleshooting.md
- 更多玩法与社区教程：docs/guides.md
- 从源码自行构建的步骤：docs/building.md
Sunshine 的价值不在于多炫酷，而在于它把你已经拥有的硬件潜力真正释放了出来——一台机器，全家屏幕，游戏跟着人走。现在就去把它跑起来，让下一场 Boss 战，在任何你想待的地方继续。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
