AlkaidLab/foundation-sunshine

Sunshine fork: an enhanced sunshine, a self-hosted game streaming host for Moonlight with HDR10/HDR Vivid, virtual displays, advanced audio, optimized encoders, and a modern control panel.

C++

7,201

2,840 commits

updated Oct 15, 2026

See the code

README

Foundation Sunshine

Foundation Sunshine 是基于 Sunshine 的免费开源远程控制软件,主要面向 Windows 特别优化,配合 Moonlight VPlus 与 Enhanced 客户端远程使用电脑桌面、应用和游戏。

从动态 HDR、屏幕校准到低延迟捕获与硬件编码,Foundation 让远程画面和操作更贴近本地体验。环绕声与麦克风透传、DualSense 原生反馈、剪贴板和文件共享也能随连接使用;独立桌面 GUI 提供更优质的用户体验,将这些原本繁琐的设置、设备组件和游戏库集中管理。

下载被控端(Sunshine) · 下载控制端(Moonlight) · 安装与首次连接

项目亮点 · 功能与设置 · FAQ · 开发文档 · 贡献指南

项目亮点

  • 画面与显示: 场景自适应 HDR、HDR10+ / HDR Vivid 与 Dolby Vision 扩展,按屏幕亮度校准;ZakoDisplay 无需物理显示器即可提供 HDR 虚拟屏与多种屏幕组合。
  • 捕获与编码: 支持 NVIDIA NVENC、AMD AMF、Intel Quick Sync 等编码器,并针对捕获和编码链路优化延迟与流畅度;Zako Direct 直接取得虚拟屏画面,减少捕获环节的拷贝。
  • 音频与麦克风透传: 最高 7.1.4 环绕声、PCM / AC3 / E-AC3,支持麦克风回传、静音保活与音频丢包恢复。
  • 独立桌面控制面板: 集中管理游戏库、显示器、设备组件、运行状态和更新,提供日志诊断与可选 AI 辅助。
  • 输入与原生手柄: 精确式触控板、手写笔和客户端光标;在设备中心安装 DualSense 组件后,把支持的游戏通过 USB 接入 PC 时的自适应扳机、触觉等反馈带到远程连接中。
  • 桌面协作与连接管理: 双向剪贴板、文件夹共享、USB 转发、连接中调画质、自适应码率,以及远端命令和会话控制。

具体支持条件和启用步骤见功能与设置,开发者们还藏了很多小巧思等着你们来发现~

下载

也可以前往官网或国内官网,按设备查找下载。

需要在两台设备上分别安装:被控端(Sunshine)装在要被控制的电脑,控制端(Moonlight)装在你用来操作它的设备。

被控端(Sunshine)

装在要被控制的 Windows 电脑上。

如果 Foundation Sunshine 对你有帮助,欢迎 ⭐ 点个 Star 支持项目。

前往 最新正式发行版,展开 Assets,下载文件名以 WindowsInstaller.exe 结尾的安装包。

  • 首次使用: 选择安装包,按向导完成安装。
  • 需要便携部署(不推荐): 选择 Portable-x64.zip;文件名前面可能带有版本号,请确认你确实需要如多开等特殊需求时使用。
  • 想体验新功能: 查看 预发布版本,先阅读对应版本的已知问题。

开始前准备好 Windows 10 22H2 或更新版本,以及支持硬件视频编码的 AMD、Intel 或 NVIDIA 显卡。可用的画质、分辨率与帧率取决于显卡、驱动、网络和客户端。

控制端(Moonlight)

装在你用来操作电脑的手机、平板或另一台电脑上。

推荐优先使用下列客户端。 Foundation 的 HDR、显示器管理、音频与输入增强需要控制端配合;其他客户端可能缺少相关功能,或因兼容性问题出现显示异常、连接错误。

这些客户端由基地成员用心打造,提供最优质的 Foundation Sunshine 体验,欢迎通过 ⭐ Star 支持你使用的项目。

合作客户端

快速开始

