Sunshine游戏串流主机5分钟上手完整指南
2026/9/11 19:38:55 网站建设 项目流程

Sunshine游戏串流主机5分钟上手完整指南

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

在客厅沙发上、卧室床上,你能不能直接用电视和手柄玩主机里的 3A 大作?Sunshine是一个自托管的游戏串流服务器,配合 Moonlight 客户端,把 PC 上的游戏画面以低延迟实时送到任意设备。读完这篇,你会在 10 分钟内完成安装、配对,并跑通第一次游戏串流。

它替你把什么难题解决了

这一节先说清楚 Sunshine 适合解决哪 3 类问题,帮你判断是否值得装。

  • 换设备玩同一个游戏库:主机电脑不动,电视、平板、手机装 Moonlight 客户端就能串流过去,一套存档多端共用。
  • 硬件编码压低延迟:NVENC、AMD VCE、Intel QuickSync 等 GPU 编码器直接参与工作,软件编码仅作兜底,局域网内延迟可压到毫秒级。
  • 网页端集中管理:添加应用、搜索配置项、审批配对 PIN,全部在浏览器里完成,不用碰命令行。
  • 手柄虚拟注入:客户端的手柄会被虚拟成 Xbox、DualSense 等主机设备传给游戏,无需额外映射工具。

5分钟跑起来

这一节只给最短路径:Windows 上一条命令装完,其余平台按表格自选。

winget install LizardByte.Sunshine

安装完成后 Windows 默认注册为系统服务并自动启动。其他安装方式如下:

平台方式说明
Linux (Debian/Ubuntu)sudo apt install sunshine先按 安装指南 配置 Cloudsmith 仓库
Linux (Fedora)sudo dnf install Sunshine包名区分大小写
Linux 通用下载.AppImage后运行--install不支持 KMS 捕获,优先用发行版原生包
macOS下载 DMG 拖入 Applications手柄暂不支持,属实验性功能
容器Docker 镜像官方提示多数用户不推荐

Linux 装完用这条命令启动并设为开机自启:

systemctl --user --now enable app-dev.lizardbyte.app.Sunshine

第一次使用的完整走通

这一节按时间顺序走一遍:从打开网页到第一次串流成功,全程 7 步。

  1. 启动 Sunshine(Windows 已自动运行,Linux 执行上面的 systemctl 命令)。
  2. 浏览器打开https://localhost:47990,忽略自签名证书警告;首次打开会让你创建用户名和密码,务必记下来
  3. 在顶部导航栏的下拉菜单里选择界面主题,立即体验一下深浅色切换。

  1. 进入应用管理页,默认已有一个Desktop应用;点击添加一个 Steam 游戏,填应用名和启动命令即可。

  1. 在客户端设备安装 Moonlight(Web UI 的 Featured Apps 标签页有各平台入口),添加这台 PC。
  2. Moonlight 提示输入 PIN 时,回到 Web UI 顶部导航点的 "PIN",输入 PIN 并给设备起名,看到成功提示即可。
  3. 在 Moonlight 里选中你加的应用,开始串流。中途报错就去 Troubleshooting 标签页查日志,官方文档逐条解释了常见错误。

按需取用:不同玩法配方

这一节把 5 类最常见需求做成表格,直接查着抄。

需求做法注意点
串整个桌面直接用内置Desktop应用无启动命令,选中即开始串流
启动 Steam 游戏Detached 命令填steam://rungameid/<游戏ID>URI 方式兼容性最好
打开 Steam 大屏模式Detached 命令填steam://open/bigpictureSteam 会自更新,必须用分离命令
启动 Epic 游戏URI 或 exe 加工作目录详见 应用启动示例
找到 Moonlight 客户端打开 Web UI 的 Featured Apps 标签页各平台均有官方客户端

macOS 用户注意:Audio Sink 留空即可走系统原生音频采集;Linux 上 Flatpak 启动的命令要加flatpak-spawn --host前缀。

更快更稳:调优对照表

这一节对比 6 种编码器的取舍,并给一段可直接放进sunshine.conf的配置。

编码器延迟画质兼容性推荐场景
nvenc(NVIDIA)⭐⭐⭐⭐⭐⭐⭐⭐⭐NVIDIA 卡主流游戏串流
amdvce/vaapi(AMD)⭐⭐⭐⭐⭐⭐⭐⭐AMD 卡Windows / Linux
quicksync(Intel)⭐⭐⭐⭐⭐⭐⭐⭐Intel 核显Windows
vulkan⭐⭐⭐⭐⭐⭐⭐⭐AMD/Intel/NVIDIALinux 下规避帧率抖动
software⭐⭐⭐⭐⭐⭐所有设备兼容兜底,吃 CPU
encoder = nvenc max_bitrate = 20000

max_bitrate单位是 Kbps,用来给码率封顶;设0表示完全跟随 Moonlight 请求值。显卡侧还有两小招:NVIDIA 开 Fast Sync、AMD 开 Enhanced Sync,各能再省约一帧延迟,见 性能调优文档。全量选项(encodercaptureqpfec_percentage等)以 配置参考 为准。

踩坑自救:高频问题速查

这一节用 6 个高频故障的"现象→原因→解决"帮你 1 分钟定位问题。

现象原因解决
打不开 Web UI防火墙拦了 47990 端口检查防火墙规则并放行
忘记管理账号密码凭据只存本机运行sunshine --creds 新用户 新密码
Linux 键盘/手柄无输入用户不在 input 组或 udev 未重载sudo usermod -aG input $USER后重启
NVIDIA 下 KMS 捕获黑屏内核未开 modeset内核参数加nvidia_drm.modeset=1
周期性卡顿、丢包链路瓶颈导致缓冲区溢出用 iperf3 测稳定性,必要时降主机网卡速率
Windows 游戏不认键盘/鼠标Virtual HID 驱动版本或许可问题看 Web UI Troubleshooting 页检查状态

排查思路固定三步:先开 Troubleshooting 页按提示过一遍日志警告,再确认网络(串流看重的是抖动和丢包,不是裸带宽),最后才去动权限、驱动这类底层项。更多细节查 故障排查文档。

进阶玩法与资源导航

这一节给 3 个进阶开关和全部值得收藏的入口。

1. 互联网远程串流:让路由器自动开端口,出门在外也能连:

upnp = enabled

2. 锁定捕获与编码管线(Linux + NVIDIA + X11 常见组合):

capture = nvfbc encoder = nvenc

3. 码率封顶保稳定(弱网环境把画质换流畅):

max_bitrate = 5000

资源导航:

  • 安装与初始设置:docs/getting_started.md
  • 全部配置项:docs/configuration.md
  • 应用启动写法:docs/app_examples.md
  • 故障排查:docs/troubleshooting.md
  • 性能调优:docs/performance_tuning.md
  • 主程序源码:src/

从装好到第一次串流通常只要 10 分钟,你的 PC 从现在起就是一台随叫随到的游戏服务器。

  • ✅ 安装 Sunshine 并确认服务在运行
  • ✅ 打开 47990 端口页面并记住凭据
  • ✅ 添加第一个 Steam 应用
  • ✅ 安装 Moonlight 并完成 PIN 配对
  • ✅ 用 iperf3 验证一次网络稳定性

串流的世界没有主机与掌机的边界,祝你玩得尽兴 🎮

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

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

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

立即咨询