解决WhatsUpDocker中LinuxServer容器版本检测问题

在使用WhatsUpDocker(WUD)监控LinuxServer.io(LSIO)容器时，用户可能会遇到版本检测和比较的问题。本文将深入分析问题原因并提供解决方案。

问题背景

LinuxServer.io为许多流行应用(如Sonarr)提供了重新打包的Docker镜像。这些镜像使用特殊的版本标签格式，例如version-4.0.9.2244，这与上游项目的标准版本格式不同。

问题分析

WUD默认使用语义化版本(SemVer)规范来比较版本号。然而，LinuxServer的版本格式存在两个关键问题：

1. 版本号格式不符合标准SemVer规范
2. 构建编号(如2244)使用点号(.)分隔而非连字符(-)

这导致WUD无法正确识别最新版本，甚至可能误报更新。

解决方案

1. 版本标签转换

使用WUD的tag.transform功能将LinuxServer格式转换为标准格式：

wud.tag.include=^version-\d+\.\d+\.\d+\.\d+$$
wud.tag.transform=^version-(\d+\.\d+\.\d+)\.(\d+)$ => $1-$2

这个正则表达式转换：

• 从version-4.0.9.2244
• 到4.0.9-2244

2. 版本链接处理

由于转换后的版本格式与上游项目不同，链接模板需要特殊处理。虽然WUD目前只提供完整的转换后字符串，但可以通过以下方式解决：

wud.link.template=https://github.com/Sonarr/Sonarr/releases/tag/v${transformed.split('-')[0]}

这将从转换后的版本(如4.0.9-2244)中提取主版本号(4.0.9)用于生成正确的发布页面链接。

最佳实践

对于监控LinuxServer容器，建议：

1. 始终检查实际可用的标签格式
2. 使用tag.include过滤掉不需要的标签
3. 通过tag.transform将版本转换为标准格式
4. 测试版本比较功能是否正常工作
5. 根据上游项目的发布格式调整链接模板

总结

通过合理配置WUD的标签处理功能，可以有效解决LinuxServer特殊版本格式带来的监控问题。关键在于理解版本格式差异并正确使用正则表达式进行转换。