Sunshine 免费游戏串流服务器完整搭建教程
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
把 Sunshine 装进你现有的电脑,它就变成一台免费开源的游戏串流服务器:游戏画面与声音被实时推送到手机、平板或客厅大电视上,搭配 Moonlight 客户端使用,全程零订阅费。这篇教程带你走完 Sunshine 安装、Web 界面配置与 Moonlight 配对三步,最终在自家网络里跑通一条低延迟串流链路。
串流链路一分钟看懂:输入、编码、推流、显示
Sunshine 做的事并不神秘。整条链路只有四个环节,记住这条主线,后面每一步配置都能对号入座:
| 环节 | 谁在做 | 干什么 |
|---|---|---|
| 输入回传 | Moonlight 客户端 | 把手柄、键鼠操作实时发回游戏电脑 |
| 画面采集 | Sunshine 宿主端 | 捕获游戏画面与声音 |
| 实时编码 | Sunshine(GPU 硬件编码,显卡直接压缩画面) | 压成视频流推送给客户端 |
| 解码显示 | Moonlight 客户端 | 还原画面,等待你的下一帧操作 |
你真正要盯住的只有延迟:编码和网络每多耗几毫秒,手感就"肉"几毫秒。后文会专门讲怎么压低游戏串流延迟。
开工前检查:硬件、网络与设备清单
动手前花 10 分钟对照下表,能省掉后面大半的返工:
| 检查项 | 要求 | 备注 |
|---|---|---|
| 宿主系统 | Windows 10/11、主流 Linux 发行版、macOS | 三大平台官方均支持 |
| 显卡 | 有独显更佳 | NVIDIA / AMD / Intel 都有对应硬件编码 |
| 网络 | 局域网即可 | 路由器支持 UPnP 时,外网串流更省心 |
| 客户端设备 | 能装 Moonlight 的设备 | 手机、平板、电视盒子、树莓派均可 |
不需要注册任何云端账号,画面数据只在你自己的网络里流动。这就是"自建串流服务器"(自托管,服务跑在你自己电脑上)的全部含义。
分平台安装 Sunshine:Windows、Linux、macOS
Windows 安装:装完即用
- 从 Sunshine 发布页下载最新的 Windows 安装包;
- 双击运行,按向导提示逐项确认;
- 装完它自己就跑起来了,系统托盘里留着一个常驻图标,随时可唤起。
Linux 安装:构建脚本一条龙
# 克隆 Sunshine 源码仓库 git clone https://gitcode.com/GitHub_Trending/su/Sunshine # 进入项目目录 cd Sunshine # 运行官方构建脚本,自动拉取依赖、编译并安装 ./scripts/linux_build.sh第一次跑会拉取并编译一堆第三方依赖,等得久一点属预期内;提前确认系统已装 git 和基础编译工具链。
macOS 安装:Homebrew 一行命令
# 通过 Homebrew 安装 Sunshine brew install sunshine首次登录 Sunshine Web 界面:创建账号与登记应用
装完打开浏览器,访问 Sunshine 的管理入口:
http://localhost:47990首次进入会看到欢迎页,按下面两步完成基础设置:
- 依次填写用户名、密码并再次确认,点击登录——这个本地管理账号是日后管理串流服务器的唯一入口,务必记牢;
- 切到顶部的 "Applications" 选项卡,点 "Add New",填写应用名称和可执行文件的完整路径,点 "Save"。
页面自带 Desktop(桌面)与 Steam Big Picture 两个预设,开箱可串。有一条提示很关键:新登记的应用要等客户端重启后才会刷新出来,所以每次加完应用,记得重启一次 Moonlight 再连。
Sunshine 配置进阶:UPnP 端口转发与画质调优
外网串流:打开 UPnP 开关
想在出差时也能连着家里的"主机"玩,需要路由器帮你转发端口(UPnP = 让路由器自动开端口):
- 进入 "Configuration" 页面,在搜索框输入 "Upnp";
- 在 Network 选项卡下勾选 UPnP 开关,由路由器自动完成端口映射;
- 点底部 "Save" 保存生效。
只在局域网内玩的话,这一步可以跳过,默认配置直接就能串。
画质与延迟参数怎么设
- 编码器:在配置页按显卡品牌选对应方案,NVIDIA 用 NVENC(NVIDIA 显卡上的硬编模块),AMD 与 Intel 各有硬件编码支持;
- 码率与分辨率:有线网络可以拉高,Wi-Fi 先保守设,再逐步上调找平衡点;
- 帧率:和显示器刷新率对齐,高刷屏设备值得开更高帧率。
想深挖编码器细节,读一读 docs/performance_tuning.md 就够了。
Moonlight 配对教程:从 PIN 码到开玩
Sunshine 只负责"发",画面要显示得靠 Moonlight 客户端。Web 界面的 "Featured Apps" 页面列出了各平台客户端:桌面版(Windows / macOS / Linux)、Android 版,还有面向树莓派等嵌入式 Linux 的版本,点 "Get" 即可跳转下载。
首次连接按这个顺序来:
- 确认客户端设备与宿主电脑在同一网络;
- 打开 Moonlight,它会自动发现局域网里的 Sunshine 主机;
- 到 Web 界面的 PIN 选项卡查看 4 位配对码,输入到客户端,完成 Moonlight 配对;
- 配对成功,应用列表出现,点选任意应用即可开始串流。
一次配对长期有效,之后打开客户端就能直接进游戏。
串流故障急救:现象与处理对照表
出问题别慌,先按下表对号入座:
| 现象 | 处理办法 |
|---|---|
| 客户端搜不到主机 | 确认两台设备同一局域网;防火墙放行 Sunshine 端口(Web 管理 47990,串流数据 47998–48000) |
| 画面卡顿、模糊 | 优先换有线网;降码率或分辨率;关掉占带宽的程序 |
| 黑屏或启动失败 | 检查显卡驱动与编码器状态,再查日志定位报错 |
| 手柄 / 键鼠无响应 | 确认客户端已识别输入设备,检查宿主机输入相关配置 |
定位问题时打开 Web 界面的日志页,把报错截图保存,无论自查还是求助社区都高效很多:
更多疑难可以查 docs/troubleshooting.md。
到这里,一条免费的自建游戏串流链路就算通了。建议下一步把 docs/getting_started.md 过一遍补齐细节,之后去 LizardByte 社区交流你的串流配置。现在,打开电视,开始你的第一场远程 3A 吧 🎮
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考