Sunshine 游戏串流从安装到 Moonlight 配对的完整实操指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款自托管游戏串流服务器与 Moonlight 客户端配合可把本地电脑的屏幕、音频与手柄输入以低延迟方式输出到手机、平板或电视适合希望用自有硬件替代商业串流服务的玩家与家庭用户。它把一台普通 PC 变成私有串流主机省去订阅费用与账号体系。30 秒看懂原理Sunshine 是服务器端运行在串流主机上负责屏幕捕获、GPU 硬件编码、音频采集并向客户端发送编码后的视频流同时把客户端发来的键盘、鼠标、手柄信号转换为虚拟输入设备。Moonlight 是客户端运行在接收端负责解码播放画面并回传操作输入。客户端与 Sunshine 分开安装、独立升级。配对只做一次首次连接时 Moonlight 会向主机请求一个 PIN 码在 Web 界面确认并保存设备名后设备即被记住之后可直接串流。从 0 到 1首次串流的 5 步配置Windows 安装从官方发布页下载 MSI 安装包后双击运行按提示选择组件命令行用户也可以执行winget install LizardByte.SunshineLinux 安装按发行版选择官方包Debian/Ubuntu 安装对应的.debFedora 启用lizardbyte/stableCopr 后执行sudo dnf install SunshineArch 使用 pacman-repo 或 AUR。若发行版源中已有 sunshine 包直接通过包管理器安装即可。macOS 安装通过 Homebrew 安装brew tap LizardByte/homebrew brew install sunshine或下载对应芯片架构的 DMG 拖入应用程序文件夹。macOS 版为实验性质手柄暂不受支持。启动服务并打开 Web 界面Linux 下用 systemd 用户服务启动并设为开机自启systemctl --user --now enable app-dev.lizardbyte.app.SunshineWindows 安装后以服务方式运行macOS 首次启动时按系统提示授予屏幕录制与麦克风权限。然后浏览器访问https://localhost:47990浏览器提示的不安全警告来自自签名证书属正常现象。Sunshine 游戏串流 Web 配置界面首次进入需要创建登录账号完成配对的 5 个步骤首次进入 Web 界面时创建用户名和密码并妥善保存凭据不会再次显示。在应用列表中添加串流目标Desktop纯桌面不启动任何程序与Steam Big Picture已内置也可用 Add New 手动填入游戏路径与启动参数例如C:\Games\某游戏.exe。按需调整网络与显示参数配置项均可在搜索栏中直接检索完整说明见官方配置文档。打开 Moonlight 客户端手动添加主机地址看到 PIN 码提示后回到 Web 界面 PIN 页面输入该码并保存设备名配对即告完成。在 Moonlight 中选择应用开始串流。串流应用列表Desktop 直接串流桌面其余条目各自启动指定程序串流质量调优编码器、码率与网络配置项可选值 / 取值选择理由编码器encodernvencNVIDIA、quicksyncIntel、amdvce/vaapiAMD、vulkan仅 Linux、softwareCPU 兜底默认自动选用第一个可用的硬件编码器硬件编码把负载交给 GPUCPU 占用与延迟都更低software仅作无硬件加速时的备选分辨率以客户端请求为准dd_resolution_option requested为默认让客户端请求它自身显示器的原生分辨率避免二次缩放损失细节帧率60 FPS60 FPS 下 Sunshine 每 16 ms 输出一个数据块是串流体验的标准档位码率max_bitrate默认由 Moonlight 请求决定可按需封顶弱网环境先压到 15–20 Mbps 测试稳定性再逐步上调避免丢包放大卡顿网络方面串流主机尽量走有线连接。官方排障文档建议用 iPerf3 验证链路丢包低于 5%、抖动低于 1ms才算合格。一个容易踩的坑若主机网卡速率如 2.5G/10G远高于客户端所在网段百兆或 Wi-Fi突发数据流可能压垮中间设备缓存导致丢包此时把主机网卡降速到与客户端匹配的档位反而更稳。Moonlight 客户端覆盖桌面、移动与电视端配对一次后即可在任意设备使用游戏之外的用法远程桌面选择Desktop应用即可串流整个桌面。它不启动任何程序只做屏幕捕获适合临时借用另一台电脑的办公、文件与浏览器操作。远程工作站把设计、剪辑、3D 建模等重负载软件跑在高性能主机上用低配笔记本或平板通过串流完成操作算力与便携性不再互相牵制。教学演示讲师串流桌面并讲解学员端用 Moonlight 观看配合内置的虚拟手柄能力演示中还可以展示手柄操控内容。 问题自查现象一客户端搜索不到主机或连接直接失败确认两端在同一局域网内检查防火墙是否放行 SunshineTCP 47984–47990 与 UDP 48010与 官方配置文档中的网络说明一致Linux 可用如下命令放行sudo ufw allow 47984:47990/tcp sudo ufw allow 48010/udp确认浏览器中的自签名证书警告已被接受Web 界面可正常打开确认 PIN 码已在 Web 界面 PIN 页面输入并保存了设备名。现象二画面卡顿、延迟高优先检查 Wi-Fi改用有线链路复测把分辨率降到 1080p、帧率降到 30 复测定位是编码瓶颈还是网络瓶颈查看当前编码器是否为硬件编码见上文调优表Linux 沙箱环境Flatpak/AppImage出现帧率骤降时参考故障排除文档改用 Vulkan 编码组合用 iPerf3 按官方标准验证丢包与抖动网络侧达标后再排查主机负载。现象三无声音或声音异常macOS 确认已授予麦克风权限macOS 14 以上系统可将 Audio Sink 留空以使用系统原生音频捕获否则需配置 Soundflower/BlackHole 环回设备并填入audio_sinkWindows 检查默认音频输出设备选择是否正确并更新声卡驱动更换音频编码格式如 HE-AAC复测兼容性。现象四键盘鼠标或手柄无响应Linux 确认运行 Sunshine 的用户属于input组安装脚本已配置/dev/uinput权限加入后需重新登录Windows 确认 Virtual HID Driver 为文档要求的版本装完驱动建议重启一次。Web 界面的 Troubleshooting 页逐条给出警告与错误信息是最快定位问题的入口深入资源官方入门与配对流程docs/getting_started.md全部配置项说明docs/configuration.md故障案例与网络测试标准docs/troubleshooting.mdHTTP API脚本化重启、改配置docs/api.md社区LizardByte 官方 Discord各版本文档与发布说明中均提供入口可直接提问或分享配置。现在开始在串流主机上装好 Sunshine打开https://localhost:47990完成账号与 Desktop 应用配置再用任意一台设备上的 Moonlight 完成第一次 PIN 配对。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Sunshine 游戏串流：从安装到 Moonlight 配对的完整实操指南
Sunshine 游戏串流从安装到 Moonlight 配对的完整实操指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款自托管游戏串流服务器与 Moonlight 客户端配合可把本地电脑的屏幕、音频与手柄输入以低延迟方式输出到手机、平板或电视适合希望用自有硬件替代商业串流服务的玩家与家庭用户。它把一台普通 PC 变成私有串流主机省去订阅费用与账号体系。30 秒看懂原理Sunshine 是服务器端运行在串流主机上负责屏幕捕获、GPU 硬件编码、音频采集并向客户端发送编码后的视频流同时把客户端发来的键盘、鼠标、手柄信号转换为虚拟输入设备。Moonlight 是客户端运行在接收端负责解码播放画面并回传操作输入。客户端与 Sunshine 分开安装、独立升级。配对只做一次首次连接时 Moonlight 会向主机请求一个 PIN 码在 Web 界面确认并保存设备名后设备即被记住之后可直接串流。从 0 到 1首次串流的 5 步配置Windows 安装从官方发布页下载 MSI 安装包后双击运行按提示选择组件命令行用户也可以执行winget install LizardByte.SunshineLinux 安装按发行版选择官方包Debian/Ubuntu 安装对应的.debFedora 启用lizardbyte/stableCopr 后执行sudo dnf install SunshineArch 使用 pacman-repo 或 AUR。若发行版源中已有 sunshine 包直接通过包管理器安装即可。macOS 安装通过 Homebrew 安装brew tap LizardByte/homebrew brew install sunshine或下载对应芯片架构的 DMG 拖入应用程序文件夹。macOS 版为实验性质手柄暂不受支持。启动服务并打开 Web 界面Linux 下用 systemd 用户服务启动并设为开机自启systemctl --user --now enable app-dev.lizardbyte.app.SunshineWindows 安装后以服务方式运行macOS 首次启动时按系统提示授予屏幕录制与麦克风权限。然后浏览器访问https://localhost:47990浏览器提示的不安全警告来自自签名证书属正常现象。Sunshine 游戏串流 Web 配置界面首次进入需要创建登录账号完成配对的 5 个步骤首次进入 Web 界面时创建用户名和密码并妥善保存凭据不会再次显示。在应用列表中添加串流目标Desktop纯桌面不启动任何程序与Steam Big Picture已内置也可用 Add New 手动填入游戏路径与启动参数例如C:\Games\某游戏.exe。按需调整网络与显示参数配置项均可在搜索栏中直接检索完整说明见官方配置文档。打开 Moonlight 客户端手动添加主机地址看到 PIN 码提示后回到 Web 界面 PIN 页面输入该码并保存设备名配对即告完成。在 Moonlight 中选择应用开始串流。串流应用列表Desktop 直接串流桌面其余条目各自启动指定程序串流质量调优编码器、码率与网络配置项可选值 / 取值选择理由编码器encodernvencNVIDIA、quicksyncIntel、amdvce/vaapiAMD、vulkan仅 Linux、softwareCPU 兜底默认自动选用第一个可用的硬件编码器硬件编码把负载交给 GPUCPU 占用与延迟都更低software仅作无硬件加速时的备选分辨率以客户端请求为准dd_resolution_option requested为默认让客户端请求它自身显示器的原生分辨率避免二次缩放损失细节帧率60 FPS60 FPS 下 Sunshine 每 16 ms 输出一个数据块是串流体验的标准档位码率max_bitrate默认由 Moonlight 请求决定可按需封顶弱网环境先压到 15–20 Mbps 测试稳定性再逐步上调避免丢包放大卡顿网络方面串流主机尽量走有线连接。官方排障文档建议用 iPerf3 验证链路丢包低于 5%、抖动低于 1ms才算合格。一个容易踩的坑若主机网卡速率如 2.5G/10G远高于客户端所在网段百兆或 Wi-Fi突发数据流可能压垮中间设备缓存导致丢包此时把主机网卡降速到与客户端匹配的档位反而更稳。Moonlight 客户端覆盖桌面、移动与电视端配对一次后即可在任意设备使用游戏之外的用法远程桌面选择Desktop应用即可串流整个桌面。它不启动任何程序只做屏幕捕获适合临时借用另一台电脑的办公、文件与浏览器操作。远程工作站把设计、剪辑、3D 建模等重负载软件跑在高性能主机上用低配笔记本或平板通过串流完成操作算力与便携性不再互相牵制。教学演示讲师串流桌面并讲解学员端用 Moonlight 观看配合内置的虚拟手柄能力演示中还可以展示手柄操控内容。 问题自查现象一客户端搜索不到主机或连接直接失败确认两端在同一局域网内检查防火墙是否放行 SunshineTCP 47984–47990 与 UDP 48010与 官方配置文档中的网络说明一致Linux 可用如下命令放行sudo ufw allow 47984:47990/tcp sudo ufw allow 48010/udp确认浏览器中的自签名证书警告已被接受Web 界面可正常打开确认 PIN 码已在 Web 界面 PIN 页面输入并保存了设备名。现象二画面卡顿、延迟高优先检查 Wi-Fi改用有线链路复测把分辨率降到 1080p、帧率降到 30 复测定位是编码瓶颈还是网络瓶颈查看当前编码器是否为硬件编码见上文调优表Linux 沙箱环境Flatpak/AppImage出现帧率骤降时参考故障排除文档改用 Vulkan 编码组合用 iPerf3 按官方标准验证丢包与抖动网络侧达标后再排查主机负载。现象三无声音或声音异常macOS 确认已授予麦克风权限macOS 14 以上系统可将 Audio Sink 留空以使用系统原生音频捕获否则需配置 Soundflower/BlackHole 环回设备并填入audio_sinkWindows 检查默认音频输出设备选择是否正确并更新声卡驱动更换音频编码格式如 HE-AAC复测兼容性。现象四键盘鼠标或手柄无响应Linux 确认运行 Sunshine 的用户属于input组安装脚本已配置/dev/uinput权限加入后需重新登录Windows 确认 Virtual HID Driver 为文档要求的版本装完驱动建议重启一次。Web 界面的 Troubleshooting 页逐条给出警告与错误信息是最快定位问题的入口深入资源官方入门与配对流程docs/getting_started.md全部配置项说明docs/configuration.md故障案例与网络测试标准docs/troubleshooting.mdHTTP API脚本化重启、改配置docs/api.md社区LizardByte 官方 Discord各版本文档与发布说明中均提供入口可直接提问或分享配置。现在开始在串流主机上装好 Sunshine打开https://localhost:47990完成账号与 Desktop 应用配置再用任意一台设备上的 Moonlight 完成第一次 PIN 配对。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考