Sunshine 游戏串流服务器教程：从安装到第一次串流的完整指南

Sunshine 游戏串流服务器教程：从安装到第一次串流的完整指南

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

想把客厅电视、平板或手机变成一台能跑 PC 游戏的终端，又不愿意依赖商业云游戏服务？Sunshine 是一款开源、自托管的游戏串流服务器，免费运行在你自己的电脑里，负责采集画面、编码视频，再推送到 Moonlight 客户端，两者搭配即可组成一套完整的串流方案。支持 Windows、Linux 和 macOS（后者为实验性支持），下面从安装讲到你第一次成功串流。

为什么选择 Sunshine

• 跨系统运行：主机端覆盖 Windows、Linux、macOS，客户端走 Moonlight 生态，手机、平板、树莓派、电视盒子都能连。
• 硬件编码：N 卡用 NVENC（NVIDIA 显卡自带的硬件编码器），A 卡用 AMF，Intel 核显走 QuickSync，把编码压力从 CPU 转给 GPU；没有合适显卡时还能退回 x264/x265 软件编码。
• 数据留在本地：画面、音频、游戏进度都在你机器上，不经过第三方云端。
• 开源免费：无订阅、无授权费，社区持续维护，可用现有设备直接搭建。

Sunshine 安装与首次配对步骤

三个系统的主线其实是一条流程：装好 → 打开管理页 → 创建账户 → 用 PIN 配对。下面按系统只保留必须的命令。

Windows

从官方发布页下载对应架构的 MSI 安装包（Intel/AMD 选 AMD64，ARM 设备选 ARM64），双击按向导完成。安装程序会注册后台服务，开机自启，无需手动操作。

Linux

按发行版选包：

# Debian/Ubuntu sudo dpkg -i ./sunshine-{distro}-{arch}.deb

Arch 用户可先添加 LizardByte 仓库再pacman -S sunshine；Fedora/OpenSUSE 可用官方 rpm 或 Copr 源：

sudo dnf copr enable lizardbyte/stable sudo dnf install Sunshine

装好后用 systemd 用户服务启动并设为开机自启：

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

macOS（实验性）

下载对应芯片的 DMG（Apple Silicon 选 arm64，Intel 选 x86_64），把 Sunshine.app 拖进「应用程序」文件夹。首次启动会要求授予屏幕录制与麦克风权限。注意 macOS 版目前不支持手柄。

创建账户与 PIN 配对

安装完成后浏览器打开https://localhost:47990（浏览器会提示证书不受信任，属自签名证书，忽略即可），首次进入是欢迎页，要求设置用户名和密码。这里有两点务必注意：

• 凭据只在页面上显示一次，关掉就再也看不到，务必当场记到安全的地方。
• 勾选同意条款后点击 Login 进入主界面。

在 Moonlight 客户端发起连接时，它会向你要一个 PIN。登录 Sunshine 的 Web 界面，顶部导航点进「PIN」页，把当前 PIN 输入客户端并给设备起个名字即可完成配对。PIN 大约每 5 分钟轮换一次，配对时以当时显示的为准。局域网内客户端通常能自动发现服务器；找不到时可在 Moonlight 里手动输入主机 IP。

添加要串流的应用

进入「Applications」页，点击「Add New」填写几个字段：

• 名称：显示在客户端里的名字，比如某个游戏名。
• 可执行文件路径：游戏主程序的位置，客户端点击时就是启动它。
• 工作目录（可选）：程序所在目录，某些游戏需要。
• 图标（可选）：上传一张图片，会显示在客户端列表里。

系统默认已带「Desktop」（直接串流整个桌面）和「Steam Big Picture」两个条目，方便快速开始。

两条实用技巧：

• 整库串流：与其给每款游戏单独建条目，不如直接串流 Steam Big Picture，进库后再选具体游戏，省事且不易出错。
• 快捷方式：没有主程序直连的游戏，可以建一个启动它的快捷方式或脚本，再把快捷方式路径填进来。

串流参数设置速查

参数都在「Configuration」页，顶部有搜索框，直接输入关键词定位即可。常见项按场景给出建议值：

编码器优先级：能用硬件编码就用 NVENC、AMF、QuickSync 这类 GPU 方案，延迟低、占用小；CPU 较弱或显卡太旧时才退回 x264/x265 软件编码。

音频与网络两项用默认即可：

• 音频格式：默认 Opus（低延迟、质量均衡），保持不动通常就够。
• UPnP 端口转发：默认关闭。若要在外网访问，把它设为enabled，Sunshine 会自动在路由器上开端口，省去手动映射。
• 端口范围：默认使用 47984–47990，其中 47990 是 Web 管理页；自定义前确认防火墙放行这一段。

常见问题速解

现象：忘了管理员密码。解决：用命令行重置，把用户名和密码换成新值后保存。

sunshine --creds 新用户名 新密码

现象：客户端找不到服务器。解决：确认设备与主机在同一网络，检查防火墙是否放行 47984–47990，确认 Sunshine 服务在运行；仍不行就在 Moonlight 里手动填入主机 IP。

现象：画面卡顿或延迟偏高。解决：先降分辨率或比特率，换用硬件编码，关闭占用带宽的其他程序；有线比无线更稳，能插网线就别用 Wi-Fi。

现象：手柄不识别或没反应。解决：确认 Sunshine 提供的手柄在系统里排在第一；Linux 下把运行 Sunshine 的用户加入input组；Windows 下确认虚拟手柄驱动（libvirtualhid / ViGEm）已装好并重启过。

排错时还有一条通用路径：Web 界面的「Troubleshooting」页会上传日志并逐条列出告警，顺着错误信息往往能直接定位问题。

下一步与更多资源

基础串流跑通后，可以继续深入官方文档（仓库内相对路径）：

• 快速上手指南：安装、各平台启动命令、配对细节。
• 完整配置手册：逐项解释每个配置项。
• 性能调优指南：按硬件给出延迟与画质调校建议。
• 故障排查：凭据重置、日志分析的更多命令。
• 第三方包说明：了解非官方分发的差异与风险。

社区方面，可以在 Web 界面的「Featured Apps」页找到 Moonlight 的 PC、Android、嵌入式等各端客户端及其文档入口，也可参与翻译或提交改进。建议的学习节奏：先跑通局域网串流，再逐项调优画质与延迟，最后尝试外网访问和自定义应用，逐步把整套方案用到满意。

把主机装好、浏览器里建好账户，再在 Moonlight 客户端输入 PIN 完成配对，你就已经完成了最难的一步。剩下的，只是挑一个想玩的游戏，点下开始。

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