Sunshine家庭游戏串流服务器完全实操手册【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine在客厅电视上玩 PC 游戏到卧室平板上无缝接着打是很多玩家的日常需求。卡点往往不在游戏库而在传输链路商业云游戏要会员第三方平台有延迟和画质上限。Sunshine 是一款自托管游戏串流服务器跑在你自己的电脑里配合各设备上的 Moonlight 客户端低延迟推送画面。本文从零开始带你完成安装、配对、添加游戏、调优与排障。先弄懂它Sunshine 是免费开源的自托管串流主机。宿主端装在你的 PC 上负责截屏、硬件编码和分发观看端使用 Moonlight 客户端手机、平板、电视都能跑。不需要理解视频传输原理只要分清两个角色组成作用运行位置Sunshine截屏、编码、分发管理配对Windows / Linux / macOS实验性/ FreeBSDMoonlight解码播放、回传输入Windows、macOS、Linux、Android、iOS 及各类电视平台Web UI配置、配对、查日志浏览器访问 47990 端口首次启动会让你创建 Web UI 账号之后主要工作在添加应用和配对两件事。五分钟跑起来先看硬件门槛官方标注这是最低要求组件要求GPUAMD VCE 1.0 / Intel 支持 QuickSync 或 VAAPI / Nvidia 支持 NVENCCPUIntel Core i3 或 AMD Ryzen 3 及以上内存4GB 或更多系统Windows 11 / Debian 13 / Ubuntu 22.04 / Fedora 43 / macOS 14.2网络双端 5GHz 802.11ac4K 建议有线各平台安装方式Windows从最新 release 下载 MSI 安装器官方推荐运行后按需勾选防火墙规则、系统服务等选项装完即跑。Debian/Ubuntucurl -1sLf https://dl.cloudsmith.io/public/lizardbyte/stable/cfg/setup/bash.deb.sh | sudo -E bash sudo apt update sudo apt install sunshineFedora/openSUSE 有对应的 rpm 脚本与dnf/zypper安装流程相同。macOSbrew tap LizardByte/homebrew brew install sunshine首次启动需授予屏幕录制与麦克风权限。注意 macOS 版本仍是实验性不支持手柄。Linux 上装好后建议以用户服务方式常驻systemctl --user --now enable app-dev.lizardbyte.app.Sunshine最后用浏览器打开https://localhost:47990进入管理页开始配置。核心功能怎么用添加串流目标在 Web UI 的Applications页面添加想串流的内容常见三类Desktop串整个桌面无需命令、Steam 或具体游戏填命令与工作目录、独立程序。以 Steam 游戏为例命令填steam://rungameid/464920并放入 detached commands。易踩的坑不要把steam写成普通 cmdSteam 启动后原进程会自我结束串流会立刻失败。更多写法可参考应用示例。配对 Moonlight 客户端在 Moonlight 中搜索 Sunshine 主机发现不了就手动添加 IP。客户端提示输入 PIN 时打开 Web UI 的PIN页面填入同一个 PIN 并给设备起个名字配对即完成。之后在 Moonlight 里选中应用直接开始串流。选择编码器与捕获方式配置页有搜索框可按名字直接定位选项完整说明见配置说明。核心是encoder编码器和capture捕获方式encoder适用 GPU平台nvencNvidiaWindows、LinuxquicksyncIntelWindowsamdvceAMDWindowsvaapiAMD、Intel、NvidiaLinuxvulkanAMD、Intel、NvidiaLinuxsoftware任意CPU 编码全部平台默认自动选第一个可用的一般不用动。Linux 捕获方式还有 kms、kwin、x11、nvfbc 等。易踩的坑AppImage 和 Flatpak 处于沙箱中kms 捕获不可用黑屏时改用原生 deb/rpm 包或切换到 kwin/portal 捕获。按场景调优本地有线 4K/60编码器与 GPU 保持匹配避免掉回 software网络是瓶颈时设max_bitrate单位 Kbps给码率封顶软件编码启动慢时把min_threads从默认 2 往上加取能稳定达到目标帧率的最低值Windows 上可开启 Fast SyncNvidia或 Enhanced SyncAMD再省一帧延迟手柄游玩gamepad默认 auto可显式指定 ds5、xseries 等型号Windows 必须安装 Virtual HID Driver否则没有虚拟手柄Linux 确认用户已加入 input 组Wi-Fi 或远程连接提高fec_percentage默认 20用带宽换抗丢包链路 MTU 受限时设packetsize如 1346并同步降低码率先用 iperf3 摸底丢包低于 5%、抖动低于 1ms 才算合格iperf3 -c 主机IP -t 60 -u -R -b 50M出问题了怎么办现象可能原因解法Web UI 打不开防火墙拦截检查防火墙规则放行 47990 端口忘记管理账号首次凭据未保存停止服务后运行sunshine --creds 新用户 新密码重置键鼠手柄无响应Linux无输入设备权限sudo usermod -aG input $USER后重新登录虚拟手柄不出现Windows未装 Virtual HID Driver安装该驱动并重启KMS 捕获黑屏Nvidia内核参数未开内核参数加nvidia_drm.modeset1画面卡顿、丢包多主机网卡快于下游链路缓冲溢出降码率或用 tc 限速主机上 Sunshine 流量Nvidia 串流掉帧开了 vsync:fast在 Nvidia 控制面板关闭拿不准时按这个流程走日志看两处一是 Web UI 的Troubleshooting页可以逐条翻阅警告和错误二是配置目录里的sunshine.log保留最近 5 份Linux 在~/.config/sunshineWindows 在%ProgramFiles%\Sunshine\config。优先找 Error再看 Warning。更多条目见故障排查指南。再往前一步串流 HDRWindows 正式支持Linux 为实验性。先在宿主系统开启 HDR可能需要 HDR 显示器或 EDID dongleLinux 走 KMS 捕获加 10-bit 编码Moonlight 端也要打开 HDR否则画面会过曝。外网连接设upnp enabled让 Sunshine 自动开放端口origin_web_ui_allowed默认 lan远程管理时改为 wan跨网串流建议保持wan_encryption_mode 1以上。启动游戏前自动换分辨率用 prep 命令实现X11 用xrandrKDE 用kscreen-doctorWindows 内置dd_resolution_option manual配dd_manual_resolution无需第三方工具。快捷键都以CtrlAltShift开头。F1/F12切换串流显示器N隐藏/显示光标。Sunshine 把家里的游戏电脑变成一台随时可用的串流服务器。建议的节奏前 10 分钟装好并打开 Web UI当天配上一台手机或电视把一款游戏串起来本周再调编码器与码率试一次 HDR 或外网连接。资源导航快速上手配置说明故障排查应用示例源码目录祝串流愉快 【免费下载链接】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 是免费开源的自托管串流主机。宿主端装在你的 PC 上负责截屏、硬件编码和分发观看端使用 Moonlight 客户端手机、平板、电视都能跑。不需要理解视频传输原理只要分清两个角色组成作用运行位置Sunshine截屏、编码、分发管理配对Windows / Linux / macOS实验性/ FreeBSDMoonlight解码播放、回传输入Windows、macOS、Linux、Android、iOS 及各类电视平台Web UI配置、配对、查日志浏览器访问 47990 端口首次启动会让你创建 Web UI 账号之后主要工作在添加应用和配对两件事。五分钟跑起来先看硬件门槛官方标注这是最低要求组件要求GPUAMD VCE 1.0 / Intel 支持 QuickSync 或 VAAPI / Nvidia 支持 NVENCCPUIntel Core i3 或 AMD Ryzen 3 及以上内存4GB 或更多系统Windows 11 / Debian 13 / Ubuntu 22.04 / Fedora 43 / macOS 14.2网络双端 5GHz 802.11ac4K 建议有线各平台安装方式Windows从最新 release 下载 MSI 安装器官方推荐运行后按需勾选防火墙规则、系统服务等选项装完即跑。Debian/Ubuntucurl -1sLf https://dl.cloudsmith.io/public/lizardbyte/stable/cfg/setup/bash.deb.sh | sudo -E bash sudo apt update sudo apt install sunshineFedora/openSUSE 有对应的 rpm 脚本与dnf/zypper安装流程相同。macOSbrew tap LizardByte/homebrew brew install sunshine首次启动需授予屏幕录制与麦克风权限。注意 macOS 版本仍是实验性不支持手柄。Linux 上装好后建议以用户服务方式常驻systemctl --user --now enable app-dev.lizardbyte.app.Sunshine最后用浏览器打开https://localhost:47990进入管理页开始配置。核心功能怎么用添加串流目标在 Web UI 的Applications页面添加想串流的内容常见三类Desktop串整个桌面无需命令、Steam 或具体游戏填命令与工作目录、独立程序。以 Steam 游戏为例命令填steam://rungameid/464920并放入 detached commands。易踩的坑不要把steam写成普通 cmdSteam 启动后原进程会自我结束串流会立刻失败。更多写法可参考应用示例。配对 Moonlight 客户端在 Moonlight 中搜索 Sunshine 主机发现不了就手动添加 IP。客户端提示输入 PIN 时打开 Web UI 的PIN页面填入同一个 PIN 并给设备起个名字配对即完成。之后在 Moonlight 里选中应用直接开始串流。选择编码器与捕获方式配置页有搜索框可按名字直接定位选项完整说明见配置说明。核心是encoder编码器和capture捕获方式encoder适用 GPU平台nvencNvidiaWindows、LinuxquicksyncIntelWindowsamdvceAMDWindowsvaapiAMD、Intel、NvidiaLinuxvulkanAMD、Intel、NvidiaLinuxsoftware任意CPU 编码全部平台默认自动选第一个可用的一般不用动。Linux 捕获方式还有 kms、kwin、x11、nvfbc 等。易踩的坑AppImage 和 Flatpak 处于沙箱中kms 捕获不可用黑屏时改用原生 deb/rpm 包或切换到 kwin/portal 捕获。按场景调优本地有线 4K/60编码器与 GPU 保持匹配避免掉回 software网络是瓶颈时设max_bitrate单位 Kbps给码率封顶软件编码启动慢时把min_threads从默认 2 往上加取能稳定达到目标帧率的最低值Windows 上可开启 Fast SyncNvidia或 Enhanced SyncAMD再省一帧延迟手柄游玩gamepad默认 auto可显式指定 ds5、xseries 等型号Windows 必须安装 Virtual HID Driver否则没有虚拟手柄Linux 确认用户已加入 input 组Wi-Fi 或远程连接提高fec_percentage默认 20用带宽换抗丢包链路 MTU 受限时设packetsize如 1346并同步降低码率先用 iperf3 摸底丢包低于 5%、抖动低于 1ms 才算合格iperf3 -c 主机IP -t 60 -u -R -b 50M出问题了怎么办现象可能原因解法Web UI 打不开防火墙拦截检查防火墙规则放行 47990 端口忘记管理账号首次凭据未保存停止服务后运行sunshine --creds 新用户 新密码重置键鼠手柄无响应Linux无输入设备权限sudo usermod -aG input $USER后重新登录虚拟手柄不出现Windows未装 Virtual HID Driver安装该驱动并重启KMS 捕获黑屏Nvidia内核参数未开内核参数加nvidia_drm.modeset1画面卡顿、丢包多主机网卡快于下游链路缓冲溢出降码率或用 tc 限速主机上 Sunshine 流量Nvidia 串流掉帧开了 vsync:fast在 Nvidia 控制面板关闭拿不准时按这个流程走日志看两处一是 Web UI 的Troubleshooting页可以逐条翻阅警告和错误二是配置目录里的sunshine.log保留最近 5 份Linux 在~/.config/sunshineWindows 在%ProgramFiles%\Sunshine\config。优先找 Error再看 Warning。更多条目见故障排查指南。再往前一步串流 HDRWindows 正式支持Linux 为实验性。先在宿主系统开启 HDR可能需要 HDR 显示器或 EDID dongleLinux 走 KMS 捕获加 10-bit 编码Moonlight 端也要打开 HDR否则画面会过曝。外网连接设upnp enabled让 Sunshine 自动开放端口origin_web_ui_allowed默认 lan远程管理时改为 wan跨网串流建议保持wan_encryption_mode 1以上。启动游戏前自动换分辨率用 prep 命令实现X11 用xrandrKDE 用kscreen-doctorWindows 内置dd_resolution_option manual配dd_manual_resolution无需第三方工具。快捷键都以CtrlAltShift开头。F1/F12切换串流显示器N隐藏/显示光标。Sunshine 把家里的游戏电脑变成一台随时可用的串流服务器。建议的节奏前 10 分钟装好并打开 Web UI当天配上一台手机或电视把一款游戏串起来本周再调编码器与码率试一次 HDR 或外网连接。资源导航快速上手配置说明故障排查应用示例源码目录祝串流愉快 【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
