Sunshine 游戏串流搭建指南：3 条安装路径 + 5 分钟最小配置-创锋一号

Sunshine 游戏串流搭建指南：3 条安装路径 + 5 分钟最小配置

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

想做 Sunshine 游戏串流，不用买云游戏会员：把这台开源服务器装到游戏 PC 上，电视、平板或手机里的 Moonlight 客户端就能低延迟玩到这台机器上的游戏，适合想在大屏上打游戏、或一家人共用一台游戏机的玩家。

🎮 它到底能帮你解决什么问题

你正在卧室墙面上用投影，想晚上躺着打 3A 大作，但不想把游戏机搬进卧室，也不想让键盘声吵到隔壁。配好 Sunshine 游戏串流之后，平板上点一下就能开局，投影接的是 4K 画面流。

你正在公司用笔记本赶工，下午停下的那局游戏却留在家里那台主机上。家里装好串流服务器后，公司网络里打开 Moonlight 连回家里机器，从断点继续打。

你想让孩子玩主机游戏，却不想把整机交出去。Sunshine 可以搭成家庭共享机：每个人用自己的客户端、自己的 PIN 配对，各玩各的，互不干扰。

📦 先跑起来：三条安装路径

Windows：winget 一条命令，或 MSI 安装包

有 winget 的话一条命令装好：

winget install LizardByte.Sunshine

没有的话去项目 Release 页面下载对应架构的 MSI 安装包，双击按向导走完即可，装完默认在后台运行，托盘里能看到图标。

Linux 和 macOS：系统包优先，Flatpak 备选

Linux 发行版很多，官方推荐优先用你发行版对应的系统包（支持的采集后端最全，比如 KMS 抓屏，即 Linux 原生屏幕抓取接口）；Flatpak 和 AppImage 也能用，但会各砍掉一部分功能。Debian/Ubuntu 需先配置官方源（文档里给了一条命令）。macOS 走 Homebrew，首次启动会申请录屏和麦克风权限。

# Linux：系统包（Debian/Ubuntu） sudo apt install sunshine # macOS：Homebrew 安装 brew tap LizardByte/homebrew && brew install sunshine

Docker：当自建容器的底镜像

官方镜像的定位是给你自建容器的底镜像（比如再装个 Steam 做成一体化游戏容器），需要映射三组端口；配置存在容器内/config目录，记得挂一个本地目录：

# 把 /data/sunshine 挂成配置目录 docker run -d --name=sunshine \ -p 47984-47990:47984-47990/tcp -p 47998-48000:47998-48000/udp -p 48010:48010/udp \ -v /data/sunshine:/config lizardbyte/sunshine:latest-ubuntu-24.04

⏱️ 第一次打开：5 分钟最小配置

浏览器打开https://localhost:47990（其他设备访问就换成主机的局域网 IP），提示"不安全"是自签证书导致，继续访问就行。
欢迎页会要求你创建 Web 管理界面的账号，把用户名和密码记下来，后面每次都要用。
左侧菜单进 Applications → Add New，填应用名和游戏 .exe 路径。
手机或平板打开 Moonlight（串流客户端软件，Android、iOS、PC 都有），按 IP 添加主机；客户端会显示一个 PIN（一次性配对码），到主机 Web 界面的 PIN 页输入它并给设备起个名字。
选中游戏，开始串流，就跑通了。

🎛️ 按你的使用场景调

默认配置其实就能用。编码器会默认挑硬件编码：NVENC（N 卡自带的编码芯片，不占 CPU）、AMF（AMD 卡）、QuickSync（Intel 核显），没有硬件编码器才回落到 CPU 软编。每个场景把下面几项微调一下，体验更稳。

卧室投影 4K 串流

参数	推荐值	理由
视频编码器	NVENC / AMF 硬件编码	编码走显卡，CPU 留给游戏
分辨率和帧率	4K @ 60fps	投影原生分辨率，不做二次缩放
码率	30–50 Mbps	4K 要给足余量，减少渐变发色带
HDR	开启（投影支持时）	色域更宽，暗部细节不糊

通勤地铁上的手机串流

参数	推荐值	理由
分辨率和帧率	1080p @ 30fps	手机屏够看，还省带宽
码率	10–15 Mbps	地铁 WiFi 不稳，低码率更少卡死
编码器	HEVC（H.265）	手机芯片解码比 H.264 更省电
输入	蓝牙手柄	单手握持操作，键鼠在手机上很难用

宿舍低带宽凑合玩

参数	推荐值	理由
分辨率和帧率	720p @ 30fps	整层宿舍抢带宽，先求不卡
码率	5–8 Mbps	画质够用就行，别影响舍友
音频码率	96 kbps	笔记本喇叭听不出差别
网络	尽量插网线	WiFi 高峰期拥塞严重，有线更稳

❓ 连不上？查这里

现象	最可能原因	你该做的一个动作
Moonlight 搜不到主机	防火墙拦了发现端口	防火墙放行 47989–47990/TCP 与 47998–48010/UDP
别的设备打不开管理界面	Sunshine 服务没在运行	Windows 看托盘图标；Linux 终端跑`systemctl --user status app-dev.lizardbyte.app.Sunshine`
连上后画面卡顿掉帧	带宽不够或编码过载	先把分辨率降到 1080p、帧率降到 30、码率降到 15 Mbps
没声音	没选音频采集设备	在 Web 界面 Audio 选项里选系统默认输出
手柄没反应	虚拟输入后端没启用	在 Configuration → Input 选驱动并保存，然后重启电脑
画面卡住声音正常	编码负载高或网络丢包	换一个编码器试试，还卡就把帧率降到 30

现象不在表里时，日志页是第一站，每条警告和错误点进去能看到详情。

🧩 再往前走一步

如果你用熟了想折腾一下 Sunshine 游戏串流，有两个方向值得看：

HDR 串流：Windows 主机上显卡支持 10bit 编码的话可以开 HDR 输出，前提是系统里先打开 HDR，Moonlight 客户端那边也要勾上 HDR，否则画面会发白。
应用列表里的外部命令：每个应用都能配启动前命令和环境变量，比如直接拉起 Steam 的大图模式、给特定游戏注入启动参数，省去每次手动操作。

这些选项都能靠配置页顶部的搜索框一次定位。

📚 继续深入

快速开始文档：安装、首次打开、配对完整流程
配置文档：Web 界面每个选项的含义与默认值
排障文档：日志怎么看、常见问题怎么定位

装好它，先把一款游戏串到手机上看个十分钟。

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析