Sunshine 游戏串流服务器完整指南从零部署、上手配对到性能调优与疑难排查【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想让客厅电视、平板或手机直接玩主机级的 PC 游戏自托管串流是最省事的路线一台闲置的游戏电脑装上 Sunshine 游戏串流服务器再配一个 Moonlight 客户端接收串流的免费播放端画面就搬过去了。本文按真实使用顺序带你走完全程——先部署再完成首次配对然后是日常调优最后讲怎么快速定位疑难问题全程只需几行命令就能完成首次上线。游戏串流到底在传什么先弄清 Sunshine 的分工很多人把串流理解成传视频其实它是一次分工明确的协作Sunshine服务端跑在你那台性能最好的游戏电脑上负责截屏、硬件编码、把输入信号注回游戏Moonlight客户端装在电视、平板、手机、笔记本等任何设备上负责解码播放并转发你的操作。两者通过局域网有条件的话走宽带通信。好处是编码压力落在显卡上CPU 占用很低延迟才能压得住坏处是它对网络稳定性的要求比普通视频高得多这一点后面调优时会展开。先花一分钟确认你的机器够不够格数据来自 README.md完整表格以仓库为准部件最低要求想跑 4K 的建议显卡AMD 带 VCE 1.0 编码单元 / Intel HD 4000 / NVIDIA 开 NVENC 的卡AMD VCE 3.1、Intel HD 510、NVIDIA RTX 2000 系起CPUi3 或 Ryzen 3 级别i5 / Ryzen 5 级别内存4GB 起8GB 更从容网络主机与客户端都尽量 5GHz Wi-Fi802.11ac两端都走 CAT5e 以上有线操作系统方面Windows 11、较新的 Debian/Fedora/Ubuntu、macOS 14.2 和 FreeBSD 都在支持范围内功能支持矩阵比如各平台的编码器、截屏方式可以对照 README.md 里的表格看。Windows / Linux / Docker 三种落地姿势安装没有唯一正解按你的系统选一条路走即可。核心原则是能用系统包管理器装的就别用便携包——便携包AppImage、Flatpak拿不到 KMS 截屏这类需要较高权限的能力。你的环境推荐做法要点Windows官方 MSI 安装包或winget install LizardByte.Sunshine安装器会顺手配好防火墙规则并注册为系统服务LinuxDebian/Ubuntu 等添加官方仓库后sudo apt install sunshine发行版原生包功能最全LinuxFedora 等 RPM 系添加官方仓库后sudo dnf install Sunshine包名大小写敏感注意是SunshineLinux无 root / 尝鲜AppImage 或 Flatpak功能有缩水KMS 截屏不可用仅作兜底macOSHomebrew 或官方 DMG属实验性支持手柄暂不可用Docker官方镜像 挂载配置目录官方明确提示多数人不必走这条路几个高频场景的具体命令# Linux 上注册为开机自启的 systemd 用户服务 systemctl --user --now enable app-dev.lizardbyte.app.Sunshine # Docker 方式起一个容器--networkhost 让端口直通 docker run -d --namesunshine --networkhost \ -v /path/to/config:/config \ lizardbyte/sunshine:latestWindows 上装完还有一步容易漏虚拟输入依赖 Virtual HID Driver让 Sunshine 能在主机上伪造键盘、鼠标和手柄需要单独安装并在 Web UI 里激活机器许可。装完驱动建议重启一次电脑。如果你是开发者想通读实现也可以把源码拉下来对照着看git clone https://gitcode.com/GitHub_Trending/su/Sunshine第一次进 Web UI设好账号并记住它服务跑起来后浏览器访问https://localhost:47990localhost可换成主机内网 IP。两个小提醒浏览器会警告连接不安全这是因为 Web UI 用的是自签名证书属正常现象直接继续访问即可首次进入要求你创建 Web UI 的用户名和密码且只显示这一次。丢了也别慌忘了可以用命令行重置命令见故障排查一节。登录后建议顺手做两件事在导航栏切一下主题深色/浅色以及翻到Featured Apps页——Moonlight 各平台客户端PC、Android、嵌入式设备的获取入口都集中在这里不用自己满世界找。客户端配对把电视或平板接进来配对的本质是让 Moonlight 知道这台 Sunshine 存在并验证身份。完整流程添加串流源打开 Moonlight 客户端若自动发现不到主机就手动输入 Sunshine 主机的局域网 IP触发 PIN 验证Moonlight 请求配对时回到 Sunshine Web UI点导航栏的PIN页签输入 PIN把 Web UI 里显示的 PIN 码输进 Moonlight给设备起个名字看到成功提示即完成开始串流在 Moonlight 的应用列表里挑一个流就起来了。应用从哪来在Applications页签点 Add New 即可。内置的 Desktop 项代表直接串整个桌面Steam 大图标模式开箱即用其余游戏则填启动命令注意要能独立于终端运行的命令详见下文两个容易踩的坑。应用列表只在客户端重启时刷新改完记得重连。两个容易踩的坑应用退出 串流结束Sunshine 会一直盯住它启动的进程进程没了流就断。像 Steam 这类常驻程序要用detached方式启动否则启动即退出。多开会互踢同一个 Sunshine 上启动新应用时旧应用会被强制结束。想边串流边干别的用 Desktop 项串桌面更灵活。性能调优延迟、画质、帧率怎么平衡调优不是把所有参数拉满而是按网络 编码器 分辨率/码率 显卡辅助设置的优先级逐项收。1. 网络稳定性优先于峰值带宽实时串流最敏感的不是带宽大小而是抖动和丢包。官方推荐用 iperf3 做 60 秒 UDP 实测主机端iperf3 -s客户端iperf3 -c 主机IP -t 60 -u -R -b 50M丢包最好压到 5% 以下、抖动低于 1ms。还有一个反直觉的坑主机网卡远快于客户端比如 2.5G 对 1G时中间设备缓冲溢出反而造成大量丢包。最简单的缓解办法是把主机网卡限速降一级。2. 编码器能硬件就别软件编码器适用硬件一句话点评NVENCNVIDIA综合表现最稳Windows/Linux 均可用AMFAMDWindows搭配 Enhanced Sync 还能再省一帧延迟VAAPI / QuickSyncAMD / IntelLinux 走 VAAPIWindows 走 QuickSync软件编码 (x264)任意兼容性兜底CPU 开销大仅备用配置入口在 Web UI 的Configuration页几十个选项不用一个个翻——顶部搜索框输关键词即可直达3. 码率、分辨率、帧率三者的取舍码率1080p60 给 20Mbps 左右起步4K 需要 60Mbps 以上但前提是网络接得住接不住就先降码率分辨率与帧率客户端分辨率和主机输出保持一致减少缩放损耗60fps 是多数场景的平衡点显示器和流媒体链路都跟得上再考虑更高音频缓冲声音延迟大时把音频缓冲调到最小值试试代价是网络波动时更容易爆音。4. 显卡辅助设置各花入各眼NVIDIA 用户可在控制面板里关掉vsync:fast缓解卡顿AMD 用户可打开 Enhanced Sync 换取更低延迟。这些细节连同更多选项说明见官方 docs/performance_tuning.md 与 docs/configuration.md。故障排查先走这张排查图遇到问题先别急着重装按现象分流八成能自己定位Web UI 的Troubleshooting页签内置了日志查看器警告和错误都能点开看详情这是定位问题的第一现场常见症状速查完整版见 docs/troubleshooting.md症状高频原因对应动作忘了 Web UI 密码凭证只显示一次命令行重置sunshine --creds 新用户名 新密码客户端连不上防火墙挡了 47990放行该端口Windows 用官方安装包的会自动配好Linux KMS 截屏黑屏N 卡内核未启用 modeset内核参数加nvidia_drm.modeset1后重启Linux 输入完全没反应用户无输入设备权限sudo usermod -aG input $USER重新登录生效Windows 检测不到手柄缺虚拟输入驱动安装 Virtual HID DriverWeb UI 里激活许可编码器报错 not implementedMesa 默认禁用硬件编码按官方文档重编 Mesa 并开启h264enc,h265enc主机远快于客户端时大量丢包中间缓冲溢出给主机网卡限速降一级或升级 0.23.1 的新网络栈排查顺序建议现象 → 日志 → 上表对号入座 → 改完立刻重连验证。一次只改一个变量不然出了问题也不知道是谁的功劳。进阶玩法这些功能藏在细节里基础跑通之后几个知道就赚的设置切换串流显示器CtrlAltShiftF1到F12可在多个显示器间切换串流目标双屏党必备隐藏/显示光标CtrlAltShiftN串桌面办公时很有用HDR 串流Windows 主机上正式可用Linux 上实验性支持需要 KMS 截屏 支持 HDR 的桌面合成器。注意客户端那边也要开 HDR 选项否则画面会过曝多配置文件Web UI 的 Config Files 页签可以保存多套配置按场景切换比如4K 电影模式和1080p 竞技模式命令行参数sunshine --help可查看全部启动参数比如指定配置文件路径sunshine /path/to/sunshine.conf。想更深入理解截屏、编码、虚拟输入是怎么串起来的可以直接翻源码核心逻辑集中在 src/如video.cpp负责编码管线、input.cpp负责输入注入Linux 各截屏后端的实现在 src/platform/linux/单元测试在 tests/ 里。上线前检查表第一次正式串流前按这张表过一遍比事后救火快得多主机与客户端在同一网段且优先有线连接Web UI 能正常打开账号密码已抄录到安全的地方至少一个 Moonlight 设备完成 PIN 配对Applications 里至少有一个能跑的应用先试 Desktop 最稳编码器选的是硬件方案而非软件编码码率与网络带宽匹配iperf3 实测丢包 5%、抖动 1msLinux 用户已在input组Windows 用户已装并激活 Virtual HID DriverTroubleshooting 页签里没有持续刷新的红色错误接下来可以做什么把 docs/configuration.md 里你关心的选项逐项过一遍搜索框能帮你省时间关注 docs/changelog.md网络栈和 Linux 截屏相关的能力迭代很快遇到本文没覆盖的怪问题带着 Troubleshooting 页里导出的日志去社区提问效率会高很多。串流这件事网络稳、编码硬、参数别乱拉就成功了一大半。剩下的交给你的游戏库吧。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Sunshine 游戏串流服务器完整指南：从零部署、上手配对到性能调优与疑难排查
Sunshine 游戏串流服务器完整指南从零部署、上手配对到性能调优与疑难排查【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想让客厅电视、平板或手机直接玩主机级的 PC 游戏自托管串流是最省事的路线一台闲置的游戏电脑装上 Sunshine 游戏串流服务器再配一个 Moonlight 客户端接收串流的免费播放端画面就搬过去了。本文按真实使用顺序带你走完全程——先部署再完成首次配对然后是日常调优最后讲怎么快速定位疑难问题全程只需几行命令就能完成首次上线。游戏串流到底在传什么先弄清 Sunshine 的分工很多人把串流理解成传视频其实它是一次分工明确的协作Sunshine服务端跑在你那台性能最好的游戏电脑上负责截屏、硬件编码、把输入信号注回游戏Moonlight客户端装在电视、平板、手机、笔记本等任何设备上负责解码播放并转发你的操作。两者通过局域网有条件的话走宽带通信。好处是编码压力落在显卡上CPU 占用很低延迟才能压得住坏处是它对网络稳定性的要求比普通视频高得多这一点后面调优时会展开。先花一分钟确认你的机器够不够格数据来自 README.md完整表格以仓库为准部件最低要求想跑 4K 的建议显卡AMD 带 VCE 1.0 编码单元 / Intel HD 4000 / NVIDIA 开 NVENC 的卡AMD VCE 3.1、Intel HD 510、NVIDIA RTX 2000 系起CPUi3 或 Ryzen 3 级别i5 / Ryzen 5 级别内存4GB 起8GB 更从容网络主机与客户端都尽量 5GHz Wi-Fi802.11ac两端都走 CAT5e 以上有线操作系统方面Windows 11、较新的 Debian/Fedora/Ubuntu、macOS 14.2 和 FreeBSD 都在支持范围内功能支持矩阵比如各平台的编码器、截屏方式可以对照 README.md 里的表格看。Windows / Linux / Docker 三种落地姿势安装没有唯一正解按你的系统选一条路走即可。核心原则是能用系统包管理器装的就别用便携包——便携包AppImage、Flatpak拿不到 KMS 截屏这类需要较高权限的能力。你的环境推荐做法要点Windows官方 MSI 安装包或winget install LizardByte.Sunshine安装器会顺手配好防火墙规则并注册为系统服务LinuxDebian/Ubuntu 等添加官方仓库后sudo apt install sunshine发行版原生包功能最全LinuxFedora 等 RPM 系添加官方仓库后sudo dnf install Sunshine包名大小写敏感注意是SunshineLinux无 root / 尝鲜AppImage 或 Flatpak功能有缩水KMS 截屏不可用仅作兜底macOSHomebrew 或官方 DMG属实验性支持手柄暂不可用Docker官方镜像 挂载配置目录官方明确提示多数人不必走这条路几个高频场景的具体命令# Linux 上注册为开机自启的 systemd 用户服务 systemctl --user --now enable app-dev.lizardbyte.app.Sunshine # Docker 方式起一个容器--networkhost 让端口直通 docker run -d --namesunshine --networkhost \ -v /path/to/config:/config \ lizardbyte/sunshine:latestWindows 上装完还有一步容易漏虚拟输入依赖 Virtual HID Driver让 Sunshine 能在主机上伪造键盘、鼠标和手柄需要单独安装并在 Web UI 里激活机器许可。装完驱动建议重启一次电脑。如果你是开发者想通读实现也可以把源码拉下来对照着看git clone https://gitcode.com/GitHub_Trending/su/Sunshine第一次进 Web UI设好账号并记住它服务跑起来后浏览器访问https://localhost:47990localhost可换成主机内网 IP。两个小提醒浏览器会警告连接不安全这是因为 Web UI 用的是自签名证书属正常现象直接继续访问即可首次进入要求你创建 Web UI 的用户名和密码且只显示这一次。丢了也别慌忘了可以用命令行重置命令见故障排查一节。登录后建议顺手做两件事在导航栏切一下主题深色/浅色以及翻到Featured Apps页——Moonlight 各平台客户端PC、Android、嵌入式设备的获取入口都集中在这里不用自己满世界找。客户端配对把电视或平板接进来配对的本质是让 Moonlight 知道这台 Sunshine 存在并验证身份。完整流程添加串流源打开 Moonlight 客户端若自动发现不到主机就手动输入 Sunshine 主机的局域网 IP触发 PIN 验证Moonlight 请求配对时回到 Sunshine Web UI点导航栏的PIN页签输入 PIN把 Web UI 里显示的 PIN 码输进 Moonlight给设备起个名字看到成功提示即完成开始串流在 Moonlight 的应用列表里挑一个流就起来了。应用从哪来在Applications页签点 Add New 即可。内置的 Desktop 项代表直接串整个桌面Steam 大图标模式开箱即用其余游戏则填启动命令注意要能独立于终端运行的命令详见下文两个容易踩的坑。应用列表只在客户端重启时刷新改完记得重连。两个容易踩的坑应用退出 串流结束Sunshine 会一直盯住它启动的进程进程没了流就断。像 Steam 这类常驻程序要用detached方式启动否则启动即退出。多开会互踢同一个 Sunshine 上启动新应用时旧应用会被强制结束。想边串流边干别的用 Desktop 项串桌面更灵活。性能调优延迟、画质、帧率怎么平衡调优不是把所有参数拉满而是按网络 编码器 分辨率/码率 显卡辅助设置的优先级逐项收。1. 网络稳定性优先于峰值带宽实时串流最敏感的不是带宽大小而是抖动和丢包。官方推荐用 iperf3 做 60 秒 UDP 实测主机端iperf3 -s客户端iperf3 -c 主机IP -t 60 -u -R -b 50M丢包最好压到 5% 以下、抖动低于 1ms。还有一个反直觉的坑主机网卡远快于客户端比如 2.5G 对 1G时中间设备缓冲溢出反而造成大量丢包。最简单的缓解办法是把主机网卡限速降一级。2. 编码器能硬件就别软件编码器适用硬件一句话点评NVENCNVIDIA综合表现最稳Windows/Linux 均可用AMFAMDWindows搭配 Enhanced Sync 还能再省一帧延迟VAAPI / QuickSyncAMD / IntelLinux 走 VAAPIWindows 走 QuickSync软件编码 (x264)任意兼容性兜底CPU 开销大仅备用配置入口在 Web UI 的Configuration页几十个选项不用一个个翻——顶部搜索框输关键词即可直达3. 码率、分辨率、帧率三者的取舍码率1080p60 给 20Mbps 左右起步4K 需要 60Mbps 以上但前提是网络接得住接不住就先降码率分辨率与帧率客户端分辨率和主机输出保持一致减少缩放损耗60fps 是多数场景的平衡点显示器和流媒体链路都跟得上再考虑更高音频缓冲声音延迟大时把音频缓冲调到最小值试试代价是网络波动时更容易爆音。4. 显卡辅助设置各花入各眼NVIDIA 用户可在控制面板里关掉vsync:fast缓解卡顿AMD 用户可打开 Enhanced Sync 换取更低延迟。这些细节连同更多选项说明见官方 docs/performance_tuning.md 与 docs/configuration.md。故障排查先走这张排查图遇到问题先别急着重装按现象分流八成能自己定位Web UI 的Troubleshooting页签内置了日志查看器警告和错误都能点开看详情这是定位问题的第一现场常见症状速查完整版见 docs/troubleshooting.md症状高频原因对应动作忘了 Web UI 密码凭证只显示一次命令行重置sunshine --creds 新用户名 新密码客户端连不上防火墙挡了 47990放行该端口Windows 用官方安装包的会自动配好Linux KMS 截屏黑屏N 卡内核未启用 modeset内核参数加nvidia_drm.modeset1后重启Linux 输入完全没反应用户无输入设备权限sudo usermod -aG input $USER重新登录生效Windows 检测不到手柄缺虚拟输入驱动安装 Virtual HID DriverWeb UI 里激活许可编码器报错 not implementedMesa 默认禁用硬件编码按官方文档重编 Mesa 并开启h264enc,h265enc主机远快于客户端时大量丢包中间缓冲溢出给主机网卡限速降一级或升级 0.23.1 的新网络栈排查顺序建议现象 → 日志 → 上表对号入座 → 改完立刻重连验证。一次只改一个变量不然出了问题也不知道是谁的功劳。进阶玩法这些功能藏在细节里基础跑通之后几个知道就赚的设置切换串流显示器CtrlAltShiftF1到F12可在多个显示器间切换串流目标双屏党必备隐藏/显示光标CtrlAltShiftN串桌面办公时很有用HDR 串流Windows 主机上正式可用Linux 上实验性支持需要 KMS 截屏 支持 HDR 的桌面合成器。注意客户端那边也要开 HDR 选项否则画面会过曝多配置文件Web UI 的 Config Files 页签可以保存多套配置按场景切换比如4K 电影模式和1080p 竞技模式命令行参数sunshine --help可查看全部启动参数比如指定配置文件路径sunshine /path/to/sunshine.conf。想更深入理解截屏、编码、虚拟输入是怎么串起来的可以直接翻源码核心逻辑集中在 src/如video.cpp负责编码管线、input.cpp负责输入注入Linux 各截屏后端的实现在 src/platform/linux/单元测试在 tests/ 里。上线前检查表第一次正式串流前按这张表过一遍比事后救火快得多主机与客户端在同一网段且优先有线连接Web UI 能正常打开账号密码已抄录到安全的地方至少一个 Moonlight 设备完成 PIN 配对Applications 里至少有一个能跑的应用先试 Desktop 最稳编码器选的是硬件方案而非软件编码码率与网络带宽匹配iperf3 实测丢包 5%、抖动 1msLinux 用户已在input组Windows 用户已装并激活 Virtual HID DriverTroubleshooting 页签里没有持续刷新的红色错误接下来可以做什么把 docs/configuration.md 里你关心的选项逐项过一遍搜索框能帮你省时间关注 docs/changelog.md网络栈和 Linux 截屏相关的能力迭代很快遇到本文没覆盖的怪问题带着 Troubleshooting 页里导出的日志去社区提问效率会高很多。串流这件事网络稳、编码硬、参数别乱拉就成功了一大半。剩下的交给你的游戏库吧。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考