Theme.Park项目中Apache代理下文本Logo尺寸问题的解决方案

在Theme.Park项目为Prowlarr和Sonarr等应用提供主题定制时，部分用户在使用Apache代理配置时遇到了文本Logo显示尺寸不正确的问题。本文将深入分析问题原因并提供完整的解决方案。

问题现象

当用户通过Apache反向代理配置Theme.Park主题时，发现文本Logo（如Prowlarr、Sonarr等应用的Logo）显示尺寸异常。具体表现为Logo宽度未按预期调整，导致显示效果不协调。

根本原因分析

经过技术排查，发现该问题主要由两个因素导致：

1. CSS优先级冲突：Theme.Park提供的自定义CSS样式与应用程序原生的PageHeader.css样式存在优先级冲突，原生样式覆盖了主题样式。

2. Apache配置不当：用户错误地将样式替换(Substitute)指令应用在HTML的head部分而非body部分，导致主题样式无法正确加载和生效。

解决方案

正确的Apache配置方法

正确的Apache配置应修改Location块中的Substitute指令，将样式替换应用到body部分而非head部分。以下是正确的配置示例：

Define theme_park_name nord

<Location "/prowlarr">
    ProxyPass "http://localhost:8001/prowlarr"
    ProxyPassReverse "http://localhost:8001/prowlarr"
    
    RequestHeader unset Accept-Encoding
    AddOutputFilterByType SUBSTITUTE text/html
    Substitute 's|</body>|<link rel="stylesheet" type="text/css" href="https://theme-park.dev/css/base/prowlarr/${theme_park_name}.css"><link rel="stylesheet" type="text/css" href="https://theme-park.dev/css/addons/prowlarr/prowlarr-text-logo/prowlarr-text-logo.css"></body>|ni'
</Location>

CSS样式优化建议

虽然通过修正Apache配置可以解决大部分问题，但对于某些特殊情况，还可以考虑以下优化：

1. 在自定义CSS中使用!important声明提高样式优先级
2. 确保自定义样式表在原生样式表之后加载
3. 检查是否有其他中间件或缓存影响样式加载

注意事项

1. 此解决方案适用于Theme.Park支持的所有基于Arr的应用（Sonarr、Radarr、Prowlarr等）

2. 配置变更后需要重启Apache服务使更改生效

3. 建议清除浏览器缓存后再测试效果

4. 对于其他类似的前端显示问题，可参考此解决思路进行检查

通过以上调整，Theme.Park主题的文本Logo将能够正确显示预期尺寸，整体界面效果也将更加协调统一。这一解决方案不仅适用于当前报告的Logo尺寸问题，也为其他可能出现的样式冲突问题提供了参考思路。