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 步。
- 启动 Sunshine(Windows 已自动运行,Linux 执行上面的 systemctl 命令)。
- 浏览器打开
https://localhost:47990,忽略自签名证书警告;首次打开会让你创建用户名和密码,务必记下来。 - 在顶部导航栏的下拉菜单里选择界面主题,立即体验一下深浅色切换。
- 进入应用管理页,默认已有一个
Desktop应用;点击添加一个 Steam 游戏,填应用名和启动命令即可。
- 在客户端设备安装 Moonlight(Web UI 的 Featured Apps 标签页有各平台入口),添加这台 PC。
- Moonlight 提示输入 PIN 时,回到 Web UI 顶部导航点的 "PIN",输入 PIN 并给设备起名,看到成功提示即可。
- 在 Moonlight 里选中你加的应用,开始串流。中途报错就去 Troubleshooting 标签页查日志,官方文档逐条解释了常见错误。
按需取用:不同玩法配方
这一节把 5 类最常见需求做成表格,直接查着抄。
| 需求 | 做法 | 注意点 |
|---|---|---|
| 串整个桌面 | 直接用内置Desktop应用 | 无启动命令,选中即开始串流 |
| 启动 Steam 游戏 | Detached 命令填steam://rungameid/<游戏ID> | URI 方式兼容性最好 |
| 打开 Steam 大屏模式 | Detached 命令填steam://open/bigpicture | Steam 会自更新,必须用分离命令 |
| 启动 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/NVIDIA | Linux 下规避帧率抖动 |
software | ⭐⭐ | ⭐⭐⭐⭐ | 所有设备 | 兼容兜底,吃 CPU |
encoder = nvenc max_bitrate = 20000max_bitrate单位是 Kbps,用来给码率封顶;设0表示完全跟随 Moonlight 请求值。显卡侧还有两小招:NVIDIA 开 Fast Sync、AMD 开 Enhanced Sync,各能再省约一帧延迟,见 性能调优文档。全量选项(encoder、capture、qp、fec_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 = enabled2. 锁定捕获与编码管线(Linux + NVIDIA + X11 常见组合):
capture = nvfbc encoder = nvenc3. 码率封顶保稳定(弱网环境把画质换流畅):
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),仅供参考