Apollo桌面流媒体：快速搭建个人云游戏的完整指南

【免费下载链接】Apollo Sunshine fork - The easiest way to stream with the native resolution of your client device 项目地址: https://gitcode.com/gh_mirrors/apollo18/Apollo

Apollo是一款自托管的桌面流媒体主机，专为Artemis（Moonlight Noir）设计，提供低延迟、原生客户端分辨率的云游戏服务器功能。这个强大的开源项目支持AMD、Intel和NVIDIA GPU硬件编码，让你轻松将游戏流式传输到任何设备。🎮

为什么选择Apollo进行桌面流媒体？

Apollo作为Sunshine的分支项目，专注于提供最佳的流媒体体验。它内置了虚拟显示功能，支持HDR，并能自动匹配客户端的分辨率和帧率配置。与传统流媒体解决方案相比，Apollo具有以下核心优势：

• 低延迟流媒体：优化的编码和网络传输确保游戏体验流畅
• 原生分辨率支持：完美匹配客户端设备的分辨率
• 多GPU支持：无缝支持AMD、Intel和NVIDIA显卡
• 权限管理系统：精细控制客户端访问权限
• 剪贴板同步：在主机和客户端间无缝共享文本

系统要求与硬件兼容性

在开始之前，请确保你的系统满足以下最低要求：

最低系统配置

• GPU：
  • AMD：VCE 1.0或更高版本
  • Intel：支持VAAPI的显卡
  • NVIDIA：启用NVENC的显卡
• CPU：AMD Ryzen 3或Intel Core i3以上
• 内存：4GB或更多
• 操作系统：
  • Windows 10+
  • macOS 12+
  • Linux（Ubuntu 22.04+、Debian 11+、Fedora 39+）

4K流媒体建议配置

• GPU：AMD Video Coding Engine 3.1+、Intel HD Graphics 510+、NVIDIA GeForce GTX 1080+
• CPU：AMD Ryzen 5或Intel Core i5以上
• 网络：CAT5e以太网或更好

一键安装Apollo桌面流媒体服务器

Windows用户安装指南

Windows用户可以通过多种方式安装Apollo：

1. 推荐方式：从Releases页面下载最新安装包
2. WinGet安装（社区维护）：

   winget install ClassicOldSong.Apollo
   

3. Chocolatey安装（社区维护）：

   choco upgrade apollo -y
   

Linux用户安装选项

Linux用户可以根据发行版选择最适合的安装方式：

• AppImage：适用于大多数现代Linux发行版
• ArchLinux：通过AUR或预构建包安装
• Debian/Ubuntu：使用.deb包安装
• Flatpak：跨发行版解决方案

macOS用户注意事项

macOS版本目前处于实验阶段，暂不支持游戏手柄功能。可以通过Homebrew安装：

brew tap LizardByte/homebrew
brew install sunshine

配置虚拟显示与HDR设置

虚拟显示功能详解

Apollo使用SudoVDA虚拟显示适配器，为每个Artemis/Moonlight客户端分配固定标识，Windows原生管理显示配置。虚拟显示功能位于src/platform/windows/virtual_display.cpp中实现。

重要提示：

• 移除系统中其他虚拟显示解决方案，避免兼容性问题
• 虚拟显示在流开始时创建，应用退出时移除
• 支持自动分辨率和帧率匹配

HDR流媒体配置

HDR支持从Windows 11 23H2开始，在24H2中得到普遍支持。配置位于src/config.h中：

std::chrono::milliseconds hdr_toggle_delay;
enum class hdr_mode {
    disabled,   // 不更改HDR设置
    automatic   // 更改HDR设置并使用Moonlight请求的状态
};

HDR使用建议：

1. 确保客户端设备支持HDR
2. 在客户端Moonlight设置中启用HDR选项
3. 根据显示设备能力调整游戏亮度设置

Web UI配置与客户端配对

安装完成后，通过Web界面进行配置：

1. 访问 https://localhost:47990（或使用内部IP地址）
2. 首次访问时创建用户名和密码
3. 忽略浏览器关于"不安全网站"的警告（使用自签名SSL证书）

添加游戏和应用程序

在Web UI中：

• 配置工作目录和启动命令
• 使用环境变量：$(HOME)会被替换为$HOME值
• $$会被替换为$，例如$$(HOME)变为$(HOME)

客户端配对流程

1. 在Moonlight中添加PC
2. 当Moonlight要求输入PIN时：
   • 登录Web UI
   • 导航到"PIN"页面
   • 输入PIN并按Enter，显示成功消息
   • 在Moonlight中选择列出的应用程序

双GPU笔记本优化配置

Apollo完美支持双GPU笔记本配置：

1. 在"音频/视频"选项卡中设置Adapter Name为dGPU
2. 启用Headless mode
3. 保存配置并重启计算机
4. 无需虚拟显示器，图像将直接从dGPU渲染和编码

权限管理系统详解

Apollo的权限系统提供精细的访问控制：

• 第一个配对的客户端：获得完全权限
• 后续配对的客户端：仅获得查看流和列出应用权限
• 权限管理：在Web UI中为每个设备分配特定权限

如果遇到"权限被拒绝"错误，请检查并授予相应的启动应用、鼠标输入或键盘输入权限。

故障排除与性能优化

常见问题解决

1. 画面卡顿：检查网络连接，确保使用5GHz WiFi或以太网
2. 输入不工作：将运行Sunshine的用户添加到input组（Linux）
3. 虚拟显示问题：确保没有其他虚拟显示解决方案冲突

性能优化技巧

• 使用有线网络连接获得最佳体验
• 根据客户端设备调整编码设置
• 启用硬件编码以降低CPU负载
• 定期更新显卡驱动程序

多实例运行与高级配置

对于需要多个虚拟显示的用户，Apollo支持运行多个实例。详细指南可在项目Wiki中找到。

社区支持与贡献

Apollo项目欢迎贡献和改进PR。与原始项目不同，这里更注重社区反馈和功能改进。目前支持通过GitHub Issues/Discussions获取帮助。

免责声明：Apollo和Artemis最终将不再与原始Sunshine和Moonlight兼容，但会提供更精心设计的功能。

通过这篇完整指南，你现在应该能够成功搭建自己的Apollo桌面流媒体服务器，享受高质量的游戏流媒体体验。无论你是想在平板电脑上玩PC游戏，还是在电视上享受桌面应用，Apollo都能提供稳定、低延迟的解决方案。🚀

【免费下载链接】Apollo Sunshine fork - The easiest way to stream with the native resolution of your client device 项目地址: https://gitcode.com/gh_mirrors/apollo18/Apollo