Sunshine 游戏串流服务器完整指南30 分钟用 Moonlight 搭起你的家庭云游戏中心【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款完全开源免费的自托管游戏串流服务器专为 Moonlight 客户端而生。它把高性能 PC 变成一台家庭云游戏主机让手机、平板、笔记本、电视随时接管你的游戏画面——Windows、Linux、macOS、FreeBSD 全覆盖NVIDIA、AMD、Intel 显卡通吃。本指南从零开始带你完成 Sunshine 安装配置、Moonlight 客户端配对、核心功能调优与常见故障排查半小时内即可在任意设备上畅玩 3A 大作。 一个周末的客厅实验想象这个周五晚上你想在客厅 65 英寸大屏上玩刚买的开放世界游戏但主机装在书房的桌子下面。搬主机太重。再买一台游戏 PC太贵。于是你打开平板点开 Moonlight三秒后——书房里那台 PC 的游戏画面出现在客厅电视上手柄延迟几乎感觉不到。这就是 Sunshine 的日常。它不像云游戏平台那样把数据送到千里之外的机房而是在你自己家里完成画面采集 → 硬件编码 → 局域网传输数据全程不出家门隐私、速度、画质全部由你掌控。对你来说它就像给书房 PC 装了一扇任意门游戏想去哪就去哪。 三分钟看懂 Sunshine一张表速览先记住这张能力地图后面每个模块都会展开细讲。能力维度Sunshine 的表现定位自托管游戏串流服务端配合 Moonlight 客户端使用支持平台Windows、Linux、macOS、FreeBSD硬件编码NVENCNVIDIA、AMFAMD、QuickSyncIntel、VideoToolboxApple、VAAPI、Vulkan Video另有 CPU 软编码兜底捕获方式Windows 桌面捕获、Linux 的 KMS / X11 / Waylandwlr、KWin、Portal手柄模拟Windows 支持 DS4 与 Xbox 360Linux 支持 DualSense、Switch Pro、Xbox One/Series配置方式浏览器 Web UI支持跨设备配对与管理成本开源免费无订阅、无广告、无账号绑定一句话总结它的价值Sunshine 负责把游戏画面高效地送出去Moonlight 负责在任何屏幕上把它接回来两者配合就是一套完整的家庭云游戏基础设施。 多平台安装挑一条最适合你的路Sunshine 官方为每个平台都准备了开箱即用的安装包按你的系统选一条路即可。Windows推荐下载Sunshine-Windows-AMD64-installer.msi双击安装。官方强调 MSI 安装器是最优选择安装过程中注意按需勾选组件不要盲目全选。装完后防火墙规则由安装器自动配置。Linux按发行版选Debian/Ubuntu下载sunshine-ubuntu-22.04-{arch}.deb后执行sudo dpkg -i ./sunshine-ubuntu-22.04-{arch}.debFedorasudo dnf copr enable lizardbyte/stable后sudo dnf install SunshineArchpacman -S sunshineLizardByte 官方 pacman 仓库Flatpakflatpak install --system flathub dev.lizardbyte.app.Sunshine装完必须再跑一次flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine补装输入依赖通用下载sunshine.AppImage./sunshine.AppImage --install ./sunshine.AppImage即可运行macOS实验性支持下载 DMG 镜像把Sunshine.app拖进 Applications 文件夹即可也可以用 Homebrewbrew install sunshine。注意 macOS 版目前手柄模拟不可用。FreeBSD下载对应架构的.pkg文件sudo pkg install ./Sunshine-FreeBSD-14.4-{arch}.pkgDocker进阶玩家docker pull lizardbyte/sunshine官方文档明确提示容器镜像不推荐大多数用户使用仅适合熟悉容器化的玩家。想从源码构建或贡献代码也可以直接克隆官方仓库git clone https://gitcode.com/GitHub_Trending/su/Sunshine构建说明见 docs/building.md。 首次配置与配对5 分钟跑通首条串流安装完成后进入最关键的一步——配对。整个过程只需三步打开 Web UI浏览器访问https://localhost:47990首次打开会引导你设置管理员用户名和密码之后所有配置都在这套网页里完成。启动服务Linux 上用systemctl --user start app-dev.lizardbyte.app.Sunshine启动Windows 上 MSI 安装器已注册为服务开机自启。Moonlight 配对在客户端设备打开 Moonlight它会自动发现局域网内的 Sunshine首次连接时 Moonlight 会显示四位 PIN 码回到 Sunshine 的 Web UI 里输入该 PIN 完成授权。配对成功后Web UI 主页会显示已连接的客户端、当前串流状态和统计信息。所有操作都在本地 Web 界面完成也支持从手机浏览器远程管理十分方便。 核心功能深挖从应用管理到画面调优应用管理把想串流的东西全部收纳进来Sunshine 的核心模块是应用管理。你可以在 Web UI 里添加任意可执行程序作为应用每个应用独立配置启动参数串流时直接一键启动。常用的几个典型配置桌面直接串流整个桌面环境适合办公、视频等非游戏场景Steam 大屏模式为 Steam 游戏优化进 Steam 后手柄操作即可自定义应用任何游戏启动器、模拟器都可以加进来参数按需填写Sunshine 还内置了精选应用推荐页聚合了官方推荐的客户端与配套工具新用户可以从这里快速了解生态。配置界面用搜索秒定位任何设置项Sunshine 的配置页面支持即时搜索几百个配置项不用翻菜单输入关键词直达。比如搜 UPnP 立刻定位到自动端口转发选项。画面与音频的关键参数在配置 → 视频里你会看到几个决定串流体验的核心设置最大比特率max_bitrate默认 0 表示完全采用 Moonlight 请求的码率想限制带宽占用就设一个上限如5000Kbps编码器encoder默认自动选择第一个可用编码器。手动指定时可填nvencNVIDIA、quicksyncIntel、amdvceAMD、vaapi、vulkan或softwareNVENC 预设nvenc_preset1最快到 7最慢数字越大压缩效率越高但延迟略增网络或解码器不给力时才建议动它否则直接提码率更划算最小帧率目标minimum_fps_target画面静止时自动降帧省带宽默认按流帧率一半兜底音频方面Windows 可用%ProgramFiles%\Sunshine\tools\audio-info.exe查看音频设备名再填入audio_sinkLinux 用pactl info | grep Sink获取。想静音主机扬声器用虚拟声卡virtual_sink而不是直接改 sink。主题与界面新版还支持明暗双主题切换夜晚串流时深色界面更护眼 三个真实场景把 Sunshine 用出最大价值场景一客厅大屏玩 3A有线最佳主机在书房、电视在客厅时主机端与路由器之间务必有线连接千兆网口起步电视盒子或游戏机装 Moonlight 走有线或 5GHz WiFi。此时把 Moonlight 的码率拉到 40–80 Mbps、分辨率 4K即可享受接近原生的画质。这是 Sunshine 最典型的主机分离玩法。场景二床上/沙发上续玩存档想睡前在平板继续白天的进度手机平板装 Moonlight走 5GHz WiFi把客户端分辨率调低如 720p/1080p码率 10–25 Mbps。触屏操控不舒服时配一个蓝牙手柄体验立刻升级。Sunshine 会自动记忆配对设备下次打开即连。场景三出差远程串流回家里想在公司电脑摸鱼玩家里 PC先在家里的路由器或 Sunshine 上开启UPnPupnp enabled让 47990 等端口自动转发再在 Moonlight 里手动添加家里的公网地址。远程场景对网络抖动敏感建议把 Moonlight 端延迟设置调到低延迟码率适度调低换取稳定。 新手最常见的 3 个报错与修复问题 1Web UI 打不开原因大多是防火墙拦截了端口。确认 47990 端口已放行或暂时关闭防火墙测试Windows 用 MSI 安装器时确认防火墙规则已自动写入。问题 2客户端搜不到 Sunshine先确认两台设备在同一局域网再检查 Sunshine 服务是否真正运行Linux 用systemctl --user status app-dev.lizardbyte.app.Sunshine。若仍不行重启 Sunshine 服务和路由器通常能解决。问题 3串流卡顿、掉帧或丢包原因很可能是网络而非 Sunshine 本身。官方建议用 iPerf3 做一次 60 秒 UDP 反向测试iperf3 -s # 主机端启动服务 iperf3 -c {主机IP} -t 60 -u -R -b 50M # 客户端测速理想情况丢包率低于 5%、抖动低于 1ms。丢包严重时把主机网卡速率降一档如 2.5G 降到 1G或改用有线连接在 Web UI 里降低码率、关闭nvenc_spatial_aq也能缓解。附忘记 Web UI 密码怎么办不用重装直接重置凭据sunshine --creds {新用户名} {新密码} # 一般安装 ./sunshine.AppImage --creds {新用户名} {新密码} # AppImage flatpak run --commandsunshine dev.lizardbyte.app.Sunshine --creds {新用户名} {新密码} # Flatpak遇到复杂问题时翻日志是最有效的路径。日志文件默认位置Windows 在%ProgramFiles%\Sunshine\config\sunshine.logLinux/macOS 在~/.config/sunshine/sunshine.logDocker 用docker logs sunshine。 最佳实践总结与三条进阶路线关键要点总结网络决定下限串流质量首先看网络稳定性有线 5GHz WiFi 2.4GHz用 iPerf3 先测再调编码器按显卡选NVIDIA 用 NVENC、AMD 用 AMF/VAAPI、Intel 用 QuickSync/VAAPI拿不准就让 Sunshine 自动选码率按设备定移动端 10–25 Mbps、桌面 4K 拉到 40–80 Mbpsmax_bitrate默认 0 即完全听客户端的远程串流开 UPnP跨网络游玩前确认端口转发生效日志是排查第一工具卡顿、黑屏、掉帧先看sunshine.log进阶学习路线初学者路线完成安装配对 → 串流一次桌面 → 添加第一个游戏应用 → 在第二台设备上验证进阶用户路线研究encoder、nvenc_preset、minimum_fps_target等参数组合 → 配置多设备权限 → 用 UPnP 打通远程串流 → 用 iPerf3 定期体检网络开发者路线通读 docs/configuration.md 全部配置项 → 阅读 src/nvenc/ 与 src/platform/ 源码理解编码与捕获链路 → 参与社区贡献功能与修复更深入的官方资料完整配置手册见 docs/configuration.md安装细节见 docs/getting_started.md疑难杂症见 docs/troubleshooting.md。Sunshine 最大的魅力在于它把在哪里玩游戏的选择权彻底还给了你。客厅、卧室、办公室甚至是出差的酒店——只要网络够稳你的游戏库永远跟着你走。现在就去把那个藏在书房角落的 PC 变成全家人的游戏主机吧你的下一场冒险不该被一根 HDMI 线困住。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Sunshine 游戏串流服务器完整指南：30 分钟用 Moonlight 搭起你的家庭云游戏中心
Sunshine 游戏串流服务器完整指南30 分钟用 Moonlight 搭起你的家庭云游戏中心【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款完全开源免费的自托管游戏串流服务器专为 Moonlight 客户端而生。它把高性能 PC 变成一台家庭云游戏主机让手机、平板、笔记本、电视随时接管你的游戏画面——Windows、Linux、macOS、FreeBSD 全覆盖NVIDIA、AMD、Intel 显卡通吃。本指南从零开始带你完成 Sunshine 安装配置、Moonlight 客户端配对、核心功能调优与常见故障排查半小时内即可在任意设备上畅玩 3A 大作。 一个周末的客厅实验想象这个周五晚上你想在客厅 65 英寸大屏上玩刚买的开放世界游戏但主机装在书房的桌子下面。搬主机太重。再买一台游戏 PC太贵。于是你打开平板点开 Moonlight三秒后——书房里那台 PC 的游戏画面出现在客厅电视上手柄延迟几乎感觉不到。这就是 Sunshine 的日常。它不像云游戏平台那样把数据送到千里之外的机房而是在你自己家里完成画面采集 → 硬件编码 → 局域网传输数据全程不出家门隐私、速度、画质全部由你掌控。对你来说它就像给书房 PC 装了一扇任意门游戏想去哪就去哪。 三分钟看懂 Sunshine一张表速览先记住这张能力地图后面每个模块都会展开细讲。能力维度Sunshine 的表现定位自托管游戏串流服务端配合 Moonlight 客户端使用支持平台Windows、Linux、macOS、FreeBSD硬件编码NVENCNVIDIA、AMFAMD、QuickSyncIntel、VideoToolboxApple、VAAPI、Vulkan Video另有 CPU 软编码兜底捕获方式Windows 桌面捕获、Linux 的 KMS / X11 / Waylandwlr、KWin、Portal手柄模拟Windows 支持 DS4 与 Xbox 360Linux 支持 DualSense、Switch Pro、Xbox One/Series配置方式浏览器 Web UI支持跨设备配对与管理成本开源免费无订阅、无广告、无账号绑定一句话总结它的价值Sunshine 负责把游戏画面高效地送出去Moonlight 负责在任何屏幕上把它接回来两者配合就是一套完整的家庭云游戏基础设施。 多平台安装挑一条最适合你的路Sunshine 官方为每个平台都准备了开箱即用的安装包按你的系统选一条路即可。Windows推荐下载Sunshine-Windows-AMD64-installer.msi双击安装。官方强调 MSI 安装器是最优选择安装过程中注意按需勾选组件不要盲目全选。装完后防火墙规则由安装器自动配置。Linux按发行版选Debian/Ubuntu下载sunshine-ubuntu-22.04-{arch}.deb后执行sudo dpkg -i ./sunshine-ubuntu-22.04-{arch}.debFedorasudo dnf copr enable lizardbyte/stable后sudo dnf install SunshineArchpacman -S sunshineLizardByte 官方 pacman 仓库Flatpakflatpak install --system flathub dev.lizardbyte.app.Sunshine装完必须再跑一次flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine补装输入依赖通用下载sunshine.AppImage./sunshine.AppImage --install ./sunshine.AppImage即可运行macOS实验性支持下载 DMG 镜像把Sunshine.app拖进 Applications 文件夹即可也可以用 Homebrewbrew install sunshine。注意 macOS 版目前手柄模拟不可用。FreeBSD下载对应架构的.pkg文件sudo pkg install ./Sunshine-FreeBSD-14.4-{arch}.pkgDocker进阶玩家docker pull lizardbyte/sunshine官方文档明确提示容器镜像不推荐大多数用户使用仅适合熟悉容器化的玩家。想从源码构建或贡献代码也可以直接克隆官方仓库git clone https://gitcode.com/GitHub_Trending/su/Sunshine构建说明见 docs/building.md。 首次配置与配对5 分钟跑通首条串流安装完成后进入最关键的一步——配对。整个过程只需三步打开 Web UI浏览器访问https://localhost:47990首次打开会引导你设置管理员用户名和密码之后所有配置都在这套网页里完成。启动服务Linux 上用systemctl --user start app-dev.lizardbyte.app.Sunshine启动Windows 上 MSI 安装器已注册为服务开机自启。Moonlight 配对在客户端设备打开 Moonlight它会自动发现局域网内的 Sunshine首次连接时 Moonlight 会显示四位 PIN 码回到 Sunshine 的 Web UI 里输入该 PIN 完成授权。配对成功后Web UI 主页会显示已连接的客户端、当前串流状态和统计信息。所有操作都在本地 Web 界面完成也支持从手机浏览器远程管理十分方便。 核心功能深挖从应用管理到画面调优应用管理把想串流的东西全部收纳进来Sunshine 的核心模块是应用管理。你可以在 Web UI 里添加任意可执行程序作为应用每个应用独立配置启动参数串流时直接一键启动。常用的几个典型配置桌面直接串流整个桌面环境适合办公、视频等非游戏场景Steam 大屏模式为 Steam 游戏优化进 Steam 后手柄操作即可自定义应用任何游戏启动器、模拟器都可以加进来参数按需填写Sunshine 还内置了精选应用推荐页聚合了官方推荐的客户端与配套工具新用户可以从这里快速了解生态。配置界面用搜索秒定位任何设置项Sunshine 的配置页面支持即时搜索几百个配置项不用翻菜单输入关键词直达。比如搜 UPnP 立刻定位到自动端口转发选项。画面与音频的关键参数在配置 → 视频里你会看到几个决定串流体验的核心设置最大比特率max_bitrate默认 0 表示完全采用 Moonlight 请求的码率想限制带宽占用就设一个上限如5000Kbps编码器encoder默认自动选择第一个可用编码器。手动指定时可填nvencNVIDIA、quicksyncIntel、amdvceAMD、vaapi、vulkan或softwareNVENC 预设nvenc_preset1最快到 7最慢数字越大压缩效率越高但延迟略增网络或解码器不给力时才建议动它否则直接提码率更划算最小帧率目标minimum_fps_target画面静止时自动降帧省带宽默认按流帧率一半兜底音频方面Windows 可用%ProgramFiles%\Sunshine\tools\audio-info.exe查看音频设备名再填入audio_sinkLinux 用pactl info | grep Sink获取。想静音主机扬声器用虚拟声卡virtual_sink而不是直接改 sink。主题与界面新版还支持明暗双主题切换夜晚串流时深色界面更护眼 三个真实场景把 Sunshine 用出最大价值场景一客厅大屏玩 3A有线最佳主机在书房、电视在客厅时主机端与路由器之间务必有线连接千兆网口起步电视盒子或游戏机装 Moonlight 走有线或 5GHz WiFi。此时把 Moonlight 的码率拉到 40–80 Mbps、分辨率 4K即可享受接近原生的画质。这是 Sunshine 最典型的主机分离玩法。场景二床上/沙发上续玩存档想睡前在平板继续白天的进度手机平板装 Moonlight走 5GHz WiFi把客户端分辨率调低如 720p/1080p码率 10–25 Mbps。触屏操控不舒服时配一个蓝牙手柄体验立刻升级。Sunshine 会自动记忆配对设备下次打开即连。场景三出差远程串流回家里想在公司电脑摸鱼玩家里 PC先在家里的路由器或 Sunshine 上开启UPnPupnp enabled让 47990 等端口自动转发再在 Moonlight 里手动添加家里的公网地址。远程场景对网络抖动敏感建议把 Moonlight 端延迟设置调到低延迟码率适度调低换取稳定。 新手最常见的 3 个报错与修复问题 1Web UI 打不开原因大多是防火墙拦截了端口。确认 47990 端口已放行或暂时关闭防火墙测试Windows 用 MSI 安装器时确认防火墙规则已自动写入。问题 2客户端搜不到 Sunshine先确认两台设备在同一局域网再检查 Sunshine 服务是否真正运行Linux 用systemctl --user status app-dev.lizardbyte.app.Sunshine。若仍不行重启 Sunshine 服务和路由器通常能解决。问题 3串流卡顿、掉帧或丢包原因很可能是网络而非 Sunshine 本身。官方建议用 iPerf3 做一次 60 秒 UDP 反向测试iperf3 -s # 主机端启动服务 iperf3 -c {主机IP} -t 60 -u -R -b 50M # 客户端测速理想情况丢包率低于 5%、抖动低于 1ms。丢包严重时把主机网卡速率降一档如 2.5G 降到 1G或改用有线连接在 Web UI 里降低码率、关闭nvenc_spatial_aq也能缓解。附忘记 Web UI 密码怎么办不用重装直接重置凭据sunshine --creds {新用户名} {新密码} # 一般安装 ./sunshine.AppImage --creds {新用户名} {新密码} # AppImage flatpak run --commandsunshine dev.lizardbyte.app.Sunshine --creds {新用户名} {新密码} # Flatpak遇到复杂问题时翻日志是最有效的路径。日志文件默认位置Windows 在%ProgramFiles%\Sunshine\config\sunshine.logLinux/macOS 在~/.config/sunshine/sunshine.logDocker 用docker logs sunshine。 最佳实践总结与三条进阶路线关键要点总结网络决定下限串流质量首先看网络稳定性有线 5GHz WiFi 2.4GHz用 iPerf3 先测再调编码器按显卡选NVIDIA 用 NVENC、AMD 用 AMF/VAAPI、Intel 用 QuickSync/VAAPI拿不准就让 Sunshine 自动选码率按设备定移动端 10–25 Mbps、桌面 4K 拉到 40–80 Mbpsmax_bitrate默认 0 即完全听客户端的远程串流开 UPnP跨网络游玩前确认端口转发生效日志是排查第一工具卡顿、黑屏、掉帧先看sunshine.log进阶学习路线初学者路线完成安装配对 → 串流一次桌面 → 添加第一个游戏应用 → 在第二台设备上验证进阶用户路线研究encoder、nvenc_preset、minimum_fps_target等参数组合 → 配置多设备权限 → 用 UPnP 打通远程串流 → 用 iPerf3 定期体检网络开发者路线通读 docs/configuration.md 全部配置项 → 阅读 src/nvenc/ 与 src/platform/ 源码理解编码与捕获链路 → 参与社区贡献功能与修复更深入的官方资料完整配置手册见 docs/configuration.md安装细节见 docs/getting_started.md疑难杂症见 docs/troubleshooting.md。Sunshine 最大的魅力在于它把在哪里玩游戏的选择权彻底还给了你。客厅、卧室、办公室甚至是出差的酒店——只要网络够稳你的游戏库永远跟着你走。现在就去把那个藏在书房角落的 PC 变成全家人的游戏主机吧你的下一场冒险不该被一根 HDMI 线困住。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考