1 安装被控端(Sunshine)

  1. 在要被控制的 Windows 电脑上打开下载页。
  2. 找到 Assets,下载以 WindowsInstaller.exe 结尾的文件,双击安装。安装器提供的组件可按需要勾选;准备使用虚拟屏时,保留 Zako Display Driver 选项。
  3. 安装完成后打开 Foundation Sunshine 桌面控制面板,按新手向导选择语言、显卡和显示器。有物理屏幕时可先选择它;没有物理显示器时,先检查安装时是否已安装虚拟显示器驱动;需要补装时打开 GUI 的基地显示器设置,再选择基地显示器。
  4. (可选,不推荐)若你更喜欢 WebUI 体验,在这台电脑的浏览器打开 https://localhost:47990。如果浏览器提示证书不受信任,确认地址是这台电脑的 https://localhost:47990 后,通过浏览器“高级”或“更多选项”中的继续访问选项打开。
  5. 首次使用按页面提示创建用户名和密码,未来可以使用它们登录 WebUI 管理界面。

2 安装控制端(Moonlight)

在手机、平板或另一台电脑上,按上面的控制端(Moonlight)列表下载并安装客户端。这台设备用来观看画面、输入和操作。

  • Windows: 在客户端发行页选择 Windows 安装程序;如果选择便携 ZIP(不推荐,请确认你确实需要如多开等特殊需求时使用),选择并解压再打开其中的程序,文件名前面可能带有版本号。
  • macOS: 下载所选客户端的 DMG,打开后将应用拖到“应用程序”。V+ 预编译包仅适用于 Apple Silicon;Enhanced 可选通用包(universal),若你理解电脑所使用的架构,也可挑选对应版本。遇到首次打开拦截时,按对应项目的安装说明处理。
  • Linux: 下载符合处理器与系统要求的 AppImage,授予可执行权限后运行。
  • Android: 下载 APK,在下载完成提示或文件管理器中打开;按系统提示允许这次安装。
  • iOS / iPadOS、鸿蒙: 打开对应商店链接并安装。

首次启动客户端时,如果系统询问本地网络权限,请允许访问。两台设备先连接同一局域网,被控电脑建议使用网线。

3 添加电脑并配对

  1. 打开客户端,等待 Windows 电脑出现在列表里,然后点击它。
  2. 如果没有出现,手动添加 IP:在 Windows 电脑按 Win + R,输入 cmd 并回车,再输入 ipconfig。找到当前使用的以太网或 WLAN 适配器下的 IPv4 地址,填到客户端的“添加电脑/添加主机”入口。
  3. 客户端显示 PIN 后,回到 Windows 电脑的 Sunshine 管理界面,打开 PIN 码 页面。
  4. 输入客户端显示的 PIN,点击 发送。看到配对成功提示后回到客户端。

这里填的是 Windows 电脑的局域网地址,例如 192.168.1.100,不是 localhost,也不是浏览器管理页面的网址。示例 IP 需要替换成你电脑的实际地址。

4 设置第一次连接的画质

先在 控制端(Moonlight) 打开设置,找到视频或画质选项,再依次设置:

选项第一次怎么选含义
分辨率1920×1080(1080p)传送画面的大小;越高越清晰,也更费网络与设备性能
帧率60 FPS每秒画面更新次数;120 FPS 需要屏幕和两端处理能力配合
码率20 Mbps;网络不稳先降到 10 Mbps传输数据预算,影响压缩画质与网络负载
视频编码自动;兼容性问题先选 H.264画面的压缩方式;HEVC / AV1 需要相应解码能力
HDR先关闭默认 SDR,确认正常后再配置 HDR
音频立体声 / Opus先确认声音,再启用多声道或其他格式

设置名称因客户端不同略有区别。分辨率、帧率、码率在控制端调整;Sunshine 被控端首次保持自动编码与默认捕获即可。先不要同时开启高分辨率、高帧率和所有画质增强。

