Sunshine 自托管游戏串流部署指南从装好主机到客厅大屏【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine周五晚上你想把游戏主机接上客厅电视玩 3A 大作却不想搬主机也不想牺牲画质。Sunshine自托管游戏串流服务器干的就是这件事把电脑里的游戏实时编码、通过网络送到 Moonlight 客户端播放。它完全跑在你自己的网络上不经过第三方服务器延迟和画质都掌握在你手里。 项目速览Sunshine 是什么、适合谁Sunshine 是 Moonlight 生态的自托管串流服务端定位为家里那台能串流的电脑。它只负责把画面、音频和输入信号搬运起来解码和播放交给各端 Moonlight 客户端。硬件编码——支持 NVENC、AMF、QuickSync、VAAPI、VideoToolbox 等 GPU 编码CPU 基本不加班Web 管理界面——浏览器里完成配置、客户端配对和应用管理跨平台宿主——Windows、Linux、macOS、FreeBSD 都能装手柄模拟——把客户端的键鼠手柄映射成主机可识别的虚拟设备安装完成后浏览器里第一眼看到的界面从这里进入所有设置 部署路径怎么选装 Sunshine 前先做这道选择题官方推荐直接用预编译包docs/getting_started.md 也是这么写的Windows 下载 MSI 双击安装Linux 按发行版下载 deb/rpm 安装sudo dpkg -i ./sunshine-{distro}-{version}-{arch}.deb # Debian/Ubuntu sudo dnf install ./Sunshine-{version}.{distro}.{arch}.rpm # Fedora/openSUSE ./sunshine.AppImage --install # 其他 Linux 发行版没有对应发行版包时才考虑以下方案方案适合谁一句话说明Flatpak包管理保守的 Linux 用户沙盒运行但不支持 KMS 捕获Docker需要隔离环境或快速测试的人官方明确不推荐给大多数用户源码编译想改代码的开发者git clone https://gitcode.com/GitHub_Trending/su/Sunshine后走 CMake 构建 第一次跑起来三个动作串起 Sunshine1. 登录 Web 界面。装好后 Sunshine 会在 47990 端口打开管理界面浏览器访问https://localhost:47990即可替换 localhost 为内网 IP 也能从手机配对。浏览器提示不安全是正常的证书是自签的。首次登录会让你创建用户名和密码先记下来。应用管理页每个游戏一行命令点一下就能开始串流2. 配好应用和设置。在 Applications 页添加游戏Desktop 应用开箱即用不启动任何程序、直接串整个桌面。进设置页前记得先选主题搜配置项比翻列表快得多——在搜索框里直接输upnp、port、ws_port就能定位默认端口是 47990Web和 47989串流 WebSocket开 UPnP 后路由器会自动帮你转发。配置项多用顶部搜索框定位是最快的办法3. 用 Moonlight 客户端配对。客户端里添加主机Sunshine 会弹出一串 PIN到 Web 界面导航栏的 PIN 页输入并给设备起个名字配对成功后之后同一台设备免 PIN 直连。串起来之后还有几件小事。串流中CtrlAltShiftN可隐藏/显示光标CtrlAltShiftF1到F12切换串流显示器Linux 上建议注册服务并开机自启systemctl --user --now enable app-dev.lizardbyte.app.SunshineWindows 上键盘鼠标和完整手柄模拟依赖单独安装的 Virtual HID Driver安装器可带装macOS 首次运行要授予屏幕录制和麦克风权限且目前手柄暂不支持、属于实验性功能。️ 按场景给方案调 Sunshine 到最顺手客厅大屏。想上 HDR主机系统先激活 HDRMoonlight 客户端也要勾选 HDR 选项两者缺一不可Windows 宿主官方支持Linux 宿主实验性支持且 Linux 必须用 KMS 捕获编码器要支持 HEVC Main 10 或 AV1 10-bit如 Intel/AMD 走 VAAPI。无 HDR 显示可用 EDID 模拟头串流前单独校一次亮度。平板、手机、电视盒子。各端装 Moonlight 官方客户端即可配对一次长期有效电视盒子可用嵌入式版本。把游戏提前加进应用列表远端一点即串纯远程桌面场景记得用CtrlAltShiftN隐藏光标。家庭多人共用。每台设备单独配对、PIN 页给设备起可辨认的名字方便区分和排查。应用列表是全局共享的谁都能一键启动。⚠️ 避坑指南高频问题自查表遇到问题先看 docs/troubleshooting.md再对照这张表现象可能原因解决办法客户端找不到主机防火墙拦了 47990 端口或 UPnP 未生效放行 47990TCP及串流端口确认 UPnP 开关输入不响应Linux 用户不在input组Windows 没装 Virtual HID DriverLinux 把用户加入 input 组并重新登录Windows 装驱动后重启卡顿、帧率低硬件编码器没启用或 Wi-Fi 带宽不够确认编码器为硬件编码换 5GHz 频段或改有线HDR 无效果主机未激活 HDR 或客户端未勾选 HDR两端都开 HDRLinux 换 KMS 捕获并确认编码器支持 10-bit音频缺失音频输出设备未指定Linux 缺虚拟声卡macOS 留空 Audio Sink 走系统回环Linux 用虚拟 sink 或装 Steam 音频驱动外置独显捕获不到Windows 桌面复制 API 只捕获负责显示的 GPU给独显接显示器或 HDMI 假负载游戏跑在该显示输出上Web 界面的 Troubleshooting 页汇总了全部警告和错误排查从这里开始 生态与方向Moonlight 官方客户端覆盖 PC、Android、iOS 和嵌入式设备Sunshine 只管串流端两端解耦。技术走向上编码矩阵会随 GPU 厂商继续扩展新编码接口HDR 支持也在 Linux 宿主上逐步铺开具体节奏可跟踪 docs/changelog.md。部署完成前过一遍这张清单浏览器能打开https://localhost:47990账号密码已记录确认编码器是硬件编码UPnP 与串流端口符合预期应用列表里至少有一个可启动的游戏外加 Desktop输入侧就绪Linux 已入 input 组 / Windows 已装 Virtual HID Driver串流过一次后翻过一遍 Troubleshooting 页无新增警告现在就可以打开 Moonlight选 Desktop 应用串一场先把链路跑通再逐个把游戏填进列表。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考