Sunshine 免费游戏串流服务器三步上手
【免费下载链接】Sunshine Self-hosted game stream host for Moonlight. 
项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一款免费开源的游戏串流服务器，专为 Moonlight 客户端设计，适合想零订阅费用在客厅电视、平板、手机上玩 PC 游戏的新手。装好它，书房主机的全部游戏都能串到你手边的屏幕上：画面逐帧编码后经局域网送到客户端解码显示，客户端的按键、摇杆操作实时回传主机。全程数据只在你自己的设备间流动，不经过任何第三方云服务。
Sunshine 游戏串流服务器是什么
服务端与客户端的分工
很多人只听过 Moonlight，却不知道它只是"客户端"。Sunshine 负责采集画面、硬件编码、接收指令，装在游戏主机上；Moonlight 负责解码、显示、回传输入，装在任何能装它的设备上。两者搭档就是完整的串流链路：主机推流 → 网络传输 → 客户端解码 → 操作回传，每一环通了，体验才顺。
硬件门槛比想象的低
编码压力主要落在主机显卡的硬件编码器上，CPU 负担很小，中端配置即可。显卡支持 NVENC、AMD AMF 或 Intel QuickSync 都能跑，Linux 还有 VAAPI，实在不行有软件编码兜底；想要更好画质，优先选支持 HEVC 或 AV1 硬编码的显卡。客户端只负责解码，普通电视盒子、旧笔记本都能胜任。系统覆盖 Windows、Linux、macOS，macOS 版手柄支持尚不完整，属实验性状态。
按系统安装 Sunshine
各系统的安装命令
| Windows | 官方 MSI 安装包 | 双击安装包，按向导完成 |
| Linux | 官方包 / Flatpak | 安装发行版对应 deb / rpm 包，或执行下面命令 |
| macOS | Homebrew / DMG | 执行下面命令，或下载 DMG 拖进 Applications |
Linux 用户可以直接装 Flatpak：
flatpak install flathub dev.lizardbyte.app.Sunshine
macOS 用户执行 Homebrew 安装：
brew install sunshine
预期结果：安装完成后启动 Sunshine，命令行持续输出运行日志，没有报错即正常。
⚠️ 优先用官方发布的安装包，第三方打包版本官方不提供支持；Docker 镜像也不推荐给普通用户。
首次打开 Sunshine Web 管理后台
启动后，用浏览器访问管理后台（localhost 可换成主机局域网 IP）：
https://localhost:47990
预期结果：浏览器提示"连接不安全"（自签名证书的正常现象），点"继续访问"后看到 Welcome 页面。
页面默认用户名 sunshine，首次进入要设置密码。
⚠️ 这个密码没有"找回"入口，忘了只能在命令行重置，务必记牢。
走通第一次串流
配对 Moonlight 客户端
在接收端设备安装 Moonlight 客户端（PC、Android、Steam Link 均可），确保与主机在同一局域网：
预期结果：配对页面提示成功，Moonlight 里点击应用后几秒内出画面，第一次串流完成。
把游戏加进串流列表
Applications 页面点 Add New，填游戏名、可执行文件路径，按需加启动参数即可；Desktop 应用默认已配好，远程访问桌面直接用它。
注意页面上写着"Applications are refreshed only when Client is restarted"：应用列表只在客户端启动时拉取一次。
⚠️ 添加或修改应用后，重启 Moonlight 客户端列表才会刷新，这是新手最容易卡住的一步。
💡 串流中按 Ctrl+Alt+Shift+N 可隐藏/显示鼠标；Ctrl+Alt+Shift+F1~F12 可切换串流的显示器，多屏主机用得上。
串流配置关键参数详解
码率与分辨率怎么调
码率是画质和带宽的权衡点：局域网内从 20 Mbps 起步往上加，画面开始卡顿再回退。分辨率与帧率按客户端解码能力和主机显示器决定，1080p / 1440p / 4K 搭配 60 / 120 帧任选。编码器 Sunshine 会按你的显卡自动挑最优，一般不用手动干预；HDR 目前 Windows 支持较好，新手建议先玩转 SDR。
配置项太多找不到？用 Configuration 页右上角的搜索框——输入关键词，相关项立刻高亮定位：
💡 搜 "UPnP" 即可一键开启自动端口转发，为以后公网串流铺路。
端口族整体偏移
默认端口族以 47989 为基准（串流主端口），Web 后台在 47990。和别的服务端口打架时，改配置里的这一项：
port = 47989
整个端口族会随这一个值同步平移，不用逐项挪。预期结果：保存后所有端口按新基准整体偏移，冲突消失。
高频问题排障速查
客户端发现不了主机、手柄无反应
Q：Moonlight 发现不了 Sunshine？ 原因：防火墙拦了端口，或两台设备不在同一局域网。 操作：放行 47989 与 47990，并在 Moonlight 手动添加主机 IP。 验证：主机列表中出现 Sunshine 图标。
Q：手柄在游戏里没反应？ 原因：实体手柄占了"第一手柄"位置。 操作：Steam 设置改为只支持通用手柄，禁用主机上直连的实体手柄。 验证：游戏内手柄指示灯亮起，按键有响应。
忘了密码、画面卡顿
Q：忘了 Web 后台密码？ 原因：后台无密码找回入口。 操作：主机上执行重置命令（{username} {password} 换成新值）：
sunshine –creds {username} {password}
Flatpak 安装的用户改为：
flatpak run –command=sunshine dev.lizardbyte.app.Sunshine –creds {username} {password}
验证：用新账号密码能登录后台。
Q：画面一卡一卡的？ 原因：串流对网络稳定性的要求远高于带宽，多半是丢包/抖动超标。 操作：主机执行 iperf3 -s，客户端执行 iperf3 -c 主机IP -t 60 -u -R -b 50M，看丢包与抖动；不达标先降分辨率、降码率。 验证：丢包低于 5%、抖动低于 1ms，串流不再卡顿。
疑难杂症去后台 Troubleshooting 页看实时日志，错误信息相当直白，结合上面 iperf3 结果基本都能定位。
总结：你的串流中心下一步
Sunshine 免费、全平台、无订阅，默认配置下的局域网串流十分钟就能跑通；HDR 与公网串流等进阶玩法需要额外配置，不急可以后补。接下来直接做三件事：
git clone https://gitcode.com/GitHub_Trending/su/Sunshine
【免费下载链接】Sunshine Self-hosted game stream host for Moonlight. 项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