5 连接桌面

  1. 在客户端打开已配对的电脑,选择 Desktop。
  2. 出现 Windows 桌面后,试着移动鼠标、打开一个窗口,再播放一段音频,确认画面、操作和声音都正常。
  3. 如果列表中没有 Desktop,在 Sunshine 的 应用 页面使用 还原内置应用,然后刷新客户端的应用列表。这个操作会恢复默认内置项目;如已定制这些项目,请先保留配置。

先用默认画质完成这一步,再调整 HDR、分辨率或虚拟显示器。

6 添加游戏或应用(可选)

批量扫描: 在 Windows 上打开 Foundation Sunshine 桌面控制面板,进入 应用,点击 扫描游戏平台库 (Steam/Epic/GOG)。检查扫描结果,选择 直接添加 或 全部添加,然后刷新客户端列表。本地目录也可通过扫描窗口添加;浏览器管理页不能调用桌面端的本地扫描功能。

手动添加: 在 应用 → 添加新应用 中填写应用名称和 主程序,保存后刷新客户端列表。主程序可以填写程序路径;路径包含空格时,使用英文双引号,例如 "D:\My Games\Game\game.exe"。

客户端里也可以直接启动内置的 Steam Big Picture,再从 Steam 中选游戏。

功能与设置

视频 HDR 与色彩 · 基地虚拟显示器 · 画面捕获与编码 · 手柄与 DualSense · 音频与麦克风透传 · 独立桌面控制面板

帮助与参与

感谢 LizardByte/Sunshine、Moonlight、ZakoDisplay,以及开发、测试和翻译贡献者。项目遵循 GPL-3.0 许可证。

觉得好用就点个 Star。才不是为了这个继续修 bug 的呢。

基地开发团队成员

其他贡献者

感谢所有参与 Foundation 和 Sunshine 上游开发、测试及维护的贡献者。

ReenigneArcher cgutman dependabot[bot] loki-47-6F-64 ns6089 LizardByte-bot TheElixZammuto psyke83 istori1 Nonary github-actions[bot] PapyKahan ABeltramo FrogTheFrog HomerSp kodemeister brad-richardson Doomsdayrs gschintgen Logical-sh Hazer diadatp KuleRucket chewi guanzhangrtk nowrep sitiom luk1337 JacekJagosz jorys-paulin tez011 KiralyCraft pgrunzjr thatsysadmin WisdomCode safijari korverdev tgurr exetico BigBrainAFK Arbitrate3280 arnerak detiam dkgkdfg65 lns103 okkiv w0utert MiroKaku TimmyOVO ReeceHumphreys mcourteaux Doridian brownj85 felipejfc CLF184 briankendall abusse perroboc andygrundman CrazyStevenz TrueZhuangJia xanderfrangos zackelia zanechua KawaiiZapic Chang-Jin-Lee bushshrub RickAndTired rafaelsgirao radugrecu97 PVermeer devusb LXY1226 sethicis SnowSwordScholar Max-Might zoeyjodon skryvel sirius128 qingm36 manteuffel723 jensaymoo jcj83429 iMakeSoftware exalented everything411 brycerocky aseligmann ahmadalli aetheryx notentered 360sym d-s-x Xythus Crashdummyy cgarst Copilot CodyManess Clutchnp cfalas cfajardo cazzoo caveat-makes-software cathyjf gamozolabs BeeLeDev angelnu amarshall Aaron-Rumpler kelvie KarlVogel justindhillon Tea23 jhgarner insanemal Calinou hgaiser Han-cy830 hadicharara c3m3gyanesh himekifee theofficialgman ekchang e-dong Gara-Dorta ehabajmal

查看贡献记录

amf
cloudgaming
dolby-vision
game-streaming
hdr
moonlight
moonlight-streaming
rdp
remote
remote-desktop
remote-desktop-protocol
self-hosted
stream
streaming
sunshine
virtual-display
vivid

AlkaidLab/foundation-sunshine

