Sunshine游戏串流实战指南5步搭建你的专属PC游戏云端【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款开源、自托管的游戏串流主机配合 Moonlight 客户端使用能把 PC 上的游戏画面低延迟地推送到手机、平板、电视等任意设备。它免费、无订阅视频走 NVIDIA、AMD、Intel 硬件编码数据始终留在你自己的局域网里。本文面向第一次搭建的人从安装到调优排障一次讲清。 从在电视上玩PC游戏说起想象这个场景你在电脑上玩着 3A 大作想搬到客厅用电视的大屏幕继续。传统做法是接根 HDMI 线但线材长度、HDMI 接口占用都很麻烦。Sunshine 的思路是把 PC 变成一台串流服务器它截取屏幕画面用显卡硬件编码成视频流通过局域网发送给 Moonlight 客户端装在电视盒子、手机或另一台电脑上。你操作的是 Moonlight 端输入指令再回传给 PC 模拟成键鼠和手柄。整个过程只有几十毫秒级延迟数据不出内网不依赖任何云游戏平台。对硬件党来说还有个好处NVIDIA 的 NVENC、AMD 的 VCE、Intel 的 QuickSync 这类硬件编码单元平时闲置现在正好派上用场CPU 几乎不占用。️ Sunshine能力矩阵先看看你的设备吃不吃香在动手之前先对照两张表确认你的组合是否受支持。硬件编码器支持Sunshine 用什么方式压视频编码 API对应芯片WindowsLinuxmacOSNVENCNVIDIA✅✅—VAAPIAMD / Intel / NVIDIA—✅—AMFAMD✅——QuickSyncIntel✅——VideoToolboxApple / Intel——✅Vulkan VideoAMD / Intel / NVIDIA— 部分—软件编码所有设备✅✅✅一句话解释只要你有一张带硬件编码单元的显卡就能用对应 API实在没有软件编码兜底只是会吃 CPU。手柄模拟支持客户端那端能变成什么手柄手柄类型WindowsLinuxFreeBSDmacOSXbox 360 / One / Series✅✅❌DualShock 4 / DualSense (PS5)✅✅❌Nintendo Switch Pro✅✅❌通用手柄✅✅❌ macOS 版目前仍是实验性状态可以串流但手柄输入暂不支持适合轻度远程桌面场景。最低硬件门槛官方建议值CPU 为 Ryzen 3 或 Core i3 起步内存 4GB 起跑 4K 或 HDR 串流建议 CAT5e 及以上网线的有线连接无线则要求主机和客户端都走 5GHz 802.11ac。 安装部署按你的平台挑一条路官方推荐直接下载各平台预编译安装包源码构建仅面向想定制编译选项的用户。Windows推荐 MSI 安装包从最新 Release 下载Sunshine-Windows-AMD64-installer.msix64或 ARM64 版本双击安装安装时可勾选或跳过附加组件不要盲选。也可以走命令行winget install LizardByte.Sunshine安装器默认注册为后台服务服务就是开机自启、常驻后台的进程装完即跑无需手动启动。LinuxDebian / Ubuntu先配置官方 Cloudsmith 源脚本自动识别发行版再执行sudo apt install sunshineFedora / openSUSEsudo dnf install Sunshine包名区分大小写Arch 可从 LizardByte 官方仓库pacman -S sunshine其他发行版用 AppImage注意 AppImage 不支持 KMS 采集或 Flatpak同样不支持 KMS安装后需额外运行一次flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine。若要用 systemd 管理一次性启动systemctl --user start app-dev.lizardbyte.app.Sunshine开机自启加--now enable。macOS下载对应架构的 DMGApple Silicon 选 arm64把Sunshine.app拖进应用程序或 Homebrew 方式brew tap LizardByte/homebrew后brew install sunshine。首次启动会请求屏幕录制和麦克风权限都要授予。Docker 与源码构建Docker 镜像官方存在但文档明确标注不推荐大多数用户使用容器化串流涉及显卡直通和采集限制新手慎入。如果你是开发者想从源码构建克隆仓库后按 构建文档 操作git clone https://gitcode.com/GitHub_Trending/su/Sunshine 首次配置5步走跑通最小闭环装好之后前 5 步大概花你十分钟完成后就能在 Moonlight 里看到你的 PC 了。打开 Web 控制台浏览器访问https://localhost:47990localhost 可换成主机内网 IP。浏览器提示不安全是因为证书自签忽略即可。设置账号首次访问需要创建用户名和密码Sunshine 会在页面上显示出来——务必当场抄下来忘了没有自动找回只能重置见下文排障。添加第一个应用进 Applications 页面内置Desktop只串流桌面不启动程序和 Steam 大屏模板点 Add New 可自定义任意程序及其启动命令。Moonlight 端配对在 Moonlight 客户端里手动添加这台 PC当它索要 PIN 码时回到 Web 控制台的 PIN 页面输入并给设备起个名字配对完成。开始串流在 Moonlight 里选Desktop或你添加的游戏输入指令即刻投到远端设备。顺手把右上角的主题下拉菜单切换一下浅色深色随便挑Featured页签里则列出了 Moonlight 各平台客户端和配套工具的下载入口。 游戏管理与工具推荐让串流更顺手应用管理是日常使用频率最高的页面每个应用独立配置名称、启动命令、工作目录支持环境变量如$(HOME)。两个细节值得记住以detached方式启动的程序如 Steam 本体不会跟着串流结束而退出用cmd方式启动的程序则会随串流一起关闭——想串完就关和常驻分别选对模式即可。快捷键沿用 Moonlight 习惯CtrlAltShiftN隐藏/显示鼠标光标CtrlAltShiftF1~F12切换串流显示器。Featured 精选页是官方维护的工具导航收录了 Moonlight 的 PC、Android、iOS 客户端以及嵌入式设备版本找客户端不用再去翻官网完整配置项音频、编码、网络等几十个开关都在 Web UI 的 Configuration 里支持搜索栏直接定位字段说明见 配置文档。 进阶调优网络、编码、画质三条线网络稳定性比带宽重要。串流是实时业务丢包和抖动才是杀手而不是峰值速率。官方推荐用 iPerf3 实测主机到客户端的链路iperf3 -s # 在Sunshine主机上 iperf3 -c 主机IP -t 60 -u -R -b 50M # 在客户端上按你的目标码率调整 -b观察客户端输出的丢包和抖动理想状态是丢包低于 5%、抖动低于 1 毫秒。如果主机网卡比如 2.5G 有线远快于链路最慢的一跳比如客户端只有百兆或 2.4G WiFi突发数据会在中间设备缓冲中溢出——最简单的解法是把主机网卡降速到与客户端同量级。需要远程访问时在路由器上转发 5201 端口TCP/UDP即可。编码按显卡走对应路线。Windows NVIDIA / AMD分别在显卡驱动里开 Fast Sync / Enhanced Sync可再省一帧延迟详见 性能调优文档。Linux 沙盒安装Flatpak/AppImage在高 GPU 负载下可能出现掉帧日志若出现EGL: context priority set to HIGH but CAP_SYS_NICE capability is missing改用非沙盒安装包或 Vulkan 编码。码率上限max_bitrate单位为 Kbps设为 0 表示完全跟随 Moonlight 请求值网络余量不大时可用它封顶例如max_bitrate 5000即 5Mbps低码率下记得同步调低分辨率。码控模式推荐vbr_latency受限延迟可变码率对实时串流最友好。画质4K 与 HDR 的门槛。4K 串流建议 AMD VCE 3.1 / NVIDIA GTX 1080 或 RTX 2000 系列起 / Intel HD 510且两端有线HDR 在 Windows 主机正式支持、Linux 实验性支持前提是主机系统已开启 HDR、客户端同步打开 HDR 选项Linux 端还需要 KMS 采集配合支持 HDR 渲染的桌面如 Gamescope、KDE Plasma 6。 排障速查现象 → 原因 → 动作现象可能原因解决动作忘记 Web UI 密码无找回机制需重置停掉 Sunshine运行sunshine --creds 新用户名 新密码重置凭证Moonlight 发现不了主机 / 打不开 47990防火墙拦了端口检查防火墙规则放行 47990 及相关串流端口远程访问再转发 5201画面卡顿、大量丢包链路两端速率不匹配或 WiFi 不稳用 iPerf3 定位丢包段降主机网卡速率或换 5GHz/有线必要时把网卡 MTU 调低有案例从 1500 降到 1428 解决Linux 输入手柄/键鼠失灵权限与 udev 规则未生效把运行用户加入input组sudo usermod -aG input $USER后重新登录仍不行则重载 udev 规则Linux NVIDIA 主机 KMS 采集黑屏内核未开启 modeset内核命令行加nvidia_drm.modeset1后重启还有一类玄学问题——手柄在 Steam 里好使、进游戏就不灵多半是 Steam 的手柄模式与 Sunshine 虚拟手柄冲突把 Steam 的大屏模式手柄支持调成只留通用模式或断开主机上物理直连的手柄让 Sunshine 的虚拟手柄成为第一个。更多 Linux 桌面环境的组合建议如 KDE 用 portal/kwin 采集 vulkan 编码见 故障排查文档。 收尾记住这5件事选对编码NVIDIA 走 NVENCAMD 走 VAAPI/AMFIntel 走 QuickSync/VAAPI没有独显就软件编码。先测网再调画质iPerf3 丢包 5%、抖动 1ms 是底线之后才谈分辨率和码率。凭证没有后悔药首次生成的账号密码随手记好忘了只能--creds重置。包类型影响采集Flatpak/AppImage 不支持 KMSWindows 建议用 MSI 安装器装服务。日志是最后的答案Web UI 的 Troubleshooting 页签能直接翻错误和硬件信息。延伸阅读入门指南、完整配置项、性能调优、故障排查。现在打开那台吃灰的游戏 PC把客厅电视变成你的第二块屏吧。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
