Yattee项目中的缩略图显示问题分析与解决方案

问题现象

在使用Yattee客户端连接自托管Invidious实例时，用户反馈视频可以正常播放，但所有视频的缩略图都无法显示。类似问题也出现在订阅频道图标无法显示的情况。

根本原因分析

经过技术分析，发现该问题主要由两个方面的配置不当引起：

1. 服务器端口配置错误：自托管的Invidious实例未正确配置外部访问端口。例如，服务器可能错误地使用了内部Docker端口(如3000)而非外部访问端口(如443)。

2. SSL证书问题：服务器可能缺少有效的SSL证书配置，导致客户端无法安全地获取缩略图资源。

3. 频道图标缓存机制：Yattee对频道图标采用了缓存机制，首次访问时若未主动获取频道信息，则不会显示图标。

解决方案

缩略图显示问题

对于自托管Invidious实例，需要检查并修改以下配置参数：

external_port: 443
domain: sub.domain.org
https_only: true

确保：

1. 使用正确的外部访问端口(通常为443)
2. 配置正确的域名
3. 启用HTTPS-only模式
4. 部署有效的SSL证书

频道图标显示问题

频道图标不会立即显示属于预期行为，可通过以下方式解决：

1. 观看该频道的任意视频
2. 从订阅列表中点击进入频道详情页

这两种操作都会触发Yattee获取并缓存频道图标，之后便可在订阅列表中正常显示。

技术建议

对于自托管服务的管理员，建议：

1. 仔细检查Invidious的配置文件，确保所有URL生成相关的参数正确
2. 测试从外部网络访问缩略图资源的URL是否可达
3. 验证SSL证书链是否完整且受信任
4. 考虑使用反向代理(如Nginx)处理SSL终端和端口转发

对于终端用户，若遇到类似问题，可先尝试：

1. 切换不同的Invidious实例
2. 检查网络连接是否正常
3. 确认客户端版本是否为最新

通过以上措施，应能有效解决Yattee客户端中缩略图和频道图标无法显示的问题。