Sunshine fork: an enhanced sunshine, a self-hosted game streaming host for Moonlight with HDR10/HDR Vivid, virtual displays, advanced audio, optimized encoders, and a modern control panel.

C++

7,201

2,840 commits

updated Oct 15, 2026

See the code

README

Foundation Sunshine

Foundation Sunshine 是基于 Sunshine 的免费开源远程控制软件,主要面向 Windows 特别优化,配合 Moonlight VPlus 与 Enhanced 客户端远程使用电脑桌面、应用和游戏。

从动态 HDR、屏幕校准到低延迟捕获与硬件编码,Foundation 让远程画面和操作更贴近本地体验。环绕声与麦克风透传、DualSense 原生反馈、剪贴板和文件共享也能随连接使用;独立桌面 GUI 提供更优质的用户体验,将这些原本繁琐的设置、设备组件和游戏库集中管理。

下载被控端(Sunshine) · 下载控制端(Moonlight) · 安装与首次连接

项目亮点 · 功能与设置 · FAQ · 开发文档 · 贡献指南

项目亮点

  • 画面与显示: 场景自适应 HDR、HDR10+ / HDR Vivid 与 Dolby Vision 扩展,按屏幕亮度校准;ZakoDisplay 无需物理显示器即可提供 HDR 虚拟屏与多种屏幕组合。
  • 捕获与编码: 支持 NVIDIA NVENC、AMD AMF、Intel Quick Sync 等编码器,并针对捕获和编码链路优化延迟与流畅度;Zako Direct 直接取得虚拟屏画面,减少捕获环节的拷贝。
  • 音频与麦克风透传: 最高 7.1.4 环绕声、PCM / AC3 / E-AC3,支持麦克风回传、静音保活与音频丢包恢复。
  • 独立桌面控制面板: 集中管理游戏库、显示器、设备组件、运行状态和更新,提供日志诊断与可选 AI 辅助。
  • 输入与原生手柄: 精确式触控板、手写笔和客户端光标;在设备中心安装 DualSense 组件后,把支持的游戏通过 USB 接入 PC 时的自适应扳机、触觉等反馈带到远程连接中。
  • 桌面协作与连接管理: 双向剪贴板、文件夹共享、USB 转发、连接中调画质、自适应码率,以及远端命令和会话控制。

具体支持条件和启用步骤见功能与设置,开发者们还藏了很多小巧思等着你们来发现~

下载

也可以前往官网或国内官网,按设备查找下载。

需要在两台设备上分别安装:被控端(Sunshine)装在要被控制的电脑,控制端(Moonlight)装在你用来操作它的设备。

被控端(Sunshine)

装在要被控制的 Windows 电脑上。

如果 Foundation Sunshine 对你有帮助,欢迎 ⭐ 点个 Star 支持项目。

前往 最新正式发行版,展开 Assets,下载文件名以 WindowsInstaller.exe 结尾的安装包。

  • 首次使用: 选择安装包,按向导完成安装。
  • 需要便携部署(不推荐): 选择 Portable-x64.zip;文件名前面可能带有版本号,请确认你确实需要如多开等特殊需求时使用。
  • 想体验新功能: 查看 预发布版本,先阅读对应版本的已知问题。

开始前准备好 Windows 10 22H2 或更新版本,以及支持硬件视频编码的 AMD、Intel 或 NVIDIA 显卡。可用的画质、分辨率与帧率取决于显卡、驱动、网络和客户端。

控制端(Moonlight)

装在你用来操作电脑的手机、平板或另一台电脑上。

推荐优先使用下列客户端。 Foundation 的 HDR、显示器管理、音频与输入增强需要控制端配合;其他客户端可能缺少相关功能,或因兼容性问题出现显示异常、连接错误。

这些客户端由基地成员用心打造,提供最优质的 Foundation Sunshine 体验,欢迎通过 ⭐ Star 支持你使用的项目。

合作客户端

快速开始

