Yattee项目自托管Invidious服务播放问题解决方案

问题背景

Yattee是一款开源的跨平台视频播放应用，支持iOS、tvOS和macOS系统。近期部分用户在使用自托管Invidious服务时遇到了视频无法播放的问题，主要表现为打开文件错误或连接失败。

问题分析

经过用户反馈和技术讨论，发现该问题主要与Invidious服务的签名验证组件有关。早期版本的Invidious使用inv-sig-helper作为签名验证组件，而新版本推荐使用invidious-companion替代。这一变更导致了Yattee客户端与自托管服务之间的兼容性问题。

解决方案

1. 组件替换

将docker-compose.yml中的inv-sig-helper替换为invidious-companion。这一变更能够解决大部分播放问题。

2. 配置调整

确保invidious-companion的正确配置，特别是以下关键参数：

• 域名设置
• 外部端口配置

这些设置不仅影响视频播放功能，还关系到缩略图的正常显示。用户反馈表明，未正确配置这些参数会导致登录后缩略图无法显示的问题。

3. 版本选择

注意区分正式版和测试版：

• App Store发布的正式版(Build 174)可能不完全兼容invidious-companion
• TestFlight测试版(Build 200)已包含对companion的更新支持

常见问题排查

1. 连接失败：检查服务端配置，确保域名和端口设置正确
2. 缩略图不显示：验证是否设置了正确的domain和external port参数
3. 音频语言错误：可能是MPV播放器配置问题，建议检查播放器设置

最佳实践建议

1. 使用最新版本的Invidious和invidious-companion
2. 保持Yattee客户端为最新版本，特别是TestFlight测试版
3. 部署完成后，先通过网页端验证服务是否正常工作
4. 遇到问题时，尝试清除客户端缓存并重新添加自定义位置

通过以上措施，大多数自托管Invidious服务的播放问题都能得到有效解决。对于仍存在的问题，建议检查详细的错误日志以进一步诊断。