Sunshine 自托管游戏串流教程：十分钟把 PC 变成你的私有云游戏主机

Sunshine 自托管游戏串流教程十分钟把 PC 变成你的私有云游戏主机【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine下午在书房卡在一个 Boss 前晚上窝在沙发上想接着打——只要那台游戏主机没关Sunshine一款免费开源的自托管游戏串流服务器就能把主机画面通过网络实时送到你的电视、平板或手机上操作照样落回主机。搭配 Moonlight 客户端Moonlight 配对 是整套流程里最顺的一步这套组合就是目前自托管游戏串流方案里口碑最好的那一个。本文按先懂它 → 对号入座 → 落地跑通 → 逐步拉满 → 翻车自救的顺序带你走完全部流程。它到底替你做了什么一句话Sunshine 装在游戏主机上当发射端Moonlight 装在任何终端上当接收端。主机侧先截屏再把原始画面丢给 GPU 的硬件编码器NVENC、VAAPI 这些名字指的都是显卡里专门压视频的电路压缩工作几乎不占 CPU打包成视频流经网络送到客户端客户端解码出画面同时把你的键鼠、手柄动作原路回传给主机。整条采集 → 硬件编码 → 传输 → 解码 → 回传输入的链路里Sunshine 负责前三段Moonlight 负责后两段两边一握手就形成低延迟的交互闭环。所有设置都放在浏览器的 Web 管理界面里完成默认地址https://localhost:47990不写配置文件也能跑起来。首次打开 Web 界面时会引导你创建登录凭证页面本身集成了官方文档与社区入口。先对号再动手买不买新硬件之前先按你心里的目标档位对号入座。下面的数据来自项目仓库的系统要求表目标档位CPU内存NVIDIA 显卡AMD 显卡Intel 显卡网络720p 尝鲜酷睿 i3 / 锐龙 3 及以上4GB 及以上支持 NVENC 即可VCE 1.0 及以上VAAPI 兼容 / Skylake 及以上5GHz Wi-Fi802.11ac1080p 流畅酷睿 i5 / 锐龙 5 及以上8GB 及以上桌面端 GTX 1080VCE 3.1 及以上HD Graphics 510 及以上 / QuickSync千兆有线CAT5e4KHDR 拉满酷睿 i5 / 锐龙 5 及以上8GB 及以上Pascal 架构GTX 10 系及以上VCE 3.4 及以上HD Graphics 730 及以上千兆有线CAT5e选卡的另一张依据是编码 API 支持矩阵——同一张卡在不同系统里走的编码通道完全不同同一张 AMD 卡在 Windows 上走 AMF换到 Linux 就改走 VAAPINVIDIA 在 Linux 下除了 NVENC 也有 VAAPI 可选编码 API通俗解释适用显卡WindowsLinuxmacOSFreeBSDNVENCNVIDIA 卡自带编码器NVIDIA✅✅➖➖AMFAMD 在 Windows 上的编码通道AMD✅➖➖➖QuickSyncIntel 核显硬件编码Intel✅➖➖➖VAAPILinux/FreeBSD 上的通用编码接口AMD / Intel / NVIDIA➖✅➖✅Vulkan Video新一代 Vulkan 标准编码接口AMD / Intel / NVIDIA➖✅ / ➖Video ToolboxApple 系统自带编码框架Apple / Intel➖➖✅➖软件编码纯 CPU 压视频应急能用任意 CPU✅✅✅✅✅ 完全支持 部分支持➖ 不适用。规律很清楚只要显卡里那块编码电路能用压视频基本不消耗 CPU编码器越新同码率下画质上限越高纯软件编码能跑通但 CPU 会先喊累。十分钟落地装好服务、完成配对十分钟内能走完。Windows推荐 MSI 安装器会顺手注册成后台服务也可以让系统自带包管理器代劳# winget 一键安装Windows 10/11 winget install LizardByte.SunshineLinuxUbuntu/Debian 直接装.deb包Arch 走 PKGBUILD编译前先补齐可选依赖sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.deb # Ubuntu/Debian sudo pacman -S libva-mesa-driver # ArchAMD 硬件编码 sudo pacman -S cuda # ArchNVIDIA 硬件编码 yay -S sunshinemacOSHomebrew 最省心macOS 目前属于实验性平台手柄暂不支持brew tap LizardByte/homebrew brew install sunshine安装完在终端敲sunshine启动服务Windows 安装器已默认注册服务。想从源码或完整流程入手的话可以翻一下 docs/getting_started.md。接着打开浏览器访问https://localhost:47990走五步配对建管理员账号首次访问会要求设置 Web 界面用户名和密码这组凭证记牢忽略证书警告页面用的是自签名 SSL 证书浏览器提示不安全是正常现象继续访问即可添加应用Applications 页面默认有 Desktop 和 Steam Big Picture 两个条目可以继续加游戏或任意命令行程序客户端生成 PIN手机或平板上打开 Moonlight手动添加主机 IP客户端会显示一组 PIN 码Web 端输入 PIN回到 PIN 标签页填入 PIN 并给设备起个名字配对完成选应用就能开串了。Applications 页面以卡片管理串流入口Desktop 直接串流整个桌面Steam Big Picture 一键进客厅模式。配对完顺手记两组快捷键都以CtrlAltShift开头与 Moonlight 一致CtrlAltShiftN隐藏/显示鼠标指针远程桌面场景很实用CtrlAltShiftF1~F12在多显示器主机上切换要串流的那块屏。从能玩到好玩跑通之后按网络 → 画质 → 外设的顺序逐项加码。先给网络打底。想跨设备甚至跨网玩先让 Sunshine 帮你把端口开出来UPnP通用即插即用路由器上自动打洞转发的协议打开后会自动完成公网端口转发。所有参数都能在 Web 界面的 Configuration 页搜索修改按 General、Input、Audio/Video、Network 等标签分类带即时搜索输入 upnp 就能直达对应开关习惯手改文件的话等价参数写在~/.config/sunshine/sunshine.conf里最小示例如下# 启用 UPnP自动完成公网端口转发 upnp true # 流媒体端口范围 port_start 47984 port_end 48010 # 指定编码器与码率按显卡情况调整 encoder nvenc bitrate 25000再把画质拉满。HDR高动态范围简单说就是画面亮部暗部信息都保留得更多串流在 Windows 主机上已正式支持前提是 GPU 支持 HEVC Main 10 或 AV1 10-bit 编码Linux 属于实验性支持要求 KMS 捕获后端Linux 下直接经内核 DRM 子系统抓帧的通道加上具备 HDR 合成能力的桌面环境如 Gamescope 或 KDE Plasma 6。有个容易踩的坑主机系统必须已开启 HDRMoonlight 客户端的 HDR 选项也要同步打开否则画面会偏色或过曝。最后把手柄对上。Sunshine 能把主机模拟成多种手柄让客户端的手柄按键原样映射过去各平台支持范围差异明显手柄类型WindowsLinuxmacOSFreeBSDXbox 360✅✅❌Xbox One / Series✅✅❌PlayStation 4 (DS4) / 5 (DualSense)✅✅❌Nintendo Switch Pro✅✅❌通用手柄✅✅❌Windows 上要拿到完整手柄功能需单独装虚拟手柄驱动Virtual HID Driver已替代旧的 ViGEmBus 方案安装入口就在 Web 界面的 Troubleshooting 页面未安装时直接给一键安装按钮Linux 用户则要把运行 Sunshine 的账户加入input组虚拟输入设备才创建得出来加入后重新登录生效sudo usermod -aG input $USER翻车自救出问题先看 Web 界面 Troubleshooting 页面的日志错误信息通常直接指向原因更细的排查思路在 docs/troubleshooting.md。高频症状对照如下症状常见原因解决方向浏览器一直提示网站不安全自签名 SSL 证书属正常现象点继续访问即可日志出现Encoder not found编码器与显卡/驱动对不上到 Configuration 换编码 API或升级显卡驱动画面一打起来就卡顿、糊成马赛克带宽吃紧或编码器超负荷分辨率、帧率、码率依次往下压直到流畅键鼠和手柄都动不了账户没有虚拟输入权限Linux 把用户加入input组后重新登录手柄接上就是识别不了Windows 缺虚拟手柄驱动在 Troubleshooting 页一键装驱动并重启HDR 画面惨白过曝客户端没开 HDR在 Moonlight 设置里同步打开 HDR 选项日志页按颜色分级展示错误支持搜索定位图中 Could not open codec [av1_amf] 这类提示就明确指向 AMF 编码器缺失或驱动不支持。调参这件事没有万能配置先从 1080p 起步确认画面稳、延迟可接受再逐步上调帧率和码率直到你的网络开始出现明显劣化回退半档那个位置就是你这条链路的甜点值——比照搬任何人的参数都可靠。现在就动手装好 Sunshine 启动服务、浏览器里建好管理员账号、手机上用 Moonlight 完成 PIN 配对先串一次桌面验证链路剩下的调优交给时间慢慢磨。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考