1 安装被控端(Sunshine)

  1. 在要被控制的 Windows 电脑上打开下载页。
  2. 找到 Assets,下载以 WindowsInstaller.exe 结尾的文件,双击安装。安装器提供的组件可按需要勾选;准备使用虚拟屏时,保留 Zako Display Driver 选项。
  3. 安装完成后打开 Foundation Sunshine 桌面控制面板,按新手向导选择语言、显卡和显示器。有物理屏幕时可先选择它;没有物理显示器时,先检查安装时是否已安装虚拟显示器驱动;需要补装时打开 GUI 的基地显示器设置,再选择基地显示器。
  4. (可选,不推荐)若你更喜欢 WebUI 体验,在这台电脑的浏览器打开 https://localhost:47990。如果浏览器提示证书不受信任,确认地址是这台电脑的 https://localhost:47990 后,通过浏览器“高级”或“更多选项”中的继续访问选项打开。
  5. 首次使用按页面提示创建用户名和密码,未来可以使用它们登录 WebUI 管理界面。

2 安装控制端(Moonlight)

在手机、平板或另一台电脑上,按上面的控制端(Moonlight)列表下载并安装客户端。这台设备用来观看画面、输入和操作。

  • Windows: 在客户端发行页选择 Windows 安装程序;如果选择便携 ZIP(不推荐,请确认你确实需要如多开等特殊需求时使用),选择并解压再打开其中的程序,文件名前面可能带有版本号。
  • macOS: 下载所选客户端的 DMG,打开后将应用拖到“应用程序”。V+ 预编译包仅适用于 Apple Silicon;Enhanced 可选通用包(universal),若你理解电脑所使用的架构,也可挑选对应版本。遇到首次打开拦截时,按对应项目的安装说明处理。
  • Linux: 下载符合处理器与系统要求的 AppImage,授予可执行权限后运行。
  • Android: 下载 APK,在下载完成提示或文件管理器中打开;按系统提示允许这次安装。
  • iOS / iPadOS、鸿蒙: 打开对应商店链接并安装。

首次启动客户端时,如果系统询问本地网络权限,请允许访问。两台设备先连接同一局域网,被控电脑建议使用网线。

3 添加电脑并配对

  1. 打开客户端,等待 Windows 电脑出现在列表里,然后点击它。
  2. 如果没有出现,手动添加 IP:在 Windows 电脑按 Win + R,输入 cmd 并回车,再输入 ipconfig。找到当前使用的以太网或 WLAN 适配器下的 IPv4 地址,填到客户端的“添加电脑/添加主机”入口。
  3. 客户端显示 PIN 后,回到 Windows 电脑的 Sunshine 管理界面,打开 PIN 码 页面。
  4. 输入客户端显示的 PIN,点击 发送。看到配对成功提示后回到客户端。

这里填的是 Windows 电脑的局域网地址,例如 192.168.1.100,不是 localhost,也不是浏览器管理页面的网址。示例 IP 需要替换成你电脑的实际地址。

4 设置第一次连接的画质

先在 控制端(Moonlight) 打开设置,找到视频或画质选项,再依次设置:

选项第一次怎么选含义
分辨率1920×1080(1080p)传送画面的大小;越高越清晰,也更费网络与设备性能
帧率60 FPS每秒画面更新次数;120 FPS 需要屏幕和两端处理能力配合
码率20 Mbps;网络不稳先降到 10 Mbps传输数据预算,影响压缩画质与网络负载
视频编码自动;兼容性问题先选 H.264画面的压缩方式;HEVC / AV1 需要相应解码能力
HDR先关闭默认 SDR,确认正常后再配置 HDR
音频立体声 / Opus先确认声音,再启用多声道或其他格式

设置名称因客户端不同略有区别。分辨率、帧率、码率在控制端调整;Sunshine 被控端首次保持自动编码与默认捕获即可。先不要同时开启高分辨率、高帧率和所有画质增强。

