Sunshine 完整指南：10 分钟零基础上手，免费开源游戏串流服务器与 Moonlight 配对全流程
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一款免费开源的自托管游戏串流服务器。它跑在你自己的 PC 上，配合 Moonlight 客户端，就能在局域网内低延迟串流游戏、远程访问桌面。NVIDIA、AMD、Intel 显卡的硬件编码原生支持，全程用浏览器就能管理配置。
Sunshine 功能与支持情况速查
Sunshine 负责主机端的采集画面、硬件编码和推流，Moonlight 负责接收解码并回传键盘、鼠标、手柄操作，两者分工明确，且都完全免费。
| 能力项 | 支持情况 |
|---|---|
| 运行平台 | Windows、Linux、macOS（实验性）、FreeBSD |
| 硬件编码 | AMD / Intel / NVIDIA，另有软件编码兜底 |
| 串流客户端 | Moonlight 全平台：PC、手机、平板、电视 |
| 手柄模拟 | DS4、DualSense、Xbox、Switch Pro，Windows/Linux 支持 |
| 管理方式 | 浏览器 Web 界面，地址https://localhost:47990 |
边界要提前知道：macOS 版本仍是实验性质且暂不支持手柄；Windows 上的 ARM64 架构同样标记为实验性。若显卡或驱动不支持对应硬件编码，会自动退到软件编码，能用但会占用更多 CPU。
Sunshine 安装前准备清单
- 准备一台装了 Windows、Linux 或 macOS 的 PC，显卡为 A/I/N 任一品牌
- 确认手机、平板或电视上已装好 Moonlight 客户端
- 确认主机与客户端在同一局域网，能插网线就别用 WiFi
- 记下 Sunshine 主机的固定内网 IP，配对时要填写
- 若要串流桌面办公，接一块显示器或 HDMI 假负载，避免显卡不渲染
Sunshine 安装、配置、连接三阶段跑通
阶段一：安装 Sunshine。下面四行分别对应 Windows、Linux（Flatpak）、macOS 以及源码编译，挑适合你的执行：
winget install LizardByte.Sunshine flatpak install --user flathub dev.lizardbyte.app.Sunshine brew tap LizardByte/homebrew && brew install sunshine git clone https://gitcode.com/GitHub_Trending/su/Sunshine源码版进入仓库后按cmake ..、make -j$(nproc)、sudo make install标准三连编译安装即可。Linux 上建议把 Sunshine 设成开机自启服务，省去每次手动拉起。
阶段二：配置 Web 界面。浏览器打开https://localhost:47990，首次访问会让你创建用户名和密码，务必记牢。浏览器提示"不安全"是因为自签名证书，点继续即可。进入 Applications 标签，点 Add New，填上应用名称和启动路径（如 Steam 或游戏可执行文件），保存。
阶段三：配对 Moonlight 客户端。打开 Moonlight，手动添加 PC，填入 Sunshine 主机 IP。客户端请求配对时，回到 Web 界面顶栏的 PIN 标签，输入屏幕上显示的 PIN 码并回车，再给设备起个名字，配对即完成。点开任意一个应用图标，画面出来后整个链路就算跑通了。
Sunshine 上手后的三个高频操作
整块桌面直接串流。默认的 Desktop 应用不启动任何程序，直接推流整个桌面。远程办公、临时处理文档时直接选它，不占额外资源。
自建游戏应用条目。在 Applications 里给每个游戏单独建条目，填名称、启动路径和参数，支持$(HOME)这类环境变量替换，串流时按条目点选，像点播一样。
虚拟手柄免插线。Windows 需要先安装 Virtual HID Driver（ViGEmBus 仅作为受限兜底）；Linux 则把运行 Sunshine 的用户加入input组，重新登录后生效。
Sunshine 串流排障速查表
| 症状 | 常见原因 | 处理 |
|---|---|---|
| Moonlight 搜不到主机 | 防火墙挡住 47990 端口，或不在同一网段 | 放行端口、确认同网段 |
| 忘记 Web 界面密码 | 记性不好 | 终端执行sunshine --creds 新用户 新密码重置 |
| 手柄没反应 | Windows 缺驱动、Linux 权限不足 | 装 Virtual HID Driver；加入input组后重登 |
| 画面卡顿掉帧 | 无线信号不稳或码率过高 | 降码率、换 5GHz 频段、改有线 |
| 鼠标乱飘 | 主机端没有物理鼠标 | 给主机插一个物理鼠标 |
所有日志和警告信息都集中在 Web 界面的 Troubleshooting 标签里，逐条展开就能看到定位线索，排查不用靠猜。
Sunshine HDR 串流与 SSH 无头启动
HDR 串流：Windows 主机正式支持，Linux 主机属实验特性，且必须使用 KMS 采集后端，显卡需支持 HEVC Main 10 或 AV1 10-bit 编码。前提条件是主机系统开启 HDR、Moonlight 客户端同步打开 HDR 选项，两端缺一都会退回 SDR。
SSH 无头启动：Linux + X11 环境下主机不接显示器也能串流，远程执行下面命令拉起即可：
ssh 用户@主机IP 'export DISPLAY=:0; sunshine'Sunshine 文档与源码延伸资源
- 入门与安装细节：docs/getting_started.md
- 全量参数与配置说明：docs/configuration.md
- 应用配置示例：docs/app_examples.md
- 排障手册：docs/troubleshooting.md
- 编码器实现源码：src/nvenc/，Linux 采集模块：src/platform/linux/
跑通之后，你的 PC 就是一台随叫随到的串流主机：局域网内低延迟，配置随时在浏览器里改，不用为云游戏交月费。显卡支持 AV1 的话，把编码器切到 AV1，同画质下还能再省一截带宽。剩下的，就是点开 Moonlight 开始玩了 🎮
本文关键词清单
- 自托管游戏串流服务器 / Sunshine 开源串流完整指南
- Moonlight 客户端配对 / Sunshine 与 Moonlight 设备连接步骤
- 局域网低延迟游戏串流 / Sunshine 远程桌面访问
- 显卡硬件编码配置 / Sunshine 编码器参数调优
- Sunshine 新手入门教程 / 零基础上手安装指南
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
