把电脑变成游戏主机：Sunshine 免费串流服务器部署与 Moonlight 配对完整指南
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一款免费开源的游戏串流服务器，装上它，你的电脑就能把游戏画面和声音实时推到手机、平板或电视上；再配上同样开源的 Moonlight 客户端，一套完全自建、数据自己掌控的串流链路就通了，全程不需要任何付费服务。
一分钟看懂：Sunshine 和 Moonlight 各干什么 📺
分工很简单：Sunshine 装在玩游戏的那台电脑上，Moonlight 装在你看画面的设备里。
| 角色 | 软件 | 运行位置 | 职责 |
|---|---|---|---|
| 宿主端 | Sunshine | 装有游戏的电脑 | 采集画面、实时编码并推流 |
| 客户端 | Moonlight | 手机 / 平板 / 电视 / 另一台电脑 | 显示画面、回传键鼠与手柄操作 |
核心链路就一句话：你在客户端上的每次点击和按键都会回传到宿主电脑，宿主把游戏画面编码后立刻推回来，一来一回的延迟被压到很低，体验接近本地游玩。
开工前 3 分钟自检 ✅
花 3 分钟核对下面 4 项，安装时就不会返工：
- 宿主系统：Windows 10/11、主流 Linux 发行版或 macOS，三个平台都有官方支持；
- 显卡：NVIDIA、AMD、Intel 都可以，有独立显卡体验最佳；
- 网络：局域网即可开始，跨网串流建议宿主机走网线；
- 客户端设备：任何能装 Moonlight 的设备都行，电脑、安卓/iOS 手机、树莓派都可以。
整个过程无需注册任何付费账号，你唯一要"注册"的，是首次登录 Web 界面时创建的本地管理账号。
三大平台安装速查 🖥️
按宿主机的系统对号入座，三选一即可。
macOS：brew 一行命令
brew install sunshine没装过 Homebrew 的话，先按其官网指引装好，再执行上面这条命令。
Windows：安装包向导式步骤
- 到 Sunshine 的发布页面下载最新的 Windows 安装包；
- 双击运行，按向导一路"下一步"完成安装；
- 安装后程序自动启动，并在系统托盘常驻图标，无需任何手动配置。
Linux：官方构建脚本
git clone https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine ./scripts/linux_build.sh构建脚本会自动拉取并编译第三方依赖，首次执行耗时较长属正常现象，具体依赖要求可参考 构建说明。
Web 管理界面三步走 🛠️
安装完成后，打开浏览器访问本地 47990 端口的 Sunshine Web 管理界面，按顺序完成三步。
第 1 步：创建本地管理账号
首次访问会看到 Welcome 欢迎页，依次填写 Username、Password 和确认密码，点击 Login。这组凭据是你日后管理串流服务器的唯一入口，页面只显示这一次，务必当场记好。
第 2 步：登记要串流的游戏应用
串流目标要以"应用"的形式登记：
- 点击顶部 Applications 选项卡；
- 点击左下角 Add New 按钮；
- 填写应用名称和可执行文件的完整路径，点击 Save 保存。
页面自带 Desktop（桌面）和 Steam Big Picture 两个常用预设，可以直接使用。注意：应用列表只有在客户端重启后才会刷新，新增应用后记得重启一次客户端。
第 3 步：开启 UPnP 打通外网
同一局域网内串流不需要任何额外配置；想在外网游玩，再做这一步：
- 进入 Configuration 页面，在搜索框输入 "Upnp"；
- 在 Network 选项卡下勾选 UPnP 开关，由路由器自动完成端口转发；
- 点击底部 Save 保存生效。
用 Moonlight 完成配对，开始第一次串流 🕹️
客户端装好后，配对只需一次，之后每次打开客户端都能直接进游戏。
- 在 Web 界面打开 Featured Apps 页面，找到对应平台的 Moonlight 客户端（PC、Android、Embedded 三个官方版本都有），点击 Get 下载安装；
- 把客户端设备接入与宿主电脑相同的网络，打开 Moonlight，它会自动发现局域网内的 Sunshine 主机；
- 在 Sunshine Web 界面的 PIN 选项卡查看 4 位配对码，在客户端中输入完成配对；
- 配对成功后，客户端会列出你登记的应用，点选即可开始第一次串流。
画质与延迟调优清单
先保证流畅，再慢慢往上提画质：
- 编码器按显卡选型：NVIDIA 选 NVENC，AMD 用 AMF，Intel 用 QuickSync，Linux 上还有 VAAPI 可选；
- 码率与分辨率：有线网络放心拉高，Wi-Fi 环境先保守设置再逐步上调；
- 帧率与刷新率匹配：高刷屏设备可开启更高帧率的串流；
- 网络优先级：串流对延迟最敏感，能走网线就别依赖 Wi-Fi。
出问题先查这里
遇到故障先按下表定位，大部分问题都能三分钟解决：
| 现象 | 原因与解决办法 |
|---|---|
| 客户端发现不了主机 | 确认两台设备在同一局域网；检查防火墙是否放行 Sunshine 的端口（Web 管理 47990，串流数据 47998–48000 等） |
| 画面卡顿、模糊 | 优先改走有线网络；适当降低码率或分辨率；排除同时占用带宽的程序 |
| 串流黑屏或启动失败 | 检查显卡驱动与编码器状态，再结合日志定位具体报错 |
| 键鼠 / 手柄无响应 | 确认客户端输入设备被正确识别，必要时检查宿主机的输入配置 |
排障第一现场是 Web 界面的日志入口（Troubleshooting 选项卡），先截图留存报错信息，无论是自查还是求助社区都会高效很多。
收尾
到这里，一套免费、自建、数据完全自己掌控的游戏串流链路就跑起来了。想继续深挖，可以翻翻 官方文档 里的编码器细节与性能调优章节，也欢迎加入 LizardByte 社区和其他玩家交流串流经验。现在就去启动你的第一场远程游戏吧 🎮
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
全流程解析)
