Sunshine 串流服务器安装指南从装好到 20 分钟出第一帧【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一个自托管的游戏串流主机配合 Moonlight 客户端使用把一台主机变成局域网内的串流服务器。读完这篇你能独立完成 Sunshine 安装教程装包、起服务、建 Web UI 账号、Moonlight 配对、加第一个应用并把第一帧画面串出来。装 Sunshine 前先判断谁适合谁不适合适合有一台性能不错的家用主机游戏主机、NAS 里加一张独显都行想把它变成任意设备可看可玩的中心。想在手机、平板、电视盒子上远程玩 PC 游戏或者把主机当远程桌面用。有一张带硬件编码的 GPUNVENC / QuickSync / AMF VCE / VAAPI或有较新的 CPU 走软编码。不适合 / 需要再想想想远程办公跑 3A 但两台设备不在同一局域网且没做公网映射——upnp能救一部分但不保证。主机 CPU 太老低于 Ryzen 3 / i3 一代、内存不足 4GB软编码会掉帧严重。macOS 主机官方标注为实验性手柄模拟目前不可用。动手前清单项目最低 / 建议怎么查主机系统Windows 11 / Ubuntu 22.04 / Debian 13 / Fedora 43 / macOS 14.2 / FreeBSD 15.1winver、lsb_release -a、sw_vers显卡带 NVENC / QuickSync / AMF VCE / VAAPI 之一没有就软编码兜底lspci \| grep -i vga、设备管理器内存≥ 4 GB系统信息网络主机与客户端同网段有线优先无线建议 5GHz 802.11ac路由后台看 IP前置工具客户端侧装 MoonlightLinux 侧确保systemd --user可用官网下载 Moonlight这张图展示了第一次打开 Web UI 时的欢迎页右侧导航栏可以看到 PIN 配对、Applications、Config 等入口是后面步骤的主界面。装好 Sunshine 的最小路径五步跑通Step 1装包按平台选一条Windows下载Sunshine-Windows-AMD64-installer.msi双击安装。安装器会写好防火墙规则并注册服务。Linux按发行版选 deb / rpm / pacman / AppImage。Debian/Ubuntu 用sudo dpkg -i ./sunshine-{distro}-{ver}-{arch}.debFedora 用sudo dnf copr enable lizardbyte/stable sudo dnf install SunshineArch 走 pacman-repopacman -S sunshine。Flatpak 用户装完必须补跑flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine。macOS把 DMG 里的Sunshine.app拖到 Applications首次启动系统会弹屏幕录制与麦克风授权。怎么算成功终端里能执行到sunshine --help或 Flatpak 下flatpak run --commandsunshine dev.lizardbyte.app.Sunshine --help不报错Windows 服务列表里出现 Sunshine。Step 2把服务跑起来WindowsMSI 已注册为服务无需额外操作。Linuxsystemctl --user start app-dev.lizardbyte.app.Sunshine要开机自启加--now enable。服务名同时有别名sunshine.service。怎么算成功systemctl --user status app-dev.lizardbyte.app.Sunshine显示active (running)Web UI 端口 47990 已在监听。Step 3打开 Web UI 建账号浏览器访问https://localhost:47990自签名证书浏览器会提示不安全点高级 → 继续即可。首次进入会让你设置管理员用户名和密码先记到笔记里后面所有操作都靠它。Web UI 顶部导航下拉可以切主题切换会同步保存不影响功能。Step 4Moonlight 里加主机并配对在客户端设备打开 Moonlight它会自动发现局域网里的 Sunshine同网段。首次连接 Moonlight 会弹出一个四位 PIN。回 Web UI 顶部导航点PIN页把 PIN 输进去并给这台设备起个名字看到成功提示即可。怎么算成功Moonlight 的主机列表里能看到这台 PC展开后默认有一条Desktop应用串整个桌面。Step 5串出第一帧在 Moonlight 里点Desktop开始串流选 1080p / 60fps 就够。怎么算成功客户端出画面、有声音鼠标键盘能操作结束串流后主机侧没有残留进程。这张图是 Applications 页左侧是应用列表右侧是应用详情表单路径、启动参数、启动方式后面加游戏就在这里填。Sunshine 默认参数速查4 个影响体验的开关参数默认什么时候改改了会怎样max_bitrate0跟 Moonlight 走想给主机端带宽封顶填5000表示 5000 Kbps 上限超出自动压encoder自动选第一个可用排障或锁定某条通路填nvenc/quicksync/amdvce/vaapi/vulkan/softwarenvenc_preset1P1 最快网络或解码端顶不住时数字越大压缩越好、延迟越高1-7upnpdisabled想让外网直连填enabledSunshine 会通过路由器自动开端口配置页顶部有搜索框输bitrate或encoder直达不用翻菜单。参数总表在 docs/configuration.md共几千行建议只在改之前查一遍。Sunshine 三种真实用法1瘦终端场景。什么人一台 5 年没升级的轻薄本独显带不动 3A。怎么用笔记本装 Moonlight串流书房那台主机跑游戏分辨率按笔记本屏幕设。预期结果笔记本功耗低、风扇不响游戏画面按主机性能跑。2家庭影音 / 远程桌面场景。什么人想在电视上看主机本地片源或跑日常桌面应用。怎么用Moonlight 里直接选Desktop不启动任何程序max_bitrate保持 0静态内容带宽占用很小。预期结果电视当第二块屏鼠标键盘从客户端回传。3多人共用一台主机。什么人一家人共用一台 PC。怎么用每个成员各自的 Moonlight 设备独立配对Web UI 里 PIN 页给设备起区分名。预期结果谁在串谁用同一时刻只有一条串流前一个没退出就串不进来。快捷键与 Moonlight 一致CtrlAltShiftN隐藏光标CtrlAltShiftF1/F12切显示器。Sunshine 排障速查表症状最可能原因一条操作https://localhost:47990打不开服务没起 / 防火墙拦 47990Linux 跑systemctl --user status app-dev.lizardbyte.app.SunshineWindows 检查 MSI 装完有没有留防火墙规则Moonlight 发现不了主机两台不在同一网段或服务没跑看路由器后台两台设备 IP 是否同段Linux 确认--user服务还在手柄没反应Linux / FreeBSD用户不在input组把用户加入input组后重新登录键盘鼠标没反应WindowsVirtual HID Driver 未装或版本旧装/升级 Virtual HID Driver 到2026.829.2338.54或更新装完重启一次串流卡顿 / 掉帧网络问题丢包 / 抖动不是编码器主机iperf3 -s客户端iperf3 -c {主机IP} -t 60 -u -R -b 50M看丢包与抖动忘了 Web UI 密码—sunshine --creds {new-username} {new-password}直接重置应用串流秒断应用以普通cmd方式拉起、主进程立即退出改用detached启动方式Flatpak 应用加前缀flatpak-spawn --host想清一下再排—看 Web UI Troubleshooting 页这张图是 Troubleshooting 页左侧是告警 / 日志分类右侧是当前运行状态卡住时优先翻这里。日志文件位置默认文件名sunshine.log保留.1到.5共 5 份历史Windows%ProgramData%\Sunshine\sunshine.logLinux / FreeBSD~/.config/sunshine/sunshine.logmacOS~/Library/Logs/Sunshine/sunshine.logDockerdocker logs sunshine收尾 5 条跑通之后照着做把systemctl --user --now enable app-dev.lizardbyte.app.SunshineLinux跑一遍避免重启后忘了手动起服务。给 Moonlight 客户端起设备名PIN 页里给每台设备一个区分名之后排障直接看名字对应到设备。max_bitrate平时留 0 别动先让 Moonlight 自己选码率确认体验后再决定要不要封顶。想远程直连时先把upnp enabled设上然后到路由后台核对 47990 是否真的转发成功。排障顺序先Troubleshooting页 → 再看sunshine.log→ 最后看网络iperf3反向 60 秒 UDP 测一次。参考文档完整参数表docs/configuration.md排障索引docs/troubleshooting.md安装全平台说明docs/getting_started.md编码与采集实现src/platform/【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Sunshine 串流服务器安装指南：从装好到 20 分钟出第一帧
Sunshine 串流服务器安装指南从装好到 20 分钟出第一帧【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一个自托管的游戏串流主机配合 Moonlight 客户端使用把一台主机变成局域网内的串流服务器。读完这篇你能独立完成 Sunshine 安装教程装包、起服务、建 Web UI 账号、Moonlight 配对、加第一个应用并把第一帧画面串出来。装 Sunshine 前先判断谁适合谁不适合适合有一台性能不错的家用主机游戏主机、NAS 里加一张独显都行想把它变成任意设备可看可玩的中心。想在手机、平板、电视盒子上远程玩 PC 游戏或者把主机当远程桌面用。有一张带硬件编码的 GPUNVENC / QuickSync / AMF VCE / VAAPI或有较新的 CPU 走软编码。不适合 / 需要再想想想远程办公跑 3A 但两台设备不在同一局域网且没做公网映射——upnp能救一部分但不保证。主机 CPU 太老低于 Ryzen 3 / i3 一代、内存不足 4GB软编码会掉帧严重。macOS 主机官方标注为实验性手柄模拟目前不可用。动手前清单项目最低 / 建议怎么查主机系统Windows 11 / Ubuntu 22.04 / Debian 13 / Fedora 43 / macOS 14.2 / FreeBSD 15.1winver、lsb_release -a、sw_vers显卡带 NVENC / QuickSync / AMF VCE / VAAPI 之一没有就软编码兜底lspci \| grep -i vga、设备管理器内存≥ 4 GB系统信息网络主机与客户端同网段有线优先无线建议 5GHz 802.11ac路由后台看 IP前置工具客户端侧装 MoonlightLinux 侧确保systemd --user可用官网下载 Moonlight这张图展示了第一次打开 Web UI 时的欢迎页右侧导航栏可以看到 PIN 配对、Applications、Config 等入口是后面步骤的主界面。装好 Sunshine 的最小路径五步跑通Step 1装包按平台选一条Windows下载Sunshine-Windows-AMD64-installer.msi双击安装。安装器会写好防火墙规则并注册服务。Linux按发行版选 deb / rpm / pacman / AppImage。Debian/Ubuntu 用sudo dpkg -i ./sunshine-{distro}-{ver}-{arch}.debFedora 用sudo dnf copr enable lizardbyte/stable sudo dnf install SunshineArch 走 pacman-repopacman -S sunshine。Flatpak 用户装完必须补跑flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine。macOS把 DMG 里的Sunshine.app拖到 Applications首次启动系统会弹屏幕录制与麦克风授权。怎么算成功终端里能执行到sunshine --help或 Flatpak 下flatpak run --commandsunshine dev.lizardbyte.app.Sunshine --help不报错Windows 服务列表里出现 Sunshine。Step 2把服务跑起来WindowsMSI 已注册为服务无需额外操作。Linuxsystemctl --user start app-dev.lizardbyte.app.Sunshine要开机自启加--now enable。服务名同时有别名sunshine.service。怎么算成功systemctl --user status app-dev.lizardbyte.app.Sunshine显示active (running)Web UI 端口 47990 已在监听。Step 3打开 Web UI 建账号浏览器访问https://localhost:47990自签名证书浏览器会提示不安全点高级 → 继续即可。首次进入会让你设置管理员用户名和密码先记到笔记里后面所有操作都靠它。Web UI 顶部导航下拉可以切主题切换会同步保存不影响功能。Step 4Moonlight 里加主机并配对在客户端设备打开 Moonlight它会自动发现局域网里的 Sunshine同网段。首次连接 Moonlight 会弹出一个四位 PIN。回 Web UI 顶部导航点PIN页把 PIN 输进去并给这台设备起个名字看到成功提示即可。怎么算成功Moonlight 的主机列表里能看到这台 PC展开后默认有一条Desktop应用串整个桌面。Step 5串出第一帧在 Moonlight 里点Desktop开始串流选 1080p / 60fps 就够。怎么算成功客户端出画面、有声音鼠标键盘能操作结束串流后主机侧没有残留进程。这张图是 Applications 页左侧是应用列表右侧是应用详情表单路径、启动参数、启动方式后面加游戏就在这里填。Sunshine 默认参数速查4 个影响体验的开关参数默认什么时候改改了会怎样max_bitrate0跟 Moonlight 走想给主机端带宽封顶填5000表示 5000 Kbps 上限超出自动压encoder自动选第一个可用排障或锁定某条通路填nvenc/quicksync/amdvce/vaapi/vulkan/softwarenvenc_preset1P1 最快网络或解码端顶不住时数字越大压缩越好、延迟越高1-7upnpdisabled想让外网直连填enabledSunshine 会通过路由器自动开端口配置页顶部有搜索框输bitrate或encoder直达不用翻菜单。参数总表在 docs/configuration.md共几千行建议只在改之前查一遍。Sunshine 三种真实用法1瘦终端场景。什么人一台 5 年没升级的轻薄本独显带不动 3A。怎么用笔记本装 Moonlight串流书房那台主机跑游戏分辨率按笔记本屏幕设。预期结果笔记本功耗低、风扇不响游戏画面按主机性能跑。2家庭影音 / 远程桌面场景。什么人想在电视上看主机本地片源或跑日常桌面应用。怎么用Moonlight 里直接选Desktop不启动任何程序max_bitrate保持 0静态内容带宽占用很小。预期结果电视当第二块屏鼠标键盘从客户端回传。3多人共用一台主机。什么人一家人共用一台 PC。怎么用每个成员各自的 Moonlight 设备独立配对Web UI 里 PIN 页给设备起区分名。预期结果谁在串谁用同一时刻只有一条串流前一个没退出就串不进来。快捷键与 Moonlight 一致CtrlAltShiftN隐藏光标CtrlAltShiftF1/F12切显示器。Sunshine 排障速查表症状最可能原因一条操作https://localhost:47990打不开服务没起 / 防火墙拦 47990Linux 跑systemctl --user status app-dev.lizardbyte.app.SunshineWindows 检查 MSI 装完有没有留防火墙规则Moonlight 发现不了主机两台不在同一网段或服务没跑看路由器后台两台设备 IP 是否同段Linux 确认--user服务还在手柄没反应Linux / FreeBSD用户不在input组把用户加入input组后重新登录键盘鼠标没反应WindowsVirtual HID Driver 未装或版本旧装/升级 Virtual HID Driver 到2026.829.2338.54或更新装完重启一次串流卡顿 / 掉帧网络问题丢包 / 抖动不是编码器主机iperf3 -s客户端iperf3 -c {主机IP} -t 60 -u -R -b 50M看丢包与抖动忘了 Web UI 密码—sunshine --creds {new-username} {new-password}直接重置应用串流秒断应用以普通cmd方式拉起、主进程立即退出改用detached启动方式Flatpak 应用加前缀flatpak-spawn --host想清一下再排—看 Web UI Troubleshooting 页这张图是 Troubleshooting 页左侧是告警 / 日志分类右侧是当前运行状态卡住时优先翻这里。日志文件位置默认文件名sunshine.log保留.1到.5共 5 份历史Windows%ProgramData%\Sunshine\sunshine.logLinux / FreeBSD~/.config/sunshine/sunshine.logmacOS~/Library/Logs/Sunshine/sunshine.logDockerdocker logs sunshine收尾 5 条跑通之后照着做把systemctl --user --now enable app-dev.lizardbyte.app.SunshineLinux跑一遍避免重启后忘了手动起服务。给 Moonlight 客户端起设备名PIN 页里给每台设备一个区分名之后排障直接看名字对应到设备。max_bitrate平时留 0 别动先让 Moonlight 自己选码率确认体验后再决定要不要封顶。想远程直连时先把upnp enabled设上然后到路由后台核对 47990 是否真的转发成功。排障顺序先Troubleshooting页 → 再看sunshine.log→ 最后看网络iperf3反向 60 秒 UDP 测一次。参考文档完整参数表docs/configuration.md排障索引docs/troubleshooting.md安装全平台说明docs/getting_started.md编码与采集实现src/platform/【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考