Sunshine游戏串流快速上手指南：10 分钟把游戏主机变成串流服务器
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一个开源的自托管游戏串流主机，配合 Moonlight 客户端，可以把你自己的电脑变成游戏串流服务器，手机、平板、电视都能当"接收端"。本文按问题带你走一遍完整流程：先确认硬件，再装好 Sunshine 服务端，添加游戏，配对客户端，最后处理常见卡点。读完照做，你能在自己家里跑通第一条游戏串流。
动手之前，先看看你的电脑够不够用
硬件门槛并不高
Sunshine 用 GPU 做硬件编码，串流对配置的要求比实际玩游戏低一些。官方给出的最低线是：
| 部件 | 最低要求 | 想跑 4K 串流 |
|---|---|---|
| GPU | 带硬件编码的 AMD / Intel / NVIDIA 显卡 | RTX 20 系 / GTX 1080 以上，或同级别 A 卡、U 核 |
| CPU | i3 或 Ryzen 3 及以上 | i5 或 Ryzen 5 及以上 |
| 内存 | 4GB | 8GB |
| 网络 | 双端 5GHz Wi-Fi（802.11ac） | 双端千兆网线 |
- 以上数据来自仓库 README.md 的 System Requirements，4K/HDR 还有更细的表格
- 没有独显也别灰心：软件编码（libx264）全平台可用，只是帧率和延迟会差一些
- 网络比带宽更怕"不稳"：延迟抖动和丢包对串流的影响远大于峰值速率
安装前的小动作
两个平台各有"坑位"，提前处理能省掉半天：
- Windows：串流的手柄和键鼠靠虚拟输入设备实现。建议从官方渠道单独安装 Virtual HID Driver（版本 2026.829.2338.54 或更新），装完重启一次电脑。不装也能跑，只是手柄支持受限
- Linux：要用虚拟输入设备（键盘、鼠标、手柄），先把当前用户加入
input组，然后注销重新登录 - macOS：串流目前还是实验性质，手柄暂不支持；首次启动会请求"屏幕录制"和"麦克风"权限，点允许即可
3 分钟装好 Sunshine：三个系统各一条路
按系统选安装包
| 系统 | 安装方式 | 说明 |
|---|---|---|
| Windows | 从最新 Release 下载 MSI 安装包，双击安装 | 推荐方式；装完默认以 Windows 服务运行 |
| Windows | winget install lizardbyte.sunshine | 命令行党 |
| Debian / Ubuntu | 从 Release 下载sunshine-ubuntu-{版本}-{架构}.deb后执行sudo dpkg -i ./xxx.deb | 官方包自带 CUDA 依赖，不用另装 |
| Fedora / OpenSUSE | 下载Sunshine-{版本}.{发行版}.{架构}.rpm双击或sudo dnf install安装 | 包名大小写敏感 |
| Arch Linux | 从 Release 拿sunshine.pkg.tar.zst，makepkg -si安装 | AUR 包属于第三方，官方不背锅 |
| macOS | brew install sunshine（先 tap LizardByte/homebrew） | 实验性支持 |
- 官方推荐"直接用各系统对应的 Release 安装包"，AppImage / Flatpak 能用但不支持 KMS 采集，能装发行版专用包就优先装
- 装第三方包之前，先翻翻 第三方包说明
启动服务端并打开 Web 管理界面
Linux 上 Sunshine 装完是 systemd 用户服务，启动并设为开机自启：
# Linux：启动 Sunshine 并设置开机自启 systemctl --user --now enable app-dev.lizardbyte.app.SunshineWindows 装完服务已在后台跑，macOS 首次打开应用时授予权限即可。然后做两件事：
- 浏览器访问
https://localhost:47990，首次打开会让你创建管理员用户名和密码——抄下来存好，忘了可以用命令重置（见文末排障） - 浏览器提示"证书不安全"是正常现象，自签名证书而已，继续访问即可
Sunshine 的 Web 管理界面，配置、配对、查日志都在这里完成
添加游戏和应用：从 Desktop 到单个游戏
最省事的入口：Desktop 和 Steam
Sunshine 把"串流目标"抽象成应用。应用列表里默认有一个Desktop，它不启动任何程序，只是直接串流整个桌面——第一次测试强烈建议先用它跑通链路。
如果想直接进 Steam 大屏，按 应用示例 的写法填一条"分离进程"应用即可：
| 字段 | 示例值（Linux） |
|---|---|
| 应用名称 | Steam Big Picture |
| 分离命令 | setsid steam steam://open/bigpicture |
| 串流结束后的撤销命令 | setsid steam steam://close/bigpicture |
单个游戏怎么填
- Windows 下的游戏：命令填 exe 路径，再填工作目录；或者用启动器 URI（如 Epic 的
com.epicgames.launcher://...） - Steam 游戏：填 Steam URI 最稳，各平台通用
- 两个行为要心里有数：应用退出时串流会跟着结束；
cmd类型应用如果主进程自杀（比如 Steam 自更新），串流会立刻断掉，这类要用detached方式启动 - 每个应用的完整字段说明都在 docs/app_examples.md
应用列表页：Desktop、Steam 大屏和单个游戏都在这里添加
Moonlight 客户端怎么选、怎么配对
各平台客户端
Moonlight 是串流接收端，Windows、macOS、Linux、Android、iOS 都有，电视和掌机也可以。最省事的入口：Web UI 的Featured Apps页签，里面列了各平台客户端的官方下载方式，照着装就行。
配对流程：一个 PIN 就完成
- 在 Moonlight 客户端里搜索局域网，或手动输入 Sunshine 主机的局域网 IP
- 客户端请求配对时，打开 Sunshine Web UI，点导航栏的PIN
- 把 PIN 填进客户端，顺手给设备起个名字，看到成功提示就配对完毕
- 选一个应用，开始串流——第一次建议选 Desktop
Featured Apps 页签：Moonlight 各平台客户端的获取入口都在这
关键配置档位：编码器、画质、延迟
编码器怎么选
编码器决定了串流画质和延迟的下限。在 Web UI 的配置页用搜索框直接搜encoder：
- NVIDIA 显卡：NVENC（Windows / Linux 均可）
- AMD / Intel：Linux 走 VAAPI，Windows 走 AMF / QuickSync
- 什么都没有、或只想先跑通：软件编码，全平台支持
- 完整兼容矩阵在 README.md 的 Encoding API 表格里
画质参数怎么调
分辨率、帧率、码率这些参数在 Moonlight 客户端和 Sunshine 配置里都有入口，建议的起步档位：
| 场景 | 分辨率 | 帧率 | 码率 |
|---|---|---|---|
| 先跑通、验网络 | 720p | 60 | 中低 |
| 局域网常规玩 | 1080p | 60 | 50Mbps 左右 |
| 4K 大屏 | 4K | 30~60 | 按编码器能力给到上限 |
降延迟的小开关
- NVIDIA 显卡：驱动设置里开Fast Sync，可能少一帧延迟
- AMD 显卡（Windows）：开Enhanced Sync，对 amfenc / libx264 编码有效
- 其余细节见 性能调优说明
端口和远程访问：防火墙怎么放通
Sunshine 用的端口
Sunshine 默认以 47989 为端口基址，一串流数据就落在这段区间里。局域网串流前，把主机的防火墙放通：
# Linux（ufw）：放行 Sunshine 发现/管理/串流端口 sudo ufw allow 47989:47990/tcp sudo ufw allow 47998:48010/udp- 47989：局域网设备发现（UDP），47990：RTSP 协商（TCP）
- 47998–48010：视频、音频、输入的 UDP 数据端口
- 改过 Web UI 里的
port基址的话，按偏移量同步调整上面两条规则
想在外面玩家里的游戏
- Web UI 中
origin_web_ui_allowed控制管理页谁能访问：默认lan，改成wan才能从公网打开管理页 - 远程串流需要在路由器上把上面的端口段映射到主机
- 公网可管理 + 弱密码是很危险的组合：先设置强密码，再考虑放开
wan - 全部配置项的说明在 docs/configuration.md，每个参数都有默认值和示例
常见卡点：按症状对号入座
忘了 Web UI 的账号密码？
用一条命令直接重置，把尖括号内容换成你的新账号密码：
# 重置 Web UI 登录凭据 sunshine --creds <new-username> <new-password>画面卡顿、丢包严重？
先判断是网络问题还是主机跑不动：
- 客户端和主机尽量同网段，主机优先插网线；Wi-Fi 建议都上 5GHz
- 主机网口速度远高于客户端时（比如 2.5G 主机 + Wi-Fi 客户端），突发流量可能把中间设备冲爆，降低分辨率或码率先验证
- 用 iPerf3 做 60 秒 UDP 测速，丢包尽量低于 5%、抖动低于 1ms
- 0.23.1 之后的版本网络代码有改进，先把 Sunshine 升级到最新再下结论
- 更细的症状分析（缓冲区溢出、QoS 限速）在 故障排除文档
连上了但输入没反应？
- Linux：确认当前用户在
input组里，且已注销重新登录 - Windows：确认装了 Virtual HID Driver 并重启过电脑，状态可在 Web UI 的 Troubleshooting 页查看
- 鼠标行为诡异时，给主机插一个实体鼠标试试
- 还是没头绪？Web UI 的Troubleshooting页签会逐条给出警告和错误，按提示排查
你的 5 步行动清单
照顺序做完就算跑通了
- 按系统装好 Sunshine，Windows 先装 Virtual HID Driver，Linux 把自己加进
input组 - 启动服务，打开
https://localhost:47990，创建并抄下管理员账号 - 添加 Desktop 应用（或 Steam 大屏），确保应用列表非空
- 在 Moonlight 客户端配对：搜到主机 → 输入 Web UI 里的 PIN → 选应用开串流
- 跑通后按档位调优：先 720p/60 验网络，再升 1080p，最后动 4K；卡住就回到 Troubleshooting 页签看日志
装完后如果一切顺利，你应该已经能看到客厅电视上的游戏画面了。后续想加新游戏、开 HDR 或做远程访问，回到对应章节照着调即可。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
