把电脑变成私人云游戏主机：Sunshine 游戏串流服务器部署指南
项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine 周五晚上，你窝在客厅的沙发上抱着平板，想接着玩的游戏却在书房那台电脑上。起身去玩，懒；电脑又被家人占着，烦。Sunshine 就是为这个场景而生的：一个自托管、开源的游戏串流服务器。装好它，电脑画面就能推到房间里任意一台 Moonlight 客户端上，手柄操作实时传回主机，全程只需十来分钟。
先搞清 Sunshine 是什么角色
把 Sunshine 想象成搭在家里的一个"直播间"：它装在 PC 上，只做三件事——抓取屏幕、用 GPU 硬件编码器压缩、把视频流发出去。接收端则要在手机、平板或电视上装 Moonlight 客户端，负责播放画面并把你的按键传回主机。
它的边界也很清楚：Sunshine 自己没有任何画面，不是串流客户端，也不替你运行游戏，只是"抓屏 → 压缩 → 传输"这一环。编码器还会自动认卡：NVIDIA 走 NVENC、Intel 走 QuickSync、AMD 走 AMF 或 Linux 下的 VAAPI/Vulkan，都没有时才退回 software 软编码，不用你手动挑。
安装 Sunshine 前的准备自检
花两分钟核对这四条，后面九成的坑都能绕开：
- 带硬件编码器的显卡：NVIDIA、AMD、Intel 的独显或核显都行；只有 CPU 也能跑软编码，但延迟和画质都会明显变差。
- 同一个局域网：主机 PC 和串流设备接同一个路由器，首次调试建议主机插网线，无线选 5GHz 频段比 2.4GHz 稳得多。
- 显卡驱动不陈旧：Sunshine 直接调用显卡的编码电路，驱动太旧容易报编码器找不到，先更新驱动再动手。
- 一台能开浏览器的设备：首次配置要在
https://localhost:47990管理页创建账号，Chrome、Edge、Firefox 都行。
四步跑通第一次串流
按顺序做完这四步，你的手机或平板上就会出现 PC 的桌面。
第 1 步：按系统装一个 Sunshine 服务端
这一步结束后你应该看到 Sunshine 已装入系统，或安装向导一路提示确认。
# Windows
winget install LizardByte.Sunshine
# Linux（Flatpak，兼容大部分发行版）
flatpak install flathub dev.lizardbyte.app.Sunshine
# macOS（首次先执行 brew tap LizardByte/homebrew）
brew install sunshine
Windows 安装器问到虚拟手柄驱动时，建议装上，否则客户端手柄无法识别；macOS 首次启动会申请屏幕录制与键鼠控制权限，允许后如提示 Quit & Reopen 就点它。
第 2 步：启动服务，打开 Web 管理页
这一步结束后你应该能在浏览器打开 https://localhost:47990，看到 Sunshine 的欢迎页。
# Linux：立即启动服务并设置开机自启
systemctl --user --now enable app-dev.lizardbyte.app.Sunshine
# 未以服务方式安装时，直接前台运行
sunshine
别慌，浏览器提示"不安全网站"只是自签名证书导致的，点高级继续即可。在欢迎页创建管理账号，密码只显示这一次、之后无法找回，立刻存进密码管理器，用户名取个方便记的就行。
第 3 步：装 Moonlight 并完成 PIN 配对
这一步结束后你应该在管理页的 PIN 页看到 Success 提示。
Moonlight 各平台客户端在管理页的 Featured Apps 标签里整理好了，照着设备类型下载对应那个。
打开 Moonlight 后它会自动发现主机，并给出一个 4 位 PIN 码；回到管理页 PIN 标签输入该码、回车，再给设备起个名字，比如"客厅平板"。
搜不到主机先别急——多半是两台设备不在同一局域网，确认同网段后在 Moonlight 点"+"手动填主机 IP 也能连。
第 4 步：在 Applications 里登记可串流应用
这一步结束后你应该在应用列表里看到 Desktop 和 Steam 两条默认记录，以及你新加的游戏。
点 Add New 填启动命令就能单独添加任意游戏，例如把 Steam 大屏模式单独建一条，退出游戏时串流随之断开，更干净。
应用列表只在 Moonlight 客户端重启后刷新，加完记得在设备上完全退出再重开 Moonlight；Sunshine 同一时间只运行一个应用，启动新的会自动关掉旧的。
成功信号：三个判断链路已通的指标
- 在 Moonlight 里选 Desktop，主机画面出现在设备上，鼠标或触摸操作能控制主机。
- 按手柄按键或敲键盘，屏幕立刻响应，没有明显的输入拖影感。
- 退出串流后主机恢复正常，随时可以再次发起。
三条都满足，链路就算真正打通了。
常见翻车点与解法
画面卡顿掉帧？先查网络，再怀疑编码器 —— 串流卡顿十有八九是网络问题。排查顺序：主机是否插网线、Wi-Fi 是否 5GHz、有没有人正在下载大文件。想给帧率兜底可设置 minimum_fps_target（默认 0，等于流帧率的一半），带宽不足时 Sunshine 会自动降码率保帧率。
画面发糊？调码率，别先动分辨率 —— max_bitrate 默认 0，表示跟随 Moonlight 请求的值。有线局域网可设为 50000（单位 Kbps，即 50Mbps），画面立刻细腻一档；无线不稳时反过来降低码率，比拉高更稳。
Windows 手柄失灵？查虚拟手柄驱动 —— 多半是驱动没装或版本过旧，重新走安装器安装并更新，驱动变动后重启电脑生效。注意 ViGEmBus 只覆盖 Xbox 360 和 DualShock 4 两种手柄，要支持更多型号需另行安装并激活 Virtual HID Broker 许可。
Moonlight 搜不到主机怎么查？ —— 依次检查：防火墙是否放行串流端口族（默认基址 47989）和管理端口 47990、两台设备是否同局域网、最后用 Moonlight 手动填主机 IP。Docker 部署的用户要把 47984–47990 整个端口段映射出来。
彻底卡住了？翻故障排查日志 —— 别急着卸载，去管理页 Troubleshooting 标签逐条看警告和错误，每条都带上下文，顺着基本能定位。
速查表：端口、路径与高频问题
| 事项 | 内容 |
|---|---|
| Web 管理页 | https://localhost:47990（默认） |
| 管理账号 | 首次访问自建的用户名密码，无默认账号 |
| 默认端口 | 串流端口族基址 47989，Web 管理 47990 |
| 配置文件路径 | Windows：%ProgramFiles%\Sunshine\config；Linux/macOS：~/.config/sunshine |
| 配对流程 | Moonlight 显示 4 位 PIN → PIN 页输入并命名设备 → Success |
| 搜不到主机 | 查 47989/47990 防火墙、确认同局域网、手动添加 IP |
| 手柄无效 | 重装虚拟手柄驱动并重启电脑 |
参数逐项详解看 docs/configuration.md，各平台完整安装步骤见 docs/getting_started.md。
游戏交给主机，人留给沙发
下次想在沙发上开玩，不必再抢电视：打开平板，点开 Moonlight，选中 Desktop，游戏就开始了。书房的电脑继续亮着，你负责躺着就行。🎮
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
