Sunshine 免费游戏串流服务器完整搭建教程
2026/8/28 23:38:02 网站建设 项目流程

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 安装:装完即用

  1. 从 Sunshine 发布页下载最新的 Windows 安装包;
  2. 双击运行,按向导提示逐项确认;
  3. 装完它自己就跑起来了,系统托盘里留着一个常驻图标,随时可唤起。

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

首次进入会看到欢迎页,按下面两步完成基础设置:

  1. 依次填写用户名、密码并再次确认,点击登录——这个本地管理账号是日后管理串流服务器的唯一入口,务必记牢;
  2. 切到顶部的 "Applications" 选项卡,点 "Add New",填写应用名称和可执行文件的完整路径,点 "Save"。

页面自带 Desktop(桌面)与 Steam Big Picture 两个预设,开箱可串。有一条提示很关键:新登记的应用要等客户端重启后才会刷新出来,所以每次加完应用,记得重启一次 Moonlight 再连。

Sunshine 配置进阶:UPnP 端口转发与画质调优

外网串流:打开 UPnP 开关

想在出差时也能连着家里的"主机"玩,需要路由器帮你转发端口(UPnP = 让路由器自动开端口):

  1. 进入 "Configuration" 页面,在搜索框输入 "Upnp";
  2. 在 Network 选项卡下勾选 UPnP 开关,由路由器自动完成端口映射;
  3. 点底部 "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" 即可跳转下载。

首次连接按这个顺序来:

  1. 确认客户端设备与宿主电脑在同一网络;
  2. 打开 Moonlight,它会自动发现局域网里的 Sunshine 主机;
  3. 到 Web 界面的 PIN 选项卡查看 4 位配对码,输入到客户端,完成 Moonlight 配对;
  4. 配对成功,应用列表出现,点选任意应用即可开始串流。

一次配对长期有效,之后打开客户端就能直接进游戏。

串流故障急救:现象与处理对照表

出问题别慌,先按下表对号入座:

现象处理办法
客户端搜不到主机确认两台设备同一局域网;防火墙放行 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询