Sunshine 自托管游戏串流服务器教程把 PC 游戏串到任何设备【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款免费开源的自托管游戏串流服务器装在你的游戏 PC 上后它会通过 Moonlight 客户端把本地画面和音频编码成低延迟视频流推送到手机、平板、电视或另一台电脑上。与云游戏平台不同数据始终留在你自己的网络里硬件编码由你自己的显卡完成不用按月付费。本文覆盖从硬件确认、多平台安装、Web UI 配置、客户端配对到画质延迟调优和故障排查的完整流程。自托管串流和云游戏的区别先理解 Sunshine 的工作方式后面所有操作都会顺理成章服务器端Sunshine 运行在你的游戏 PC 上负责抓取屏幕、采集音频、用显卡硬件编码并接收客户端发来的键鼠手柄输入。客户端Moonlight 是接收端运行在你要看串流的设备上负责解码播放并把操作回传给服务器。配置端Sunshine 自带一个浏览器管理界面Web UI加游戏、改参数、配对设备都在这里完成。相比云游戏自托管方案的优势是延迟取决于你自己的局域网通常只有个位数到几十毫秒、游戏库完全归你、没有订阅费用代价是服务器必须保持开机且搭建需要你做一次性的配置。安装前先确认硬件与系统要求Sunshine 的门槛不高但有两点值得提前核对显卡是否支持硬件编码网络是否够快。项目最低要求4K 串流建议GPUAMD VCE 1.0 / Intel 支持 VAAPI 的核显 / NVIDIA 支持 NVENC 的显卡RTX 2000 系以上、Radeon VCE 3.1、Intel HD 510CPUIntel Core i3 / AMD Ryzen 3Core i5 / Ryzen 5内存4GB8GB 以上网络主机与客户端均建议 5GHz 802.11ac双端 CAT5e 以上有线系统Windows 11 / Ubuntu 22.04、Debian 13、Fedora 43 / macOS 14.2 / FreeBSD 15.1同左注意官方提醒以上表格仍在完善中仅供参考不要仅凭它做购机决定。实际体验里网络往往是最大变量——主机和客户端都走有线时延迟和卡顿问题会减少一大半。如何在 Windows、Linux、macOS 上安装 Sunshine各平台都有现成的安装方式下面只列最常用的。完整的官方安装说明见 docs/getting_started.md。Windows用 winget 可以直接安装并自动处理依赖winget install LizardByte.Sunshine安装后 Sunshine 默认以 Windows 服务形式常驻后台。另外建议在 Windows 上安装配套的 Virtual HID 驱动以获得完整的手柄与 Raw Input 键鼠支持安装器和状态提示会在 Web UI 中给出。Linux如果发行版仓库里有 sunshine 包优先用包管理器安装也可以用 AppImage 免安装体验chmod x Sunshine_{version}_{arch}.AppImage ./Sunshine_{version}_{arch}.AppImage包管理方式安装的服务名是app-dev.lizardbyte.app.Sunshine可以用systemctl --user enable --now让它开机自启。AppImage 不支持 KMS 捕获长期使用建议装发行版专属包。macOS通过 Homebrew 安装macOS 版目前仍标记为实验性暂不支持手柄brew tap LizardByte/homebrew brew install sunshine首次启动时系统会要求授予屏幕录制和麦克风权限按提示允许即可。Docker官方提供了 Docker 镜像适合想在容器里跑的用户但官方文档明确提示它不适合大多数场景音频、输入、权限都要额外打通新手不建议从这里入手docker run -d --namesunshine --networkhost -v /path/to/config:/config lizardbyte/sunshine:latest首次启动打开 Web UI 并添加第一个串流应用Sunshine 启动后在浏览器访问https://localhost:47990浏览器会提示证书不受信任这是自签名证书的正常现象可继续访问。首次进入时需要设置登录用户名和密码请务必记好之后每次打开 Web UI 都要用。接着做两件事添加串流目标。应用列表页可以添加 Desktop直接串整个桌面、Steam串 Steam 库中的游戏支持大图标模式也可以手动填路径添加任意 exe 或命令。调整参数。所有配置项都支持搜索找不到某项时直接在搜索框输入关键词即可。外观主题可以按喜好切换不影响功能Moonlight 客户端配对流程串流之前需要先让 Moonlight 客户端和 Sunshine 服务器认得彼此在 Moonlight 里找到你的主机同一局域网一般会自动发现找不到可手动输入 IP 添加。客户端发起配对请求后会提示输入 PIN。打开 Sunshine 的 Web UI进入导航栏的 PIN 页面填入请求显示的 PIN并给这台设备起个名字配对即完成。回到 Moonlight选择要串流的应用开始连接。Web UI 的 Featured Apps 页面汇总了各平台 Moonlight 客户端的官方获取入口包括 Windows、macOS、Linux、Android、iOS、Apple TV 和树莓派等可以直接在配对时打开对照画质与延迟编码器选择与关键参数按显卡选编码器Sunshine 的编码能力取决于平台和显卡Web UI 会只显示当前机器实际可用的编码器编码器适用平台说明NVENCWindows / LinuxNVIDIA 显卡最成熟的硬件编码路径4K 120fps 串流的主力AMD AMF / Vulkan VideoWindows / LinuxAMD 显卡Windows 走 AMFLinux 可走 VAAPI 或 Vulkan VideoIntel QuickSyncWindows / macOSIntel 核显核显串流的主力功耗低VAAPILinuxAMD / Intel / NVIDIA 核显Linux 下最通用的硬件编码接口VideoToolboxmacOS系统自带编码Apple Silicon 效率不错Software全平台纯 CPU 软编画质尚可但吃 CPU仅作兜底一般规则有硬编就用硬编编码器跟随你的显卡走。如果画面出现撕裂、绿块或掉帧第一个怀疑对象通常是网络第二个才是编码器设置。关键参数的正确理解新手常犯的一个错误是以为分辨率、帧率写在 Sunshine 的配置里。实际上分辨率和帧率由 Moonlight 客户端在连接时指定Sunshine 侧主要控制的是上限和设备# sunshine.conf 中值得了解的几项 adapter_name Radeon RX 580 Series # 多显卡时指定用哪块卡编码 output_name HDMI-0 # 多显示器时指定串哪一路输出 max_bitrate 5000 # 限制最高码率Kbps0 表示跟随客户端请求口语化地说adapter_name决定谁来编码output_name决定播哪块屏幕max_bitrate决定最多用多少带宽。局域网带宽充足时保持默认0即可带宽紧张或想在公网串流时把码率降到 10000~15000 Kbps 以内会明显更稳。网络层面的调优建议有线优先、双端 5GHz、避开 2.4GHz 拥塞信道等可以参考官方调优文档 docs/performance_tuning.md。连不上或画面异常时的排查路径出问题时不要盲目重装先看日志再动手。Web UI 的 Troubleshooting 页汇总了运行中的警告和错误并给出每条的修复线索几个高频问题的快速对照现象大概率原因处理方向Moonlight 里发现不了主机防火墙拦截 / 两端不同网段检查 Sunshine 所在端口的防火墙规则确认同网段能连上但黑屏输出选错或采集方式不可用核对output_name确认该显示器有信号输入有画面但无声音音频采集设备未选在 Web UI 的 audio_sink 中选择正确的输出设备手柄无响应虚拟输入权限不足Linux 下把运行 sunshine 的用户加入input组Windows 下确认虚拟 HID 驱动已装卡顿、掉帧严重带宽不足或编码压力大降分辨率/帧率/码率改走有线编码器报错显卡驱动过旧更新显卡驱动后重启服务Linux 用户的完整配置项含义可以在 docs/configuration.md 中逐项查。日常维护安全与更新串流服务器长期开机安全习惯比云游戏时代更重要强密码Web UI 密码是唯一的身份验证设置长密码并妥善保管它同时用于客户端连接认证。端口最小化局域网使用不需要开放任何入站端口若确实需要跨网段访问再考虑配置 UPnP 或手动端口转发平时保持关闭。保持更新定期更新 Sunshine 本体和显卡驱动两者是串流不稳定最常见的共同源头。备份配置配置文件sunshine.conf、apps.json 等都在用户配置目录下迁移系统前复制一份即可路径见 docs/configuration.md 的 Config Files 一节。进阶玩法基础串流跑通后按需解锁多显示器切换CtrlAltShiftF1到F12可以在串流中切换输出显示器不用回到主机操作。HDR 串流Windows 主机已正式支持Linux 为实验性需要 KMS 捕获 支持 HDR 的桌面合成器。前提是主机系统本身开启 HDR且 Moonlight 客户端也打开 HDR 选项两端都要配好画面才不会发白。公网访问配置upnp enabled后Sunshine 会自动在路由器上打洞方便从外面连接不常用就不开。应用启动细节apps.json 支持环境变量、前置命令prep-commands等写法适合给模拟器、启动器做复杂封装参考 docs/app_examples.md。延伸阅读完整配置项字典docs/configuration.md安装与平台说明docs/getting_started.md性能调优docs/performance_tuning.md排错指引docs/troubleshooting.md核心源码编码器、RTSP 服务、Web UI 处理逻辑都在这里src/想深入看实现时可以克隆源码仓库阅读git clone https://gitcode.com/GitHub_Trending/su/Sunshine配置好第一台主机后下一步自然是实测先串 Desktop 验证延迟再挑一个在线游戏或本地大作逐步提高分辨率和帧率把带宽、编码器、码率三个旋钮调到你网络的极限为止。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/10 12:51:10 · 阅读 1.2k Sunshine 自托管游戏串流服务器教程：把 PC 游戏串到任何设备
Sunshine 自托管游戏串流服务器教程把 PC 游戏串到任何设备【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款免费开源的自托管游戏串流服务器装在你的游戏 PC 上后它会通过 Moonlight 客户端把本地画面和音频编码成低延迟视频流推送到手机、平板、电视或另一台电脑上。与云游戏平台不同数据始终留在你自己的网络里硬件编码由你自己的显卡完成不用按月付费。本文覆盖从硬件确认、多平台安装、Web UI 配置、客户端配对到画质延迟调优和故障排查的完整流程。自托管串流和云游戏的区别先理解 Sunshine 的工作方式后面所有操作都会顺理成章服务器端Sunshine 运行在你的游戏 PC 上负责抓取屏幕、采集音频、用显卡硬件编码并接收客户端发来的键鼠手柄输入。客户端Moonlight 是接收端运行在你要看串流的设备上负责解码播放并把操作回传给服务器。配置端Sunshine 自带一个浏览器管理界面Web UI加游戏、改参数、配对设备都在这里完成。相比云游戏自托管方案的优势是延迟取决于你自己的局域网通常只有个位数到几十毫秒、游戏库完全归你、没有订阅费用代价是服务器必须保持开机且搭建需要你做一次性的配置。安装前先确认硬件与系统要求Sunshine 的门槛不高但有两点值得提前核对显卡是否支持硬件编码网络是否够快。项目最低要求4K 串流建议GPUAMD VCE 1.0 / Intel 支持 VAAPI 的核显 / NVIDIA 支持 NVENC 的显卡RTX 2000 系以上、Radeon VCE 3.1、Intel HD 510CPUIntel Core i3 / AMD Ryzen 3Core i5 / Ryzen 5内存4GB8GB 以上网络主机与客户端均建议 5GHz 802.11ac双端 CAT5e 以上有线系统Windows 11 / Ubuntu 22.04、Debian 13、Fedora 43 / macOS 14.2 / FreeBSD 15.1同左注意官方提醒以上表格仍在完善中仅供参考不要仅凭它做购机决定。实际体验里网络往往是最大变量——主机和客户端都走有线时延迟和卡顿问题会减少一大半。如何在 Windows、Linux、macOS 上安装 Sunshine各平台都有现成的安装方式下面只列最常用的。完整的官方安装说明见 docs/getting_started.md。Windows用 winget 可以直接安装并自动处理依赖winget install LizardByte.Sunshine安装后 Sunshine 默认以 Windows 服务形式常驻后台。另外建议在 Windows 上安装配套的 Virtual HID 驱动以获得完整的手柄与 Raw Input 键鼠支持安装器和状态提示会在 Web UI 中给出。Linux如果发行版仓库里有 sunshine 包优先用包管理器安装也可以用 AppImage 免安装体验chmod x Sunshine_{version}_{arch}.AppImage ./Sunshine_{version}_{arch}.AppImage包管理方式安装的服务名是app-dev.lizardbyte.app.Sunshine可以用systemctl --user enable --now让它开机自启。AppImage 不支持 KMS 捕获长期使用建议装发行版专属包。macOS通过 Homebrew 安装macOS 版目前仍标记为实验性暂不支持手柄brew tap LizardByte/homebrew brew install sunshine首次启动时系统会要求授予屏幕录制和麦克风权限按提示允许即可。Docker官方提供了 Docker 镜像适合想在容器里跑的用户但官方文档明确提示它不适合大多数场景音频、输入、权限都要额外打通新手不建议从这里入手docker run -d --namesunshine --networkhost -v /path/to/config:/config lizardbyte/sunshine:latest首次启动打开 Web UI 并添加第一个串流应用Sunshine 启动后在浏览器访问https://localhost:47990浏览器会提示证书不受信任这是自签名证书的正常现象可继续访问。首次进入时需要设置登录用户名和密码请务必记好之后每次打开 Web UI 都要用。接着做两件事添加串流目标。应用列表页可以添加 Desktop直接串整个桌面、Steam串 Steam 库中的游戏支持大图标模式也可以手动填路径添加任意 exe 或命令。调整参数。所有配置项都支持搜索找不到某项时直接在搜索框输入关键词即可。外观主题可以按喜好切换不影响功能Moonlight 客户端配对流程串流之前需要先让 Moonlight 客户端和 Sunshine 服务器认得彼此在 Moonlight 里找到你的主机同一局域网一般会自动发现找不到可手动输入 IP 添加。客户端发起配对请求后会提示输入 PIN。打开 Sunshine 的 Web UI进入导航栏的 PIN 页面填入请求显示的 PIN并给这台设备起个名字配对即完成。回到 Moonlight选择要串流的应用开始连接。Web UI 的 Featured Apps 页面汇总了各平台 Moonlight 客户端的官方获取入口包括 Windows、macOS、Linux、Android、iOS、Apple TV 和树莓派等可以直接在配对时打开对照画质与延迟编码器选择与关键参数按显卡选编码器Sunshine 的编码能力取决于平台和显卡Web UI 会只显示当前机器实际可用的编码器编码器适用平台说明NVENCWindows / LinuxNVIDIA 显卡最成熟的硬件编码路径4K 120fps 串流的主力AMD AMF / Vulkan VideoWindows / LinuxAMD 显卡Windows 走 AMFLinux 可走 VAAPI 或 Vulkan VideoIntel QuickSyncWindows / macOSIntel 核显核显串流的主力功耗低VAAPILinuxAMD / Intel / NVIDIA 核显Linux 下最通用的硬件编码接口VideoToolboxmacOS系统自带编码Apple Silicon 效率不错Software全平台纯 CPU 软编画质尚可但吃 CPU仅作兜底一般规则有硬编就用硬编编码器跟随你的显卡走。如果画面出现撕裂、绿块或掉帧第一个怀疑对象通常是网络第二个才是编码器设置。关键参数的正确理解新手常犯的一个错误是以为分辨率、帧率写在 Sunshine 的配置里。实际上分辨率和帧率由 Moonlight 客户端在连接时指定Sunshine 侧主要控制的是上限和设备# sunshine.conf 中值得了解的几项 adapter_name Radeon RX 580 Series # 多显卡时指定用哪块卡编码 output_name HDMI-0 # 多显示器时指定串哪一路输出 max_bitrate 5000 # 限制最高码率Kbps0 表示跟随客户端请求口语化地说adapter_name决定谁来编码output_name决定播哪块屏幕max_bitrate决定最多用多少带宽。局域网带宽充足时保持默认0即可带宽紧张或想在公网串流时把码率降到 10000~15000 Kbps 以内会明显更稳。网络层面的调优建议有线优先、双端 5GHz、避开 2.4GHz 拥塞信道等可以参考官方调优文档 docs/performance_tuning.md。连不上或画面异常时的排查路径出问题时不要盲目重装先看日志再动手。Web UI 的 Troubleshooting 页汇总了运行中的警告和错误并给出每条的修复线索几个高频问题的快速对照现象大概率原因处理方向Moonlight 里发现不了主机防火墙拦截 / 两端不同网段检查 Sunshine 所在端口的防火墙规则确认同网段能连上但黑屏输出选错或采集方式不可用核对output_name确认该显示器有信号输入有画面但无声音音频采集设备未选在 Web UI 的 audio_sink 中选择正确的输出设备手柄无响应虚拟输入权限不足Linux 下把运行 sunshine 的用户加入input组Windows 下确认虚拟 HID 驱动已装卡顿、掉帧严重带宽不足或编码压力大降分辨率/帧率/码率改走有线编码器报错显卡驱动过旧更新显卡驱动后重启服务Linux 用户的完整配置项含义可以在 docs/configuration.md 中逐项查。日常维护安全与更新串流服务器长期开机安全习惯比云游戏时代更重要强密码Web UI 密码是唯一的身份验证设置长密码并妥善保管它同时用于客户端连接认证。端口最小化局域网使用不需要开放任何入站端口若确实需要跨网段访问再考虑配置 UPnP 或手动端口转发平时保持关闭。保持更新定期更新 Sunshine 本体和显卡驱动两者是串流不稳定最常见的共同源头。备份配置配置文件sunshine.conf、apps.json 等都在用户配置目录下迁移系统前复制一份即可路径见 docs/configuration.md 的 Config Files 一节。进阶玩法基础串流跑通后按需解锁多显示器切换CtrlAltShiftF1到F12可以在串流中切换输出显示器不用回到主机操作。HDR 串流Windows 主机已正式支持Linux 为实验性需要 KMS 捕获 支持 HDR 的桌面合成器。前提是主机系统本身开启 HDR且 Moonlight 客户端也打开 HDR 选项两端都要配好画面才不会发白。公网访问配置upnp enabled后Sunshine 会自动在路由器上打洞方便从外面连接不常用就不开。应用启动细节apps.json 支持环境变量、前置命令prep-commands等写法适合给模拟器、启动器做复杂封装参考 docs/app_examples.md。延伸阅读完整配置项字典docs/configuration.md安装与平台说明docs/getting_started.md性能调优docs/performance_tuning.md排错指引docs/troubleshooting.md核心源码编码器、RTSP 服务、Web UI 处理逻辑都在这里src/想深入看实现时可以克隆源码仓库阅读git clone https://gitcode.com/GitHub_Trending/su/Sunshine配置好第一台主机后下一步自然是实测先串 Desktop 验证延迟再挑一个在线游戏或本地大作逐步提高分辨率和帧率把带宽、编码器、码率三个旋钮调到你网络的极限为止。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考