Apollo项目在Linux系统下的构建与使用指南

构建过程详解

Apollo作为Moonlight的开源自托管游戏流媒体主机，在Linux系统上的构建过程与Sunshine项目类似。开发者需要按照标准流程进行编译，但需注意几个关键点：

1. 构建命令与Sunshine项目一致，但需要额外处理web-ui部分
2. 构建完成后，必须将assets目录复制到/usr/local/assets位置
3. 若目标目录不存在，需要手动创建

常见问题解决方案

Web UI空白页面问题

当Web界面显示空白时，通常是由于资源文件位置不正确导致的。需要确保：

• 构建后的assets目录包含完整的web子目录
• 资源文件已正确复制到/usr/local/assets
• 目录权限设置正确，确保服务进程有读取权限

登录认证失败问题

新版Apollo改用cookie进行身份验证，这可能导致某些浏览器兼容性问题：

• 确保浏览器允许localhost/127.0.0.1的cookie
• 特别是https连接的cookie权限需要检查
• 若遇到问题，可尝试清除sunshine_state.json配置文件
• 推荐使用主流浏览器如Firefox进行访问

显示服务问题

目前已知的显示相关问题包括：

• Xorg环境下xrandr正常工作
• Wayland支持尚未完全测试，可能存在兼容性问题
• 编码部分与Sunshine保持一致，可参考其文档

系统服务配置建议

配置系统服务时需注意：

• 避免以root用户运行服务
• 检查日志中关于配置文件的路径提示
• 确保服务有权限访问所需资源
• 首次启动时会提示创建管理员账户

浏览器兼容性说明

由于Apollo采用了新的认证机制，对浏览器有以下要求：

• 必须支持并启用cookie功能
• 需要正确处理本地https连接的证书
• 某些新兴浏览器(如Zen Browser)可能存在兼容性问题
• 建议使用成熟的主流浏览器进行管理

通过以上步骤和注意事项，开发者可以在Linux系统上顺利完成Apollo的构建和部署，享受其增强的游戏流媒体功能。