Sunshine游戏串流5步搭建指南
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一个开源的自托管游戏串流服务器。把它装在自己的电脑上,就能通过 Moonlight 客户端,把整台 PC 的游戏画面串流到电视、手机或平板。数据全程走你的局域网,不经过任何外部云服务。本教程面向有基本电脑操作能力的用户,按步骤走完大约 10 分钟即可看到效果。
🎮 Sunshine游戏串流与云游戏的区别
Sunshine 和腾讯 Start 这类云游戏最大的不同:串流主机就是你自己的电脑,画面由你显卡上的硬件编码器(NVIDIA 的 NVENC、AMD 的 AMF、Intel 的 QuickSync)实时压成视频,再传给 Moonlight 客户端。延迟低、不花月费、画质上限由你的硬件决定,代价是需要自己配一台常年开机的电脑和一个稳定的局域网。
📦 安装 Sunshine:各平台最简路径
从官方发布页下载对应平台的安装包即可,不需要从源码编译。
Windows 系统
下载 AMD64 的 MSI 安装程序,双击运行,按向导走。安装时注意手动勾选你需要的可选项,不要无脑全部接受。装完后 Sunshine 以 Windows 服务方式在后台运行,任务栏托盘能看到图标。
Linux 系统
Debian/Ubuntu 下载对应版本的 deb 包,执行sudo dpkg -i ./sunshine-*.deb安装;Fedora 用户装 rpm 包。发行版没有原生包时,Flatpak 是通用备选。
macOS 系统
下载 DMG,把 Sunshine.app 拖进应用程序文件夹即可,也可以用 Homebrew 执行brew install sunshine。注意 macOS 版目前是实验性质,暂不支持手柄输入。
🖥️ 首次启动并完成 Web 配置
安装完成后,Sunshine 会自动生成配置。默认配置目录:Windows 在%ProgramFiles%\Sunshine\config,Linux/macOS 在~/.config/sunshine。按下面 5 步走一遍:
- 启动服务:Linux 执行
systemctl --user --now enable app-dev.lizardbyte.app.Sunshine,Windows 安装后已默认随系统启动。 - 浏览器打开
https://localhost:47990,首次访问会让你创建登录账户,浏览器提示"不安全"是正常的(自签名证书),忽略即可。 - 在导航栏的下拉菜单里选择界面主题和语言,深色主题适合夜间串流。
- 切到 Featured Apps 标签页,确认能看到各平台的 Moonlight 客户端。
- 切到 Troubleshooting 标签页扫一眼,确认没有红色错误项。
🕹️ 配对 Moonlight 完成第一次串流
这是第一个真实使用场景,全程不超过 3 分钟:
- 在电视、手机或平板上安装 Moonlight 客户端(各平台通用,名字就叫 Moonlight)。
- 客户端会自动发现局域网内的 Sunshine,点击添加;手动添加时填主机 IP 即可。
- Moonlight 弹出 6 位 PIN 码时,回到 Sunshine 网页,点导航栏的 PIN,输入同一串数字并给设备起个名字。
- 配对成功后,客户端列表里会出现 Sunshine 默认自带的 Desktop 应用,点它就能直接串流整个桌面。
串流中所有快捷键都以Ctrl+Alt+Shift开头,例如Ctrl+Alt+Shift+F1到F12可以切换串流哪块显示器。
⚙️ 管理应用列表:如何配置你的游戏
应用列表在 Web 界面的 Applications 标签页维护,串流时 Moonlight 看到的每一个入口都对应这里的一条记录。
桌面模式
默认的 Desktop 应用不需要任何命令,选中即串流桌面,适合远程办公或多任务场景。如果你删掉了它,新建一个名为 Desktop 的应用即可恢复。
Steam 大屏模式
新建应用,命令填steam://open/bigpicture,类型选 Detached(分离式,避免 Steam 主进程退出时串流中断),就能在电视上直接进 Steam 大屏选游戏。
自定义游戏
填三样东西:启动命令(可执行文件加参数)、工作目录、显示名称和图标。支持环境变量,比如用$(HOME)代表用户主目录。更多例子仓库里有现成参考。
📶 如何优化编码器与网络让串流更顺
影响体验的两个变量:编码器和网络。按你显卡的厂商选编码器:
| 场景 | 推荐值 | 说明 |
|---|---|---|
| NVIDIA 显卡 | NVENC | 延迟与画质最均衡,首选 |
| AMD 显卡 | AMF(Windows)或 VAAPI | 平衡模式表现较好 |
| Intel 显卡 | QuickSync | 核显上性能优先 |
| 显卡太旧不支持 | 软件编码 | 吃 CPU,建议降分辨率 |
网络端一个典型家庭拓扑长这样:
游戏主机(运行 Sunshine,网线连接) ├─ 有线 → 客厅电视(Moonlight) ├─ 5GHz WiFi → 平板(Moonlight) └─ 5GHz WiFi → 手机(Moonlight)主机端尽量走千兆有线;客户端优先 5GHz WiFi,官方建议最低 802.11ac。串流对网络的敏感点不是峰值带宽,而是稳定性:延迟波动小、丢包少比"跑分高"更重要。
如果效果不理想,调哪里
- 先打开 Troubleshooting 标签页,逐条看警告和错误,编码器报错优先更新显卡驱动。
- 画面卡顿:在配置里降低分辨率或码率,搜索栏直接搜
bitrate就能找到相关项。 - 延迟偏高:NVIDIA 用户在显卡驱动里开启 Fast Sync,AMD 用户开启 Enhanced Sync,可以各省一帧左右延迟。
- 频繁掉线:主机与客户端都用有线,或把路由器 QoS 向串流流量倾斜;无线环境下先测信号强度。
🛠️ 查看日志并快速解决常见问题
Sunshine 的问题排查入口集中在两个地方:Web 界面的 Troubleshooting 标签页(可在线浏览、逐条展开日志),以及配置目录下的sunshine.log文件。忘了 Web 登录密码时,命令行执行sunshine --creds 新用户名 新密码可以重置。
| 现象 | 可能原因 | 处理动作 |
|---|---|---|
| 打不开 47990 网页 | 防火墙拦截 | 放行 47990 端口或加例外规则 |
| 配对失败 | PIN 没及时输入 | 网页 PIN 入口输入 6 位码并命名设备 |
| 手柄在客户端无响应 | 驱动或权限缺失 | Windows 装 Virtual HID 驱动;Linux 把用户加入input组 |
| 串流中丢帧严重 | 网络不稳定 | 改有线,或降低分辨率与码率 |
| 编码器报错 | 显卡驱动过旧 | 更新驱动后重启 Sunshine |
常用文档都在仓库里,遇到问题按顺序查:
- 入门与安装:docs/getting_started.md
- 全部配置项说明:docs/configuration.md
- 应用配置示例:docs/app_examples.md
- 故障排查专题:docs/troubleshooting.md
总结:记住这几点就够了
- 有线比无线稳,5GHz 优先
- 编码器跟着显卡厂商选
- 码率跟着带宽调,宁低勿卡
- Web 界面就是控制中心
- 出问题先看 Troubleshooting 日志
按上面的步骤操作,10 分钟左右你就能在另一台设备上看到自己 PC 的画面。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考