Gotify服务器在子路径部署时的路径处理问题解析

问题背景

Gotify是一款开源的实时消息推送服务，许多用户选择将其部署在反向代理(如Traefik)后面，并通过子路径(而非子域名)访问。但在实际部署中，当Gotify被配置在类似/gotify这样的子路径时，前端静态资源加载会出现404错误。

现象分析

当用户通过http://example.com/gotify访问时，虽然主页能正常返回200状态码，但所有静态资源(如CSS、JS文件)的请求却会失败，返回404错误。这是因为这些资源请求被发送到了根路径(如/static/js/main.js)，而非预期的子路径(如/gotify/static/js/main.js)。

技术原理

这个问题源于前端资源路径的处理机制。在Web应用中，静态资源通常使用相对路径或绝对路径引用：

1. 相对路径：如./static/js/main.js，会基于当前页面URL解析
2. 绝对路径：如/static/js/main.js，会直接从网站根目录解析

Gotify的前端使用了绝对路径引用静态资源，这在直接访问时工作正常，但在子路径部署时就会出现路径不匹配的问题。

解决方案

经过项目维护者的确认，这个问题可以通过在URL末尾添加斜杠(/)来解决。具体实现方式取决于你的部署环境：

对于Traefik用户

在Traefik配置中确保：

1. 路径前缀规则使用PathPrefix(/gotify/)(注意结尾斜杠)
2. 中间件的strip前缀也包含斜杠/gotify/
3. 访问时使用http://example.com/gotify/(带斜杠)

对于其他反向代理

类似的，确保：

1. 重写规则正确处理路径末尾的斜杠
2. 前端访问的URL包含结尾斜杠
3. 代理配置中保留或添加必要的路径前缀

配置示例

services:
  gotify:
    image: gotify/server
    labels:
      - traefik.http.routers.gotify.rule=PathPrefix(`/gotify/`)
      - traefik.http.middlewares.gotify.stripprefix.prefixes=/gotify/
      - homepage.href=/gotify/

深入理解

这个解决方案有效的根本原因是：当URL以斜杠结尾时，浏览器会将该URL识别为"目录"，后续的相对路径资源请求都会基于这个"目录"路径解析。而没有斜杠时，浏览器可能会错误地处理资源路径。

最佳实践

1. 始终在子路径配置中使用结尾斜杠
2. 确保所有相关链接(包括书签、导航等)都包含斜杠
3. 在反向代理配置中统一处理路径重写规则
4. 测试时验证所有静态资源是否加载正常

通过这种方式，Gotify可以完美地在子路径下工作，与其他服务共存于同一域名下，满足各种部署场景的需求。