Sunshine 部署教程：5 步从安装到 PC 首次串流通
项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine 装完 Sunshine 后打开浏览器，页面却弹出"不安全网站"——别慌，这是自签名证书的正常表现，不是出了安全问题。Sunshine 是 LizardByte 社区维护的自托管游戏串流服务器，跑在 Windows、Linux、macOS 和 FreeBSD 上，装好后你局域网里的任何设备都能接上这台主机玩它的游戏。
Sunshine 安装与首次 Web 访问
按你的系统选一行执行即可，Sunshine Windows 安装命令是 winget 那条，其余系统各取所需：
# Windows（推荐）
winget install LizardByte.Sunshine
# Linux（Flatpak）
flatpak install flathub dev.lizardbyte.app.Sunshine
# macOS
brew install sunshine
# 也可以用 Docker 跑
docker pull lizardbyte/sunshine
# 想自己编译源码
git clone https://gitcode.com/GitHub_Trending/su/Sunshine
显卡这关先过一下：硬件编码的下限大约是 NVIDIA GTX 1050、AMD RX 550，或 Intel HD 600 及以上核显。没有也不至于跑不起来，会退回 CPU 软件编码，但画质和延迟都会明显吃亏。
Windows 安装向导若弹出安装 ViGEmBus 驱动，一路点确认，别跳过这一步——它决定你后面手柄能不能用，排障一节会再讲。
安装完成后，打开浏览器访问 https://localhost:47990。页面标红"不安全网站"，是因为 Sunshine 在本地生成了一张自签名 SSL 证书，点"继续访问"就行。
欢迎页要创建用户名和密码，默认用户名直接填 sunshine 就好：
⚠️ 密码只展示一次，没有找回流程，输完立刻存进密码管理器。
登录后就是 Web 管理界面。这里说清两边的分工：Sunshine 作为服务端，自己没有任何画面，它只做抓屏、用硬件编码器压缩、把码流发出去；Moonlight 作为客户端，负责解码播放，并把你的按键和手柄操作回传。串流低延迟的秘密就在这条回传链路上足够短。Sunshine 登录时会自动识别显卡并选对编码器：NVIDIA 走 NVENC，AMD 走 AMF，Intel 走 QuickSync，不需要手动切换。
Moonlight 客户端安装与 PIN 配对
在你想玩的设备——手机、平板、电视盒子或另一台电脑——上装 Moonlight 客户端，管理界面的 Featured Apps 标签整理好了各平台的下载入口，Android、iOS、PC、嵌入式设备各对一版。
Moonlight 打开后搜不到主机时，按顺序查三处：客户端和主机是否连着同一个路由器；主机防火墙是否放行了 47989（主串流，TCP）和 47990（Web 管理）两个端口；偶尔自动发现会失败，点"+"手动填主机局域网 IP 即可。Docker 部署的话，47984–47990 整段端口都要映射出来。
能搜到就点进主机，Moonlight 会要求输入一个 4 位 PIN 码。回到 Sunshine 管理界面，点导航栏的 PIN 标签，把那 4 位数字敲进去按回车，给设备起个名字（比如"客厅电视盒子"），看到 Success 提示，Moonlight PIN 配对这一步就算完成。
添加串流应用与验证链路
进入 Applications 标签，默认已有两条记录：Desktop 串整个桌面，Steam 串大屏模式。
想单独串某款游戏，点 Add New，填它的启动命令即可，比如 Steam 大屏可以写 steam://open/bigpicture。两个容易踩的坑放在这：应用列表只在 Moonlight 客户端重启后刷新，加完记得把客户端彻底退出再开；Sunshine 同时只运行一个应用，启动新的会直接结束当前的。
串流是否真的跑通，对照三条：Desktop 画面出现在手机上，鼠标和触摸能控制主机；手柄键鼠操作跟手，没有明显拖影；管理界面 Home 页能看到当前会话信息，断开后状态恢复空闲。三条都过，链路就通了。
Sunshine 码率调节与卡顿排障 ⚠️
画质不满意，先看码率。Configuration 标签里找到 bitrate，默认在 20Mbps 上下：主机插了网线，就把它从 20 拉到 50–100，画质立刻细腻一截；无线不稳时反过来降到 10–15，每帧数据变小，反而更容易按时送达。这个参数搭配 minimum_fps_target 一起调，后者指定最低帧率目标，网络波动时 Sunshine 会自动降码率保帧率，一个提画质、一个保下限，是同一组开关。
画面卡顿，先怀疑网络而不是显卡：主机插没插网线、客户端在不在 5GHz、有没有人占满带宽在下大文件，三样都排除后才轮到查编码器。
只想串单个游戏而不是整桌面的话，给每款游戏单独建一条记录并填启动命令，游戏退出时流会自动断开，画面干净利落。记住同一时间只能跑一个，切换前先退出当前应用。
手柄失灵、多显示器切换与日志排查 🎮
Windows 下手柄没反应，九成是虚拟手柄驱动的问题：ViGEmBus 没装或版本过旧。把驱动重装一遍，重启 Sunshine，多数情况直接恢复；新版 Sunshine 还支持 Virtual HID Broker，管理界面会显示当前驱动状态，以那里为准。
多显示器的主机，客户端按住 Ctrl+Alt+Shift 再按 F1~F12，切换要串哪台显示器；Ctrl+Alt+Shift+N 切换光标隐藏/显示，远程桌面场景好用。
卡住了先别卸载，管理界面的 Troubleshooting 标签把警告和错误按条列出，每条都带上下文，顺着往下查基本能定位。关键事实记这一张表：
| 事项 | 内容 |
|---|---|
| Web 管理界面 | https://localhost:47990 |
| 主串流端口 | 47989（TCP） |
| 配置文件 | Windows：%ProgramFiles%\Sunshine\config；Linux/macOS：~/.config/sunshine |
| 搜不到主机 | 确认同一路由器，防火墙放行 47989/47990，实在不行手动加 IP |
| 画面卡顿 | 先降码率，确认客户端走有线或 5GHz |
| 提示找不到编码器 | 更新显卡驱动后重启 |
文中提到的每个参数在 docs/configuration.md 里都有逐项解释，各平台安装细节和首次运行的环境要求以 docs/getting_started.md 为准。下一步建议：把 bitrate 拉到你的网线实际能扛住的值，然后跑一局 10 分钟，用 Troubleshooting 页面确认没有新增警告。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
