[](https://github.com/AlkaidLab/foundation-sunshine/actions/workflows/main.yml) [](https://github.com/AlkaidLab/foundation-sunshine/releases) [](https://github.com/AlkaidLab/foundation-sunshine/releases) [](https://github.com/AlkaidLab/foundation-sunshine) [](https://github.com/AlkaidLab/foundation-sunshine/blob/master/LICENSE)
简体中文 · [English](docs/readme/README.en.md) · [Deutsch](docs/readme/README.de.md) · [Français](docs/readme/README.fr.md) · [日本語](docs/readme/README.ja.md)
[官网](https://www.alkaidlab.com/) · [国内官网](https://www.alkaidlab.cn/) · [QQ 交流群](https://qm.qq.com/cgi-bin/qm/qr?k=5qnkzSaLIrIaU4FvumftZH_6Hg7fUuLD&jump_from=webapi) · [问题反馈](https://github.com/AlkaidLab/foundation-sunshine/issues)
Foundation Sunshine 是基于 [Sunshine](https://github.com/LizardByte/Sunshine) 的免费开源远程控制软件，主要面向 Windows 特别优化，配合 Moonlight VPlus 与 Enhanced 客户端远程使用电脑桌面、应用和游戏。
从动态 HDR、屏幕校准到低延迟捕获与硬件编码，Foundation 让远程画面和操作更贴近本地体验。环绕声与麦克风透传、DualSense 原生反馈、剪贴板和文件共享也能随连接使用；独立桌面 GUI 提供更优质的用户体验，将这些原本繁琐的设置、设备组件和游戏库集中管理。
**[下载被控端（Sunshine）](https://github.com/AlkaidLab/foundation-sunshine/releases/latest)** · **[下载控制端（Moonlight）](#控制端moonlight)** · **[安装与首次连接](#快速开始)**
[项目亮点](#项目亮点) · [功能与设置](docs/zh-CN/features.md) · [FAQ](docs/zh-CN/faq.md) · [开发文档](docs/zh-CN/development.md) · [贡献指南](docs/contributing.md)
## 项目亮点
- **画面与显示：** 场景自适应 HDR、HDR10+ / HDR Vivid 与 Dolby Vision 扩展，按屏幕亮度校准；[ZakoDisplay](https://github.com/qiin2333/zako-vdd) 无需物理显示器即可提供 HDR 虚拟屏与多种屏幕组合。
- **捕获与编码：** 支持 NVIDIA NVENC、AMD AMF、Intel Quick Sync 等编码器，并针对捕获和编码链路优化延迟与流畅度；Zako Direct 直接取得虚拟屏画面，减少捕获环节的拷贝。
- **音频与麦克风透传：** 最高 7.1.4 环绕声、PCM / AC3 / E-AC3，支持麦克风回传、静音保活与音频丢包恢复。
- **独立桌面控制面板：** 集中管理游戏库、显示器、设备组件、运行状态和更新，提供日志诊断与可选 AI 辅助。
- **输入与原生手柄：** 精确式触控板、手写笔和客户端光标；在设备中心安装 DualSense 组件后，把支持的游戏通过 USB 接入 PC 时的自适应扳机、触觉等反馈带到远程连接中。
- **桌面协作与连接管理：** 双向剪贴板、文件夹共享、USB 转发、连接中调画质、自适应码率，以及远端命令和会话控制。
具体支持条件和启用步骤见[功能与设置](docs/zh-CN/features.md)，开发者们还藏了很多小巧思等着你们来发现~
## 下载
也可以前往[官网](https://www.alkaidlab.com/)或[国内官网](https://www.alkaidlab.cn/)，按设备查找下载。
需要在两台设备上分别安装：**被控端（Sunshine）装在要被控制的电脑，控制端（Moonlight）装在你用来操作它的设备。**
### 被控端（Sunshine）
**装在要被控制的 Windows 电脑上。**
如果 Foundation Sunshine 对你有帮助，欢迎 [⭐ 点个 Star](https://github.com/AlkaidLab/foundation-sunshine) 支持项目。
前往 [最新正式发行版](https://github.com/AlkaidLab/foundation-sunshine/releases/latest)，展开 **Assets**，下载文件名以 `WindowsInstaller.exe` 结尾的安装包。
- **首次使用：** 选择安装包，按向导完成安装。
- **需要便携部署（不推荐）：** 选择 `Portable-x64.zip`；文件名前面可能带有版本号，请确认你确实需要如多开等特殊需求时使用。
- **想体验新功能：** 查看 [预发布版本](https://github.com/AlkaidLab/foundation-sunshine/releases)，先阅读对应版本的已知问题。
开始前准备好 Windows 10 22H2 或更新版本，以及支持硬件视频编码的 AMD、Intel 或 NVIDIA 显卡。可用的画质、分辨率与帧率取决于显卡、驱动、网络和客户端。
### 控制端（Moonlight）
**装在你用来操作电脑的手机、平板或另一台电脑上。**
**推荐优先使用下列客户端。** Foundation 的 HDR、显示器管理、音频与输入增强需要控制端配合；其他客户端可能缺少相关功能，或因兼容性问题出现显示异常、连接错误。
这些客户端由基地成员用心打造，提供最优质的 Foundation Sunshine 体验，欢迎通过 **⭐ Star** 支持你使用的项目。
- **Windows / Linux：** [Moonlight V+ for PC](https://github.com/qiin2333/moonlight-qt/releases)
- **macOS：** [Moonlight macOS Enhanced](https://github.com/skyhua0224/moonlight-macos-enhanced/releases) · [Moonlight V+ for PC](https://github.com/qiin2333/moonlight-qt/releases)
- **Android / Android TV：** [Moonlight V+](https://github.com/qiin2333/moonlight-vplus/releases/latest)
- **鸿蒙：** [Moonlight V+](https://appgallery.huawei.com/app/detail?id=com.alkaidlab.sdream)
#### 合作客户端
- **VoidLink · iOS / iPadOS：** [项目介绍](https://github.com/The-Fried-Fish/VoidLink-previously-moonlight-zwm#readme) · [中国大陆、韩国、越南 App Store](https://apps.apple.com/app/voidlink/id6747717070) · [其他地区 App Store](https://apps.apple.com/app/voidlink-extreme/id6755103808)（商店分发收费）
- **VoidLink TestFlight Beta · 支持 Apple TV：** [加入 TestFlight 测试](https://testflight.apple.com/join/k7gs61mZ)
- **王冠版 · Android：** [下载](https://github.com/WACrown/moonlight-android/releases) · [项目介绍](https://github.com/WACrown/moonlight-android#readme)
- **包子版 · 鸿蒙：** [项目与下载](https://gitee.com/smdsbz/moonlight-ohos)
## 快速开始
### 1 安装被控端（Sunshine）
1. 在要被控制的 Windows 电脑上打开[下载页](https://github.com/AlkaidLab/foundation-sunshine/releases/latest)。
2. 找到 **Assets**，下载以 `WindowsInstaller.exe` 结尾的文件，双击安装。安装器提供的组件可按需要勾选；准备使用虚拟屏时，保留 **Zako Display Driver** 选项。
3. 安装完成后打开 Foundation Sunshine 桌面控制面板，按新手向导选择语言、显卡和显示器。有物理屏幕时可先选择它；没有物理显示器时，先检查安装时是否已安装虚拟显示器驱动；需要补装时打开 GUI 的基地显示器设置，再选择基地显示器。
4. （**可选，不推荐**）若你更喜欢 WebUI 体验，在这台电脑的浏览器打开 [https://localhost:47990](https://localhost:47990)。如果浏览器提示证书不受信任，确认地址是这台电脑的 `https://localhost:47990` 后，通过浏览器“高级”或“更多选项”中的继续访问选项打开。
5. 首次使用按页面提示创建用户名和密码，未来可以使用它们登录 WebUI 管理界面。
### 2 安装控制端（Moonlight）
在手机、平板或另一台电脑上，按上面的[控制端（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 与色彩](docs/zh-CN/features.md#hdr-与色彩) · [基地虚拟显示器](docs/zh-CN/features.md#基地虚拟显示器-zakodisplay) · [画面捕获与编码](docs/zh-CN/features.md#捕获-编码与性能) · [手柄与 DualSense](docs/zh-CN/features.md#dualsense-与虚拟手柄) · [音频与麦克风透传](docs/zh-CN/features.md#音频与麦克风透传) · [独立桌面控制面板](docs/zh-CN/features.md#桌面控制面板)
## 帮助与参与
- [FAQ 与排障](docs/zh-CN/faq.md)：卡顿、丢帧、连接、声音和 DualSense 自动滚动等问题。
- [升级说明](docs/zh-CN/upgrading.md)：正式版、测试版、配置保留与更新后检查。
- [文档目录](docs/zh-CN/README.md)：按任务找到使用与开发指南。
- [官网](https://www.alkaidlab.com/) · [国内官网](https://www.alkaidlab.cn/) · [QQ 交流群](https://qm.qq.com/cgi-bin/qm/qr?k=5qnkzSaLIrIaU4FvumftZH_6Hg7fUuLD&jump_from=webapi)。
- [提交问题](https://github.com/AlkaidLab/foundation-sunshine/issues) · [讨论与建议](https://github.com/AlkaidLab/foundation-sunshine/discussions) · [贡献指南](docs/contributing.md)。
感谢 [LizardByte/Sunshine](https://github.com/LizardByte/Sunshine)、[Moonlight](https://moonlight-stream.org/)、[ZakoDisplay](https://github.com/qiin2333/zako-vdd)，以及开发、测试和翻译贡献者。项目遵循 [GPL-3.0 许可证](https://github.com/AlkaidLab/foundation-sunshine/blob/master/LICENSE)。
觉得好用就点个 Star。才不是为了这个继续修 bug 的呢。
## 基地开发团队成员
| [](https://github.com/qiin2333) | [](https://github.com/Yundi339) | [](https://github.com/ShadowLemoon) | [](https://github.com/skyhua0224) |
| :---: | :---: | :---: | :---: |
| [qiin2333](https://github.com/qiin2333) | [Yundi339](https://github.com/Yundi339) | [ShadowLemoon](https://github.com/ShadowLemoon) | [skyhua0224](https://github.com/skyhua0224) |
## 其他贡献者
感谢所有参与 Foundation 和 Sunshine 上游开发、测试及维护的贡献者。
![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4&s=80 "dependabot[bot]"){kind=small}
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4&s=80 "github-actions[bot]"){kind=small}
