10 分钟搭好自己的云端游戏主机：Sunshine 游戏串流服务器新手指南

10 分钟搭好自己的云端游戏主机：Sunshine 游戏串流服务器新手指南

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

从书房主机到客厅电视

书房里放着一台配置不错的游戏主机，客厅电视、卧室平板、随身笔记本却都得各自为战。Sunshine 是免费开源的自托管串流服务端，配上 Moonlight 客户端，它能把主机的画面和声音实时送到局域网里的任意屏幕，操作指令再原路传回来——你的主机，就此变成一台随叫随到的云端游戏主机。

30 秒看懂 Sunshine

把它想成一场远程视频通话：主机是摄像头那一端，负责抓取屏幕内容交给编码器压缩；GPU 里的硬件编码器（NVENC、AMF、QuickSync、VAAPI 等）承担重活，网络负责把码流送过去；Moonlight 那一端则负责解码、显示，并把你的键鼠、手柄动作原路回传。

Sunshine 的全部配置都在浏览器管理界面里完成，地址是https://localhost:47990（localhost 可换成本机内网 IP），不用手写配置文件。不同显卡在各平台能调用的编码 API 差异明显，装机前先看这张矩阵：

✅ 完全支持，🟡 部分支持，➖ 不适用。同一张卡在 Windows 和 Linux 上能走的路子完全不同。

首次启动 Sunshine Web 管理界面后，页面会引导你创建登录账号。

部署前三问自检

先别急着装，花三十秒回答三个问题。

1. 显卡能不能走硬件编码？

硬件编码能把串流负载从 CPU 挪到 GPU，几乎不占算力；编码器代际越新，同码率下的画质上限越高。没有硬编能力也能用纯软件编码应急，代价是 CPU 占用明显上升。各档画质对硬件的要求：

2. 网络撑得住吗？

最低 5GHz Wi-Fi（802.11ac）能跑，想上 4K 或 HDR 就换千兆有线，带宽余量直接决定卡顿频率。

3. 你的平台在支持列表里吗？

Windows、Linux、macOS 均有官方打包，FreeBSD 也在维护范围内。macOS 目前属于实验性平台，手柄不可用，介意的话先观望。

安装 Sunshine

三个平台都只给一条最短路径。

Windows 安装命令

winget install LizardByte.Sunshine

也可以用官方 MSI 安装器，装完会自动注册为 Windows 服务。

Linux 安装命令

sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.deb

Ubuntu/Debian 下载对应.deb即可；Arch 系走 pacman 仓库：

pacman -S sunshine

装完终端直接运行sunshine启动，或者用 systemd 服务开机自启。

macOS 安装命令

brew install sunshine

记得先brew tap LizardByte/homebrew添加源；首次启动会申请屏幕录制与麦克风权限，照实授权。

另外项目官方镜像也有 Docker 方案，但官方文档明确提示：Docker 并非多数用户的最佳选择，没有特殊需求就别绕这条路。

第一次连接 Sunshine

Web 界面的 Featured Apps 页集中提供 Moonlight 客户端下载与各平台工具入口。

从装完到出画面，完整流程是六步：

1. 启动服务（Windows 服务自启，Linux/macOS 运行sunshine）；
2. 浏览器打开https://localhost:47990，首次访问会要求设置管理员账号和密码，记牢这组凭证；
3. 浏览器提示"网站不安全"属正常现象——自签名 SSL 证书所致，直接继续访问；
4. 在 Applications 页管理串流入口，Desktop 和 Steam Big Picture 两个条目默认就在，随时可以再加游戏或任意命令；
5. 到 Featured Apps 页下载 Moonlight 客户端，手动添加主机的内网 IP；
6. Moonlight 显示 PIN 码后，回到 Web 界面的 PIN 页输入该 PIN 并给设备命名，配对完成，选一个应用即可开串。

跑起来之后记两个热键，都以Ctrl+Alt+Shift开头：Ctrl+Alt+Shift+N切换鼠标指针显隐，远程操作桌面时很顺手；多显示器主机用Ctrl+Alt+Shift+F1~F12切换要串流的输出。

把体验调到上限

手柄模拟与虚拟手柄驱动

Sunshine 能把主机虚拟成多种手柄，让客户端按键原样映射过去，各平台覆盖范围：

两个关键动作：Windows 上需另装 Virtual HID Driver，入口就在 Web 界面 Troubleshooting 页的一键安装按钮（它取代了旧的 ViGEmBus 方案），装完建议重启；Linux/FreeBSD 则要把运行 Sunshine 的用户加入input组：

sudo usermod -aG input $USER

改完重新登录生效。macOS 因平台限制暂不支持手柄，只能先用键鼠。

HDR 串流设置

HDR 的坑在于两端都要开：主机系统本身要处于 HDR 状态（无 HDR 显示器可考虑 EDID 模拟器），Moonlight 客户端设置里也要同步打开 HDR 选项，否则画面会偏色甚至整体过曝。Windows 主机已正式支持，编码端需要 GPU 支持 HEVC Main 10 或 AV1 10-bit；Linux 属于实验性支持，要求 KMS 捕获后端，搭配 Gamescope 或 KDE Plasma 6 这类支持 HDR 合成的桌面环境。

公网访问与端口配置

在 Web 界面搜索框输入关键词，可直接跳转到对应的配置项修改。

所有参数都能在 Web 界面搜到并修改，输入upnp两个字就能定位到端口转发开关。图省事就打开UPnP，让路由器自动完成公网映射；流媒体端口默认落在47984–48010区间。习惯改文件的，也可以编辑~/.config/sunshine/sunshine.conf：

upnp = true port_start = 47984 port_end = 48010 bitrate = 25000

码率别盲目拉高：1080p 下 20–30 Mbps 是合理起点，网络留足余量比极限参数更稳。

踩过的坑都有对照表

遇到拿不准的问题，直接看 Web 界面 Troubleshooting 页的日志，错误分级展示、支持搜索，多数线索第一屏就能看到。

下一步

先跑通 1080p，再逐格上调帧率和码率，找到你网络条件下的甜点值，比照搬任何配置都靠谱。安装包去项目 Releases 页面按平台下载，源码可 clone 仓库 https://gitcode.com/GitHub_Trending/su/Sunshine 自行构建，更多细节看 docs/ 官方文档。

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