3 步把游戏 PC 变成 Moonlight 串流主机Sunshine 完整上手指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想在客厅电视、平板甚至手机上玩 PC 游戏游戏主机连得上PC 游戏却玩不了Sunshine 就是为此而生一个跑在游戏 PC 上的自托管游戏串流主机负责抓取画面、压缩并推送出去接收端的 Moonlight 客户端装在电视、平板、手机上负责显示画面、回传输入。开源免费、无订阅硬件门槛只要求主机 PC 能跑游戏。一句话定位Sunshine 跑在 PC 上的自托管游戏串流主机 浏览器管理面板。要点速览主机平台Windows、Linux、macOS实验性、FreeBSD客户端任意设备上的 Moonlight 客户端编码NVIDIA / AMD / Intel / Apple 硬件编码CPU 软编兜底管理面板内置 Web UI默认端口47990成本开源免费无订阅费快速上手从安装到第一次串流只要 3 步从零到看到第一帧串流画面10 分钟以内。第 1 步安装 Sunshine。按平台任选一条通道winget install LizardByte.Sunshine flatpak install --system flathub dev.lizardbyte.app.Sunshine brew install sunshineFlatpak 装完还要再跑一次flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine否则虚拟输入权限不生效。验证信号终端执行sunshine --help能打出版本信息。第 2 步启动并打开管理面板。Linux 上直接开用户级服务systemctl --user --now enable app-dev.lizardbyte.app.Sunshine没装成服务就直接在终端敲sunshine。启动后浏览器打开默认地址https://localhost:47990。浏览器提示不安全只是自签名证书忽略即可。⚠️ 首次启动会让你创建用户名和密码——当场抄下来忘了只能靠命令行重置凭据。第 3 步配对 Moonlight 客户端。在 Moonlight 里添加这台主机客户端会显示一个 PIN把它填进 Sunshine 顶部导航的 PIN 页面给设备起个名字配对即完成。随后选 Desktop 启动——电视或平板上出现主机桌面的那一刻就代表全部配好了。核心能力先看懂一条数据流再谈它能干什么先看主线流程能力点就串起来了。Sunshine 先用捕获后端Linux 上是 KMS、X11、Wayland portalWindows 上是 WGC把画面抓下来再交给硬件编码器在 GPU 上压缩画面几乎不占 CPU实时压成视频流发到网络上Moonlight 客户端解码播放。输入则反向走——你在客户端侧的键鼠、手柄会在主机上被虚拟成真实设备游戏里看到的就是插在本机上的那个控制器。配置全在浏览器里不碰配置文件能干什么选编码器、分辨率、码率、音频设备管理应用列表、查日志全在浏览器完成。 怎么用登录 Web UI 后侧边栏按 AudioVideo / Applications / Advanced / Network 分标签顶部有搜索框直接输参数名就能跳转不用一页页翻。 坑在哪界面语言在 General 标签里改locale改完刷新页面才生效。给每个游戏一个一键启动入口能干什么每个游戏/应用建一个条目在 Moonlight 里点它就直接启动并开串流。 怎么用Applications 标签点 Add New填名称、可执行文件路径、工作目录还可以加prep-cmd启动前执行的命令。默认条目定义在 src_assets/linux/assets/apps.json桌面、Steam 大屏两个。坑在哪三条固定规则——点新应用会先结束当前正在串流的那个任何前置命令执行失败就放弃启动被拉起的应用退出串流也随之结束。怎么挑编码器能干什么用 GPU 压画面把延迟和 CPU 占用都压下来。 怎么用AudioVideo 标签里选与你显卡匹配的 APISunshine 会自动探测默认选择一般就是对的。支持矩阵摘自 README编码 API适用显卡LinuxWindowsmacOSNVENCNVIDIA支持支持—QuickSyncIntel—支持—AMFAMD—支持—Vulkan VideoAMD / Intel支持部分——VAAPIAMD / Intel支持——VideoToolboxApple——支持软编CPU任意支持支持支持坑在哪没有独显时1080p 软编会让 CPU 占用明显上升能硬编就别硬扛Linux 上 NvFBC 捕获只能搭配 NVENC捕获方式和编码器要成对挑README 里有捕获→编码兼容性对照表。客户端的手柄变成主机的手柄能干什么手柄插在客户端设备上主机自动虚拟出同款控制器传给游戏。 怎么用插上手柄 → 配对 → 启动游戏即可。Linux 依赖 uinputWindows 需另装虚拟 HID 驱动装完建议重启。 坑在哪macOS 主机暂不支持手柄驱动激活状态在 Web UI 的 Troubleshooting 页和系统托盘里都能查。实战用法两个最值得试的典型玩法玩法一把整台 PC 当远程桌面目标在平板或手机上操作整台 PC远程办公或当第二台显示器准备无Desktop 条目默认自带操作Moonlight 里选 Desktop 启动串流它不拉起任何程序直接串桌面验证结果客户端看到主机桌面按CtrlAltShiftN隐藏鼠标指针F1/F12 变体快捷键可以切换串流显示器玩法二用客户端手柄打游戏目标DualSense 插在手机上游戏里直接用真手柄玩准备Linux 把用户加入input组后重新登录Windows 装好虚拟 HID 驱动并重启操作插入手柄配对启动目标游戏验证结果主机生成了对应的虚拟手柄Troubleshooting 页可查游戏识别为该型号控制器按键、震动都正常常见问题5 个高频问答你踩到的坑大概率在这五个问题里。Q后台密码忘了怎么进去凭据只存在本机。先停掉 Sunshine然后执行sunshine --creds 新用户名 新密码再用新凭据登录。Q浏览器打开 47990 端口没反应多半是服务没跑起来或防火墙拦了。先看服务状态systemctl --user status app-dev.lizardbyte.app.Sunshine没启动就把它拉起来在跑着就放行防火墙的 47990 端口。Q画面频繁卡顿、丢包是不是编码器选错了八成不是编码器是网络Sunshine 的发送节奏是每 16ms 突出一帧数据对应 60fps路径上任何一段比主机慢缓冲就会被冲爆。先用 iPerf3 测稳定性主机iperf3 -s客户端iperf3 -c {主机IP} -t 60 -u -R -b 50M丢包低于 5%、抖动低于 1ms 才算合格确属速率差导致的话把主机网卡降速或升级到 0.23.1 之后的版本突发发送逻辑已优化。QLinux 上连上之后键鼠没反应运行 Sunshine 的用户没有 uinput 权限sudo usermod -aG input $USER重新登录生效。Q串出来的画面发白、过曝主机开了 HDR 而客户端没开流就按 SDR 解码了。在 Moonlight 设置里打开 HDR 选项同时确认主机侧 HDR 真的处于激活状态必要时接一块 HDR 显示器或 EDID 模拟器Linux 上还要求 KMS 捕获后端NvFBC / X11 捕获不支持 HDR。拿不准就看 Troubleshooting 页每条 warning/error 都能展开看细节进阶入口想深入时看这里docs/getting_started.md官方安装指南覆盖各平台渠道、快捷键、SSH 远程拉起装完先读它docs/configuration.md全部配置项port、locale、编码器、音频设备……逐项说明Web UI 不够用时查参数docs/troubleshooting.md排障手册丢包、MTU 等网络问题和 Linux 捕获专项坑都在这src/platform/各平台捕获与编码实现源码KMS、VAAPI、WGC 等理解内部行为的主入口tests/单元测试与集成测试观察内部行为、验证改动的好窗口【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 3 步把游戏 PC 变成 Moonlight 串流主机：Sunshine 完整上手指南
3 步把游戏 PC 变成 Moonlight 串流主机Sunshine 完整上手指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想在客厅电视、平板甚至手机上玩 PC 游戏游戏主机连得上PC 游戏却玩不了Sunshine 就是为此而生一个跑在游戏 PC 上的自托管游戏串流主机负责抓取画面、压缩并推送出去接收端的 Moonlight 客户端装在电视、平板、手机上负责显示画面、回传输入。开源免费、无订阅硬件门槛只要求主机 PC 能跑游戏。一句话定位Sunshine 跑在 PC 上的自托管游戏串流主机 浏览器管理面板。要点速览主机平台Windows、Linux、macOS实验性、FreeBSD客户端任意设备上的 Moonlight 客户端编码NVIDIA / AMD / Intel / Apple 硬件编码CPU 软编兜底管理面板内置 Web UI默认端口47990成本开源免费无订阅费快速上手从安装到第一次串流只要 3 步从零到看到第一帧串流画面10 分钟以内。第 1 步安装 Sunshine。按平台任选一条通道winget install LizardByte.Sunshine flatpak install --system flathub dev.lizardbyte.app.Sunshine brew install sunshineFlatpak 装完还要再跑一次flatpak run --commandadditional-install.sh dev.lizardbyte.app.Sunshine否则虚拟输入权限不生效。验证信号终端执行sunshine --help能打出版本信息。第 2 步启动并打开管理面板。Linux 上直接开用户级服务systemctl --user --now enable app-dev.lizardbyte.app.Sunshine没装成服务就直接在终端敲sunshine。启动后浏览器打开默认地址https://localhost:47990。浏览器提示不安全只是自签名证书忽略即可。⚠️ 首次启动会让你创建用户名和密码——当场抄下来忘了只能靠命令行重置凭据。第 3 步配对 Moonlight 客户端。在 Moonlight 里添加这台主机客户端会显示一个 PIN把它填进 Sunshine 顶部导航的 PIN 页面给设备起个名字配对即完成。随后选 Desktop 启动——电视或平板上出现主机桌面的那一刻就代表全部配好了。核心能力先看懂一条数据流再谈它能干什么先看主线流程能力点就串起来了。Sunshine 先用捕获后端Linux 上是 KMS、X11、Wayland portalWindows 上是 WGC把画面抓下来再交给硬件编码器在 GPU 上压缩画面几乎不占 CPU实时压成视频流发到网络上Moonlight 客户端解码播放。输入则反向走——你在客户端侧的键鼠、手柄会在主机上被虚拟成真实设备游戏里看到的就是插在本机上的那个控制器。配置全在浏览器里不碰配置文件能干什么选编码器、分辨率、码率、音频设备管理应用列表、查日志全在浏览器完成。 怎么用登录 Web UI 后侧边栏按 AudioVideo / Applications / Advanced / Network 分标签顶部有搜索框直接输参数名就能跳转不用一页页翻。 坑在哪界面语言在 General 标签里改locale改完刷新页面才生效。给每个游戏一个一键启动入口能干什么每个游戏/应用建一个条目在 Moonlight 里点它就直接启动并开串流。 怎么用Applications 标签点 Add New填名称、可执行文件路径、工作目录还可以加prep-cmd启动前执行的命令。默认条目定义在 src_assets/linux/assets/apps.json桌面、Steam 大屏两个。坑在哪三条固定规则——点新应用会先结束当前正在串流的那个任何前置命令执行失败就放弃启动被拉起的应用退出串流也随之结束。怎么挑编码器能干什么用 GPU 压画面把延迟和 CPU 占用都压下来。 怎么用AudioVideo 标签里选与你显卡匹配的 APISunshine 会自动探测默认选择一般就是对的。支持矩阵摘自 README编码 API适用显卡LinuxWindowsmacOSNVENCNVIDIA支持支持—QuickSyncIntel—支持—AMFAMD—支持—Vulkan VideoAMD / Intel支持部分——VAAPIAMD / Intel支持——VideoToolboxApple——支持软编CPU任意支持支持支持坑在哪没有独显时1080p 软编会让 CPU 占用明显上升能硬编就别硬扛Linux 上 NvFBC 捕获只能搭配 NVENC捕获方式和编码器要成对挑README 里有捕获→编码兼容性对照表。客户端的手柄变成主机的手柄能干什么手柄插在客户端设备上主机自动虚拟出同款控制器传给游戏。 怎么用插上手柄 → 配对 → 启动游戏即可。Linux 依赖 uinputWindows 需另装虚拟 HID 驱动装完建议重启。 坑在哪macOS 主机暂不支持手柄驱动激活状态在 Web UI 的 Troubleshooting 页和系统托盘里都能查。实战用法两个最值得试的典型玩法玩法一把整台 PC 当远程桌面目标在平板或手机上操作整台 PC远程办公或当第二台显示器准备无Desktop 条目默认自带操作Moonlight 里选 Desktop 启动串流它不拉起任何程序直接串桌面验证结果客户端看到主机桌面按CtrlAltShiftN隐藏鼠标指针F1/F12 变体快捷键可以切换串流显示器玩法二用客户端手柄打游戏目标DualSense 插在手机上游戏里直接用真手柄玩准备Linux 把用户加入input组后重新登录Windows 装好虚拟 HID 驱动并重启操作插入手柄配对启动目标游戏验证结果主机生成了对应的虚拟手柄Troubleshooting 页可查游戏识别为该型号控制器按键、震动都正常常见问题5 个高频问答你踩到的坑大概率在这五个问题里。Q后台密码忘了怎么进去凭据只存在本机。先停掉 Sunshine然后执行sunshine --creds 新用户名 新密码再用新凭据登录。Q浏览器打开 47990 端口没反应多半是服务没跑起来或防火墙拦了。先看服务状态systemctl --user status app-dev.lizardbyte.app.Sunshine没启动就把它拉起来在跑着就放行防火墙的 47990 端口。Q画面频繁卡顿、丢包是不是编码器选错了八成不是编码器是网络Sunshine 的发送节奏是每 16ms 突出一帧数据对应 60fps路径上任何一段比主机慢缓冲就会被冲爆。先用 iPerf3 测稳定性主机iperf3 -s客户端iperf3 -c {主机IP} -t 60 -u -R -b 50M丢包低于 5%、抖动低于 1ms 才算合格确属速率差导致的话把主机网卡降速或升级到 0.23.1 之后的版本突发发送逻辑已优化。QLinux 上连上之后键鼠没反应运行 Sunshine 的用户没有 uinput 权限sudo usermod -aG input $USER重新登录生效。Q串出来的画面发白、过曝主机开了 HDR 而客户端没开流就按 SDR 解码了。在 Moonlight 设置里打开 HDR 选项同时确认主机侧 HDR 真的处于激活状态必要时接一块 HDR 显示器或 EDID 模拟器Linux 上还要求 KMS 捕获后端NvFBC / X11 捕获不支持 HDR。拿不准就看 Troubleshooting 页每条 warning/error 都能展开看细节进阶入口想深入时看这里docs/getting_started.md官方安装指南覆盖各平台渠道、快捷键、SSH 远程拉起装完先读它docs/configuration.md全部配置项port、locale、编码器、音频设备……逐项说明Web UI 不够用时查参数docs/troubleshooting.md排障手册丢包、MTU 等网络问题和 Linux 捕获专项坑都在这src/platform/各平台捕获与编码实现源码KMS、VAAPI、WGC 等理解内部行为的主入口tests/单元测试与集成测试观察内部行为、验证改动的好窗口【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考