AlkaidLab/foundation-sunshine: +86 stars this week

Foundation Sunshine

简体中文 · English · Deutsch · Français · 日本語

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 支持你使用的项目。

Windows / Linux： Moonlight V+ for PC
macOS： Moonlight macOS Enhanced · Moonlight V+ for PC
Android / Android TV： Moonlight V+
鸿蒙： Moonlight V+

合作客户端

VoidLink · iOS / iPadOS： 项目介绍 · 中国大陆、韩国、越南 App Store · 其他地区 App Store（商店分发收费）
VoidLink TestFlight Beta · 支持 Apple TV： 加入 TestFlight 测试
王冠版 · Android： 下载 · 项目介绍
包子版 · 鸿蒙： 项目与下载

快速开始

1 安装被控端（Sunshine）

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

2 安装控制端（Moonlight）

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

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

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

3 添加电脑并配对

打开客户端，等待 Windows 电脑出现在列表里，然后点击它。
如果没有出现，手动添加 IP：在 Windows 电脑按 Win + R，输入 cmd 并回车，再输入 ipconfig。找到当前使用的以太网或 WLAN 适配器下的 IPv4 地址，填到客户端的“添加电脑／添加主机”入口。
客户端显示 PIN 后，回到 Windows 电脑的 Sunshine 管理界面，打开 PIN 码 页面。
输入客户端显示的 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 连接桌面

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

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

6 添加游戏或应用（可选）

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

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

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