5 连接桌面

  1. 在客户端打开已配对的电脑,选择 Desktop。
  2. 出现 Windows 桌面后,试着移动鼠标、打开一个窗口,再播放一段音频,确认画面、操作和声音都正常。
  3. 如果列表中没有 Desktop,在 Sunshine 的 应用 页面使用 还原内置应用,然后刷新客户端的应用列表。这个操作会恢复默认内置项目;如已定制这些项目,请先保留配置。

先用默认画质完成这一步,再调整 HDR、分辨率或虚拟显示器。

6 添加游戏或应用(可选)

批量扫描: 在 Windows 上打开 Foundation Sunshine 桌面控制面板,进入 应用,点击 扫描游戏平台库 (Steam/Epic/GOG)。检查扫描结果,选择 直接添加 或 全部添加,然后刷新客户端列表。本地目录也可通过扫描窗口添加;浏览器管理页不能调用桌面端的本地扫描功能。

手动添加: 在 应用 → 添加新应用 中填写应用名称和 主程序,保存后刷新客户端列表。主程序可以填写程序路径;路径包含空格时,使用英文双引号,例如 "D:\My Games\Game\game.exe"。

客户端里也可以直接启动内置的 Steam Big Picture,再从 Steam 中选游戏。

功能与设置

视频 HDR 与色彩 · 基地虚拟显示器 · 画面捕获与编码 · 手柄与 DualSense · 音频与麦克风透传 · 独立桌面控制面板

帮助与参与

感谢 LizardByte/Sunshine、Moonlight、ZakoDisplay,以及开发、测试和翻译贡献者。项目遵循 GPL-3.0 许可证。

觉得好用就点个 Star。才不是为了这个继续修 bug 的呢。

基地开发团队成员

其他贡献者

感谢所有参与 Foundation 和 Sunshine 上游开发、测试及维护的贡献者。

ReenigneArcher cgutman dependabot[bot] loki-47-6F-64 ns6089 LizardByte-bot TheElixZammuto psyke83 istori1 Nonary github-actions[bot] PapyKahan ABeltramo FrogTheFrog HomerSp kodemeister brad-richardson Doomsdayrs gschintgen Logical-sh Hazer diadatp KuleRucket chewi guanzhangrtk nowrep sitiom luk1337 JacekJagosz jorys-paulin tez011 KiralyCraft pgrunzjr thatsysadmin WisdomCode safijari korverdev tgurr exetico BigBrainAFK Arbitrate3280 arnerak detiam dkgkdfg65 lns103 okkiv w0utert MiroKaku TimmyOVO ReeceHumphreys mcourteaux Doridian brownj85 felipejfc CLF184 briankendall abusse perroboc andygrundman CrazyStevenz TrueZhuangJia xanderfrangos zackelia zanechua KawaiiZapic Chang-Jin-Lee bushshrub RickAndTired rafaelsgirao radugrecu97 PVermeer devusb LXY1226 sethicis SnowSwordScholar Max-Might zoeyjodon skryvel sirius128 qingm36 manteuffel723 jensaymoo jcj83429 iMakeSoftware exalented everything411 brycerocky aseligmann ahmadalli aetheryx notentered 360sym d-s-x Xythus Crashdummyy cgarst Copilot CodyManess Clutchnp cfalas cfajardo cazzoo caveat-makes-software cathyjf gamozolabs BeeLeDev angelnu amarshall Aaron-Rumpler kelvie KarlVogel justindhillon Tea23 jhgarner insanemal Calinou hgaiser Han-cy830 hadicharara c3m3gyanesh himekifee theofficialgman ekchang e-dong Gara-Dorta ehabajmal

查看贡献记录

amf
cloudgaming
dolby-vision
game-streaming
hdr
moonlight
moonlight-streaming
rdp
remote
remote-desktop
remote-desktop-protocol
self-hosted
stream
streaming
sunshine
virtual-display
vivid

Significant stargazers

rain capsule

223 followers · starred Jun 2026

Zae Chao

45 followers · starred May 2025

flashmouse

23 followers · starred Jan 2026

WangFeng Huang

24 followers · starred Aug 2024