Sunshine 游戏串流服务器 3 步上手:把 PC 游戏串到电视、平板和手机
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一款自托管的游戏串流服务器,搭配 Moonlight 客户端,能把 PC 上的游戏画面低延迟地串到电视、平板或手机。不订阅云游戏、数据不出局域网,硬件编码由你的显卡完成。这篇上手指南覆盖安装、首次登录和第一次串流,外加常用参数与高频问题的处理办法。
🎯 先想清楚:Sunshine 适不适合你
这节回答"值不值得装"。如果你是以下情况,它基本就是为你准备的:想在大屏电视上玩 PC 游戏;想把主机电脑变成全家可用的游戏中心;讨厌云游戏的订阅费和画质损失。反过来,如果你希望关着电脑也能玩(纯云方案)、或宿主是 macOS 且依赖手柄操作,就要慎重——macOS 版本仍是实验性的,手柄模拟不可用。各宿主平台的能力边界如下:
| 宿主平台 | 成熟度 | 编码与输入 |
|---|---|---|
| Windows | 最完整 | NVENC / AMF / QuickSync 等,手柄模拟最全 |
| Linux | 成熟 | VAAPI / NVENC 等,Wayland 下建议 KMS 捕获 |
| macOS | 实验性 | VideoToolbox 硬件编码,手柄暂不支持 |
📋 动手前的准备清单
装之前花两分钟对照这张表,能省掉后面八成麻烦:
| 检查项 | 建议标准 | 说明 |
|---|---|---|
| 宿主显卡 | 支持硬件编码的独立显卡 | 没有独显可退软件编码,但占用 CPU 明显 |
| 网络 | 宿主千兆有线,客户端 5GHz WiFi 或有线 | 串流对丢包比带宽更敏感 |
| 客户端 | 电视/手机/平板装任意 Moonlight 客户端 | 需与宿主同一局域网(或自行做内网穿透) |
| 宿主状态 | 串流期间保持开机且显卡有余量 | Sunshine 是"把本地 PC 变服务器",不是云服务 |
自查提示:宿主 PC 别同时跑高负载任务,串流画质问题多半出在网络和编码环节。
🚀 三步跑起来:安装、登录、第一次串流
安装并启动 Sunshine
Windows 用户从发行版下载 MSI 安装程序双击安装最省事;Linux/macOS 可以直接用包管理器,一次命令解决:
winget install LizardByte.Sunshine # Windows sudo apt install sunshine # Debian/Ubuntu flatpak install flathub dev.lizardbyte.app.Sunshine # 其他 LinuxLinux 下让服务随系统自启:systemctl --user --now enable app-dev.lizardbyte.app.Sunshine;Windows 安装器默认已注册为后台服务,不用额外操作。
登录 Web UI 并完成第一次串流
浏览器打开https://localhost:47990("不安全"警告来自自签名证书,可忽略),首次启动会要求你创建用户名和密码——务必记下来,忘记可用sunshine --creds重置。接着在应用页添加第一个游戏或"Desktop"桌面项,然后在 Moonlight 客户端里手动输入宿主 IP 添加该 PC;当 Moonlight 索要 PIN 码时,回到 Web UI 顶部 PIN 处输入确认即可。
添加好应用后,Moonlight 里点一下就能开始串流,鼠标键盘手柄会同步进画面。
⚙️ 把体验调到最佳:3 个最值钱的参数
调优不用碰几十个选项,先动这三个,全部在 Web UI 的 Audio/Video 页搜索即可。
max_bitrate(单位 Kbps):上限为 0 表示完全跟随 Moonlight 请求。局域网 1080p/60fps 建议给25000,1440p 或高刷可给到50000;客户端带宽一般时先降它再降画质。minimum_fps_target:锁帧目标,60是最稳妥的起点,客户端支持 120Hz 再填120,能避免帧率在 30/60 之间抖动。- 网络侧:客户端优先 5GHz WiFi 或有线;宿主到客户端路径中若存在明显瓶颈(如宿主 2.5G 网卡对端百兆),降低
max_bitrate往往比换路由器见效更快。
🛠️ 遇到问题怎么办:4 个高频问题速查
Moonlight 发现不了主机→ 多半是防火墙拦了串流端口,或两台设备不在同一网段 → 放行 47984、47990、47998 端口,或直接在 Moonlight 里手填宿主 IP。
忘了 Web UI 的账号密码→ 初始密码没抄写下来的常见结局 → 停掉服务后执行sunshine --creds <新用户名> <新密码>重置。
画面能进但手柄/键盘没反应→ 虚拟输入设备权限缺失,Linux 需把运行用户加入input组;Windows 则在 Web UI 的 Input 页选择手柄驱动后端后重启电脑。
间歇性卡顿、提示 buffer overrun→ 宿主发流是每 16ms 一个突发包,慢网段缓冲溢出丢包 → 用iperf3测一下,丢包控制在 5% 以内、抖动 1ms 以下;不达标就降max_bitrate或改有线。
拿不准时看 Web UI 的 Troubleshooting 页,每条警告都能点开看详情:
📚 结语与延伸阅读
装好 Sunshine 之后,你的 PC 就已经是私人云游戏平台了:本地部署、免费、可完全掌控。接下来按需深入:
- 安装与首次配置全流程
- 完整配置项参考
- 故障排查手册
- 性能调优指南
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考