Sunshine 快速上手指南：15 分钟把 PC 变成家庭游戏串流服务器-开发者社区

Sunshine 快速上手指南：15 分钟把 PC 变成家庭游戏串流服务器

【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine

想在客厅电视上打 3A 大作，或在地铁里用平板接着玩？Sunshine 就是干这个的：一个跑在你 PC 上的自托管游戏串流服务器，装了它，任何装了 Moonlight 客户端的设备都能低延迟地串流你电脑上的游戏。从安装到第一次连上，只需要三步。

30 秒搞懂 Sunshine 是什么

Sunshine 是一台串流主机：它在你的电脑（支持 Windows、Linux、FreeBSD，macOS 为实验性支持）上截取屏幕和系统声音，用 GPU 实时编码，发给手机、平板、电视上的 Moonlight 客户端；你在客户端的按键、鼠标、手柄操作会原路传回主机。

它替你解决三件事：不用买云端订阅，游戏画面只在你自己的网络里跑；NVIDIA、AMD、Intel 显卡都有对应硬件编码（NVIDIA 为 NVENC，macOS 为 VideoToolbox），没有独显时还有软件编码兜底；所有配置在一个浏览器页面里完成，不用碰配置文件。

从安装到第一次成功（10 分钟跑通）

第一步：安装 Sunshine

Windows：从最新 Release 下载 MSI 安装程序（分 AMD64 与 ARM64 两种，后者为实验性），双击按向导装完即可，安装程序会帮你建好系统服务。
Debian/Ubuntu：下载对应发行版和架构的 deb 包后执行：

sudo dpkg -i ./sunshine-{distro}-{distro-version}-{arch}.deb

Fedora/OpenSUSE：依次执行sudo dnf copr enable lizardbyte/stable和sudo dnf install Sunshine；Arch 用户可用pacman -S sunshine。
macOS：把 DMG 里的 Sunshine.app 拖进应用程序文件夹，首次启动时授予屏幕录制和麦克风权限。

第二步：启动并打开 Web 管理界面

Linux 上一行命令即可开机自启并立即运行：

systemctl --user --now enable app-dev.lizardbyte.app.Sunshine

然后浏览器打开https://localhost:47990（自签名证书警告可忽略），在欢迎页创建管理员用户名和密码。

⚠️ 提醒：管理员凭证只在创建时显示一次，请当场记好。忘了也别慌，下面"卡住了"一节有命令行重置方法。

第三步：用 Moonlight 完成首次配对

在客户端装好 Moonlight——Sunshine 的 Web 界面 "Featured Apps" 标签页里就有官方客户端的下载入口。
Moonlight 通常会自动发现局域网里的 Sunshine；找不到就手动填主机 IP 添加。
Moonlight 提示输入 PIN 时：登录 Web UI，在导航栏进入 "PIN" 页面，填入显示的 PIN 和给设备起的名字，配对完成。
回到 Moonlight，选默认自带的 "Desktop"，串流第一次成功。

💡 小贴士：两端在同一局域网内时全程无需配端口；以后想在外网玩，只需开启 upnp 设置，见下一节。

三个真实用法

用法一：串流整个桌面，把 PC 变成常驻家庭服务器

"Desktop" 默认就在应用列表里，无需任何配置。Moonlight 一连上，你的 PC 就变成了另一台设备的"屏幕"：躺在床上刷网页、远程处理文件，都不用回到电脑前。做完这一步，这台 PC 从此可以 24 小时开着当家庭终端。

用法二：把 3A 大作加进串流库

在 Web UI 左侧进 "Applications"，点 "Add New"：填游戏显示名称、可执行文件路径，工作目录和启动参数按需填写，再上传一张 600×800 的图标。点 Save 后，Moonlight 客户端里立刻能看到它，图标和名称都按你填的显示。以后每次开机想玩什么，手机上点一下就行。

用法三：手机、电视上用手柄玩主机级游戏

Moonlight 支持把客户端的手柄"回传"到主机模拟成真实设备：Windows 和 Linux 上可模拟 DS4、DS5、Switch Pro、Xbox 360/One/Series 及通用手柄（macOS 目前不支持手柄）。按文档提示装好主机的 Virtual HID Driver，接上电视和手柄，客厅就能当游戏房用。

调到最佳状态

配置项很多，但官方默认值对大多数人就是最佳值。真正值得动手的只有这几个：

encoder：编码器选谁，取决于你手里有什么 GPU。
max_bitrate：单位 Kbps，默认 0 表示"跟随 Moonlight 客户端的请求"。网络不稳时给它设个上限，比无限拉高画质更实际。
upnp：设为 enabled 后 Sunshine 会自动让路由器开端口，这是外网串流的第一步。
min_log_level：日志级别。排查问题时调低它，配合 "Troubleshooting" 页面看日志。

你的 GPU	推荐编码器	平台说明
NVIDIA	NVENC	Windows / Linux
AMD	AMF / VAAPI	Windows 用 AMF，Linux 用 VAAPI
Intel 核显	QuickSync / VAAPI	Windows 用 QuickSync，Linux 用 VAAPI
Apple 芯片或 Intel（macOS）	VideoToolbox	macOS 整体为实验性支持
无独立显卡	软件编码	兜底方案，兼容性最好

调完之后怎么验证？官方文档给了一条硬标准：在主机和客户端各跑一次 iperf3 测试，丢包率低于 5%、抖动低于 1 ms，这条网络就配得上游戏串流。

卡住了？先自查

Q：忘了 Web UI 的管理员密码怎么办？A：命令行直接重置（记得换成你的新账号密码，不含花括号）：

sunshine --creds {new-username} {new-password}

Q：打不开 https://localhost:47990？A：先确认 Sunshine 在运行（Linux 看 systemd 服务状态，Windows 看系统托盘/服务列表）。从别的设备访问时，把 localhost 换成本机 IP，并检查防火墙是否放行。

Q：Moonlight 发现不了服务器？A：确认两端在同一局域网；远程场景先开 upnp 或手动转发端口；实在不行，在 Moonlight 里手动添加主机 IP。

Q：Steam 里手柄正常，游戏里却不响应？A：在 Steam 的手柄设置里只保留 Generic 控制器支持，并断开主机上其他物理手柄，让 Sunshine 提供的那个成为"第一个"设备。

Q：串流画面卡顿、花屏？A：先用上面的 iperf3 标准确认锅在网络还是编码；再考虑降分辨率或给 max_bitrate 设上限；最后打开 "Troubleshooting" 页逐条看警告和错误。

继续深入

完整安装与使用说明：docs/getting_started.md；全部配置项及默认值：docs/configuration.md
网络、丢包、缓冲溢出等疑难问题：docs/troubleshooting.md
想从源码构建：git clone https://gitcode.com/GitHub_Trending/su/Sunshine，再按 docs/building.md 操作