15 分钟跑起来：用 Sunshine 搭建自己的游戏串流服务器完整上手

15 分钟跑起来：用 Sunshine 搭建自己的游戏串流服务器完整上手

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

想让 PC 游戏库搬进客厅电视，或者出差时在平板上继续游戏进度？Sunshine 是一个开源的游戏串流服务器，能把您现有的 PC 变成自托管串流主机，从安装到第一次成功串流大约只需 15 分钟。下面按官方文档的顺序，把每个步骤都走一遍，您跟着做即可。

🎬 游戏串流适合哪三类场景

周末，您想把一款 3A 大作从桌前挪到客厅的 55 寸电视上，拿个手柄窝在沙发里玩——但游戏只买了 PC 版，云游戏订阅又有画质和延迟的顾虑。

出差时，酒店里刷了会儿手机，突然想接着昨天通关一半的进度；或者人在外面，想远程把家里那台高配机器的游戏开起来，忙完再回来看存档。

还有一种动机更直接：不想再买一台新主机，只想把已有的游戏 PC 用起来，让电视、手机、平板甚至树莓派都能连过来玩。

这三件事的解法其实是同一个：把 PC 变成游戏串流服务器，别的设备只做轻客户端。这正是 Sunshine 做的事情。

🚀 为什么选择 Sunshine 做自托管游戏串流

• 主机端跨平台：Windows、Linux、macOS（实验性）和 FreeBSD 都有官方安装包；客户端一侧，Moonlight 生态覆盖了 PC、手机、平板和嵌入式设备。
• 硬件编码全覆盖：NVIDIA NVENC、AMD AMF/VAAPI、Intel QuickSync 都支持，没有对应显卡时回退 x264/x265 软编码，老机器也能跑。
• Web 界面管理：安装、配置、配对、查日志全部在浏览器完成，不用手工改配置文件。
• 开源且自托管：免费，游戏画面与账号凭证只留在您自己的设备上，不经过任何第三方云。

📦 Sunshine 的安装步骤：按系统各一条路径

Windows（推荐首选）

1. 下载与 CPU 匹配的 MSI 安装包（Intel/AMD 选 AMD64，ARM 选 ARM64）。
2. 双击运行，按向导勾选选项完成安装。
3. 安装器会自动注册系统服务，Sunshine 随开机在后台运行。

Linux

Debian/Ubuntu 下载对应发行版的 deb 包后执行：

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

Fedora 使用官方 copr 仓库：

sudo dnf copr enable lizardbyte/stable sudo dnf install Sunshine

Arch 用户可直接pacman -S sunshine。服务默认随系统启动；如果想手动控制：

systemctl --user start app-dev.lizardbyte.app.Sunshine

提示：Linux 的 NVIDIA 显卡串流依赖 CUDA 驱动，官方打包已内置，自编译时需自行安装。

macOS（实验性）

1. 下载对应架构的 DMG（Apple Silicon 选 arm64，Intel 选 x86_64）。
2. 把 Sunshine.app 拖入应用程序文件夹。
3. 首次启动时授予屏幕录制与麦克风权限。

注意：macOS 版本仍处于实验阶段，手柄输入暂不支持，适合先试画面串流。

🛠️ 首次配置：3 步注册 Sunshine 管理页

1. 浏览器访问https://localhost:47990（可换成局域网 IP），浏览器提示"不安全"是自签名证书的正常现象，继续访问即可。
2. 在欢迎页设置用户名（默认 sunshine）和一组强密码。
3. 点击 Login 登录，进入主控制面板。

注意：密码只显示这一次，请记好；忘了可在主机上运行sunshine --creds 用户名 密码重置。

📱 核心功能实战：添加游戏并连接 Moonlight 客户端

把任意应用加入串流列表

Sunshine 能串流任何可以本地启动的程序，默认已内置 Desktop（桌面）和 Steam Big Picture 两项。

1. 在管理面板进入 Applications 页。
2. 点击 Add New 新建条目。
3. 填写应用名称和可执行文件路径（工作目录、启动参数可选）。
4. 上传一张 600×800 的图标，方便在客户端辨认。
5. 保存，客户端重启后新条目即刻出现。

配对 Moonlight 客户端并开始串流

1. 在目标设备安装 Moonlight，Web 界面的 Featured Apps 页可找到官方客户端入口。
2. 启动后 Moonlight 会自动发现局域网内的 Sunshine；发现不了就手动输入主机 IP 添加。
3. 客户端提示配对时，打开 Sunshine 的 PIN 页，把 PIN 输进客户端并给设备命名。
4. 选中刚添加的游戏启动，画面与音频即刻串到客户端。

⚙️ Sunshine 游戏串流参数推荐：按网络环境选档位

编码器优先选 GPU 对应的硬件编码器（NVENC/AMF/QuickSync），都没有再用 x264 兜底。其余参数对照下表现选：

提示：画面一卡就先降分辨率或比特率，再考虑换编码器，保持流畅优先。

🔍 避坑清单：连接 Sunshine 的高频问题

• 浏览器提示"不安全"→ 自签名证书属正常现象 → 忽略警告继续访问即可。
• Moonlight 发现不了 Sunshine→ 防火墙拦截或不在同一网络 → 放行 47984-47990 端口，或在 Moonlight 中手动按 IP 添加。
• Windows 游戏里没手柄→ 未安装 Virtual HID Driver → 按官方说明装好驱动并重启电脑。
• Linux 起不了硬件编码→ NVIDIA 缺 CUDA 驱动或采集方式不匹配 → 先到 Troubleshooting 页看日志里的具体报错。
• 忘记管理员密码→ 凭证不可找回 → 在主机运行sunshine --creds 用户名 密码重置。
• macOS 手柄没反应→ 实验性版本尚不支持手柄 → macOS 先只用于画面串流。

📚 下一步：文档与进阶路径

• 快速上手指南：各系统的完整安装与启动命令。

• 完整配置手册：全部配置项逐项说明。

• 性能调优指南：按硬件给系统级优化建议。

• 社区支持：登录后在 Web 界面顶部 Resources 标签可直达官方 Discord 获取实时帮助。

• 入门：先跑通一次 1080p 局域网串流，确认无卡顿再动参数。

• 进阶：通读配置手册，重点调编码器、比特率、音频格式三组。

• 深入：阅读 src/platform/linux/ 与 src/nvenc/ 的源码，参与功能开发。

🎯 4 步开始

Sunshine 让您现有的 PC 变成随时可用的游戏串流服务器。现在就动手：1) 按系统安装 Sunshine；2) 在https://localhost:47990注册管理员并添加 2-3 个常玩的游戏；3) 在客户端装 Moonlight 并完成 PIN 配对。第一次串流通的那一刻，后面的调优就水到渠成了。

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