Sunshine 实操指南从安装到 Moonlight 出画面的完整串流路径【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine把 PC 游戏串到电视、平板或手机你只需要一台装好 Sunshine 的主机和一个 Moonlight 客户端全程走局域网不经过第三方云免费且延迟低。本文按一张速查卡 五个落地阶段组织先给你端口、命令与参数的速查再依次带你把主机装好、把服务拉起、把网页配好、把客户端连上、把画质调顺每一步都是可直接复制的命令。速查卡端口、服务命令与编码器对照先把最常用的几个值记在脑子里后文每一步都会用到它们。项目值 / 命令说明配置网页端口47990地址https://localhost:47990自签证书会提示不安全忽略即可浏览器提示不安全点继续访问证书自签属正常现象Linux 后台服务名app-dev.lizardbyte.app.Sunshine用户级 systemd 服务也接受别名sunshine.service启动并开机自启systemctl --user enable --now app-dev.lizardbyte.app.SunshineLinux 专用编码器参数encoder取值nvenc/amdvce/quicksync/vaapi/vulkan/software码率上限max_bitrate单位 Kbps官方示例写法max_bitrate 5000多显示器切换快捷键CtrlAltShiftF1~F12与 Moonlight 一致编码器与显卡、平台的对应关系决定你encoder该锁哪个值显卡WindowsLinuxmacOSNVIDIANVENCNVENC不可用AMDAMF (amdvce)VAAPI / Vulkan不可用IntelQuickSyncVAAPI / Vulkan不可用Apple 芯片不可用不可用VideoToolbox冲 4K 60fps 前对照这条门槛线两端都要满足部件最低要求显卡NVIDIA GTX 1080 及以上 / AMD Video Coding Engine 3.1 及以上 / Intel HD 510 及以上网络两端都走有线或至少 5GHz WiFi官方建议两端网络规格保持一致按平台把 Sunshine 装进主机装主机这一步不同平台命令不同但装完后的行为一致都提供一个后台服务或进程去抓屏、编码。Windows 与 Linux 安装包Windows 从项目发布页下载对应架构的安装包AMD64 选Sunshine-Windows-AMD64-installer.msiARM64 设备选 ARM64 版双击安装即可。装完 Sunshine 以系统服务身份在后台运行浏览器会自动弹出配置页地址是https://localhost:47990。Debian / Ubuntu 用包管理器sudo apt update sudo apt install sunshineFedora 用sudo dnf install SunshineopenSUSE 用sudo zypper install Sunshine。系统里没有对应发行版包时下Sunshine_{version}_{arch}.AppImage放进主目录再执行./Sunshine_{version}_{arch}.AppImage --installArch 可用pacman -S sunshine。注意 AppImage 与 Flatpak 都不支持 KMS 捕获能装发行版包就优先装包。macOS、FreeBSD 与 AlpinemacOS 需 14.2 以上两行命令装完brew tap LizardByte/homebrew brew install sunshine首次启动会弹出系统授权框把屏幕录制和麦克风两项都允许。FreeBSD 从发布页下载对应架构的.pkg再执行sudo pkg install ./Sunshine-{version}-{arch}.pkg。Alpine 用apk add --allow-untrusted ./sunshine_{version}_alpine{distro-version}_{arch}.apk。macOS 版目前是实验性状态虚拟手柄暂不可用串桌面、串应用没问题手柄玩家建议直接用 Windows 或 Linux 主机。拉起后台服务并进入配置网页装完不等于跑起来。Linux 下要手动把用户级服务拉起并设为开机自启Windows 装完已自启macOS 装完首次启动即授权。Linux 用户级 systemd 服务一次性启动systemctl --user start app-dev.lizardbyte.app.Sunshine启动并开机自启推荐systemctl --user enable --now app-dev.lizardbyte.app.Sunshine服务名也接受别名sunshine.service。创建管理员账号与添加应用打开https://localhost:47990想在别的设备上操作就把localhost换成主机内网 IP。首次访问会要求创建管理员账号用户名和密码就是之后登录网页、完成配对的唯一凭证务必记牢。应用列表默认带一个Desktop条目选它串出来的就是整个桌面。想单独串某个游戏就点添加填名称和启动命令保存。配置页顶部有搜索栏按关键词定位参数。比如搜encoder编码器设置立刻出现。完整参数清单见 配置参考。Moonlight 客户端 PIN 配对出画面客户端侧装一个 Moonlight各应用商店搜 Moonlight 即可Android、iOS、macOS、Windows 都有官方版设备必须和主机在同一局域网。装好后客户端会自动扫描列表里出现你装好 Sunshine 的主机。四步配对在 Moonlight 里点连接主机屏幕弹出一个PIN 码。登录网页版点导航栏的PIN页。把 PIN 码输进去再给这台设备起个名字保存会看到成功提示。回 Moonlight选Desktop或你加过的应用开始串流。画面出来后电视上的按键、鼠标、手柄操作会实时传回主机。多显示器与快捷键串多显示器时用快捷键切到另一个屏幕CtrlAltShiftF1到F12数字对应显示器编号。串远程桌面模式时CtrlAltShiftN可隐藏 / 显示光标。所有快捷键都以CtrlAltShift起头和 Moonlight 客户端约定一致。编码器与码率三参数调优出画面后画质不满意绝大多数问题出在编码器和码率这两组参数上。在配置页顶部搜索栏搜encoder与max_bitrate即可直达对应设置。锁定硬件编码器默认行为是自动选用第一个可用的编码器手动锁定更稳。搜encoderNVIDIA 显卡设nvencAMD 显卡设amdvceIntel 核显设quicksyncLinux 无独显可用vaapi或vulkan码率与帧率取舍画面发糊主因是码率偏低。搜max_bitrate单位 Kbps按家里带宽往上加官方示例写法是max_bitrate 5000。卡顿、帧率上不去多半是带宽不足或码率与网络不匹配。先把主机换到 5GHz WiFi 或有线还不行就降一档分辨率或帧率再把max_bitrate回调到与带宽相称的档位。NVIDIA 显卡可在系统里打开Fast SyncAMD 在 Windows 里打开Enhanced Sync两者都能再省一点延迟细节见 性能调优文档。串流失败排查三列表出问题时按这张表对照绝大多数能就地解决。现象原因动作客户端搜不到主机防火墙拦了47990等端口或两端不在同一网段放行 Sunshine 相关端口确认同网段后重启服务再试画面卡顿、帧率上不去带宽不足或码率超出网络承载主机换有线或 5GHz WiFi降一档分辨率 / 帧率回调max_bitrateLinux 下键鼠手柄无响应运行 Sunshine 的用户不在input组虚拟输入设备建不出来执行sudo usermod -aG input $USER退出系统重新登录后生效macOS 手柄配置缺失或无效macOS 版仍属实验性暂不支持虚拟手柄手柄场景换 Windows 或 Linux 主机macOS 主机先用于串桌面和应用日志自查入口仍无解时打开网页版的Troubleshooting标签里面是全部运行日志逐条点开警告按提示逐条修。后续可深挖的方向与文档入口出画面只是起点。下面这些进阶项都有现成文档按需点开即可4K 与 HDR 串流主机系统先开启 HDR客户端侧同步打开 HDR 选项Linux 上 HDR 依赖 KMS 捕获后端。完整配置参数清单见 配置参考。编码器细节与系统级优化例如 N 卡的 Fast Sync、AMD 的 Enhanced Sync见 性能调优文档。新手入门与快捷键总览见 入门指南。重装系统前先备份配置目录Linux / macOS / FreeBSD 在~/.config/sunshine/Windows 在%LOCALAPPDATA%\LizardByte\Sunshine整个目录拷走、恢复时拷回原位即可。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/11 1:36:21 · 阅读 1.2k Sunshine 实操指南：从安装到 Moonlight 出画面的完整串流路径
Sunshine 实操指南从安装到 Moonlight 出画面的完整串流路径【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine把 PC 游戏串到电视、平板或手机你只需要一台装好 Sunshine 的主机和一个 Moonlight 客户端全程走局域网不经过第三方云免费且延迟低。本文按一张速查卡 五个落地阶段组织先给你端口、命令与参数的速查再依次带你把主机装好、把服务拉起、把网页配好、把客户端连上、把画质调顺每一步都是可直接复制的命令。速查卡端口、服务命令与编码器对照先把最常用的几个值记在脑子里后文每一步都会用到它们。项目值 / 命令说明配置网页端口47990地址https://localhost:47990自签证书会提示不安全忽略即可浏览器提示不安全点继续访问证书自签属正常现象Linux 后台服务名app-dev.lizardbyte.app.Sunshine用户级 systemd 服务也接受别名sunshine.service启动并开机自启systemctl --user enable --now app-dev.lizardbyte.app.SunshineLinux 专用编码器参数encoder取值nvenc/amdvce/quicksync/vaapi/vulkan/software码率上限max_bitrate单位 Kbps官方示例写法max_bitrate 5000多显示器切换快捷键CtrlAltShiftF1~F12与 Moonlight 一致编码器与显卡、平台的对应关系决定你encoder该锁哪个值显卡WindowsLinuxmacOSNVIDIANVENCNVENC不可用AMDAMF (amdvce)VAAPI / Vulkan不可用IntelQuickSyncVAAPI / Vulkan不可用Apple 芯片不可用不可用VideoToolbox冲 4K 60fps 前对照这条门槛线两端都要满足部件最低要求显卡NVIDIA GTX 1080 及以上 / AMD Video Coding Engine 3.1 及以上 / Intel HD 510 及以上网络两端都走有线或至少 5GHz WiFi官方建议两端网络规格保持一致按平台把 Sunshine 装进主机装主机这一步不同平台命令不同但装完后的行为一致都提供一个后台服务或进程去抓屏、编码。Windows 与 Linux 安装包Windows 从项目发布页下载对应架构的安装包AMD64 选Sunshine-Windows-AMD64-installer.msiARM64 设备选 ARM64 版双击安装即可。装完 Sunshine 以系统服务身份在后台运行浏览器会自动弹出配置页地址是https://localhost:47990。Debian / Ubuntu 用包管理器sudo apt update sudo apt install sunshineFedora 用sudo dnf install SunshineopenSUSE 用sudo zypper install Sunshine。系统里没有对应发行版包时下Sunshine_{version}_{arch}.AppImage放进主目录再执行./Sunshine_{version}_{arch}.AppImage --installArch 可用pacman -S sunshine。注意 AppImage 与 Flatpak 都不支持 KMS 捕获能装发行版包就优先装包。macOS、FreeBSD 与 AlpinemacOS 需 14.2 以上两行命令装完brew tap LizardByte/homebrew brew install sunshine首次启动会弹出系统授权框把屏幕录制和麦克风两项都允许。FreeBSD 从发布页下载对应架构的.pkg再执行sudo pkg install ./Sunshine-{version}-{arch}.pkg。Alpine 用apk add --allow-untrusted ./sunshine_{version}_alpine{distro-version}_{arch}.apk。macOS 版目前是实验性状态虚拟手柄暂不可用串桌面、串应用没问题手柄玩家建议直接用 Windows 或 Linux 主机。拉起后台服务并进入配置网页装完不等于跑起来。Linux 下要手动把用户级服务拉起并设为开机自启Windows 装完已自启macOS 装完首次启动即授权。Linux 用户级 systemd 服务一次性启动systemctl --user start app-dev.lizardbyte.app.Sunshine启动并开机自启推荐systemctl --user enable --now app-dev.lizardbyte.app.Sunshine服务名也接受别名sunshine.service。创建管理员账号与添加应用打开https://localhost:47990想在别的设备上操作就把localhost换成主机内网 IP。首次访问会要求创建管理员账号用户名和密码就是之后登录网页、完成配对的唯一凭证务必记牢。应用列表默认带一个Desktop条目选它串出来的就是整个桌面。想单独串某个游戏就点添加填名称和启动命令保存。配置页顶部有搜索栏按关键词定位参数。比如搜encoder编码器设置立刻出现。完整参数清单见 配置参考。Moonlight 客户端 PIN 配对出画面客户端侧装一个 Moonlight各应用商店搜 Moonlight 即可Android、iOS、macOS、Windows 都有官方版设备必须和主机在同一局域网。装好后客户端会自动扫描列表里出现你装好 Sunshine 的主机。四步配对在 Moonlight 里点连接主机屏幕弹出一个PIN 码。登录网页版点导航栏的PIN页。把 PIN 码输进去再给这台设备起个名字保存会看到成功提示。回 Moonlight选Desktop或你加过的应用开始串流。画面出来后电视上的按键、鼠标、手柄操作会实时传回主机。多显示器与快捷键串多显示器时用快捷键切到另一个屏幕CtrlAltShiftF1到F12数字对应显示器编号。串远程桌面模式时CtrlAltShiftN可隐藏 / 显示光标。所有快捷键都以CtrlAltShift起头和 Moonlight 客户端约定一致。编码器与码率三参数调优出画面后画质不满意绝大多数问题出在编码器和码率这两组参数上。在配置页顶部搜索栏搜encoder与max_bitrate即可直达对应设置。锁定硬件编码器默认行为是自动选用第一个可用的编码器手动锁定更稳。搜encoderNVIDIA 显卡设nvencAMD 显卡设amdvceIntel 核显设quicksyncLinux 无独显可用vaapi或vulkan码率与帧率取舍画面发糊主因是码率偏低。搜max_bitrate单位 Kbps按家里带宽往上加官方示例写法是max_bitrate 5000。卡顿、帧率上不去多半是带宽不足或码率与网络不匹配。先把主机换到 5GHz WiFi 或有线还不行就降一档分辨率或帧率再把max_bitrate回调到与带宽相称的档位。NVIDIA 显卡可在系统里打开Fast SyncAMD 在 Windows 里打开Enhanced Sync两者都能再省一点延迟细节见 性能调优文档。串流失败排查三列表出问题时按这张表对照绝大多数能就地解决。现象原因动作客户端搜不到主机防火墙拦了47990等端口或两端不在同一网段放行 Sunshine 相关端口确认同网段后重启服务再试画面卡顿、帧率上不去带宽不足或码率超出网络承载主机换有线或 5GHz WiFi降一档分辨率 / 帧率回调max_bitrateLinux 下键鼠手柄无响应运行 Sunshine 的用户不在input组虚拟输入设备建不出来执行sudo usermod -aG input $USER退出系统重新登录后生效macOS 手柄配置缺失或无效macOS 版仍属实验性暂不支持虚拟手柄手柄场景换 Windows 或 Linux 主机macOS 主机先用于串桌面和应用日志自查入口仍无解时打开网页版的Troubleshooting标签里面是全部运行日志逐条点开警告按提示逐条修。后续可深挖的方向与文档入口出画面只是起点。下面这些进阶项都有现成文档按需点开即可4K 与 HDR 串流主机系统先开启 HDR客户端侧同步打开 HDR 选项Linux 上 HDR 依赖 KMS 捕获后端。完整配置参数清单见 配置参考。编码器细节与系统级优化例如 N 卡的 Fast Sync、AMD 的 Enhanced Sync见 性能调优文档。新手入门与快捷键总览见 入门指南。重装系统前先备份配置目录Linux / macOS / FreeBSD 在~/.config/sunshine/Windows 在%LOCALAPPDATA%\LizardByte\Sunshine整个目录拷走、恢复时拷回原位即可。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考