在Tdarr中使用Traefik配置子路径访问的完整指南

背景介绍

Tdarr是一款优秀的媒体转码自动化工具，许多用户选择通过Traefik反向代理来安全地访问Tdarr的Web界面。在实际部署中，我们经常需要将Tdarr配置在子路径下（如/tdarr）而非根路径，以便在同一域名下管理多个服务。

问题分析

许多用户在尝试通过Traefik为Tdarr配置子路径访问时遇到了困难。常见问题包括：

• 页面加载不完整
• API请求被发送到错误的路径
• 出现"Bad Request"错误提示

这些问题通常源于Traefik中间件配置不完整，未能正确处理路径重写和前缀剥离。

解决方案

经过实践验证，以下是完整的Traefik标签配置方案：

labels:
  - "traefik.enable=true"
  - "traefik.http.routers.tdarr.rule=Host(`yourdomain.com`) && PathPrefix(`/tdarr`)"
  - "traefik.http.routers.tdarr.service=tdarr"
  - "traefik.http.routers.tdarr.middlewares=tdarr-strip,tdarr-pathregex"
  - "traefik.http.middlewares.tdarr-strip.stripprefix.prefixes=/tdarr"
  - "traefik.http.routers.tdarr.entrypoints=https"
  - "traefik.http.routers.tdarr.tls=true"
  - "traefik.http.services.tdarr.loadbalancer.server.port=8265"
  - "traefik.http.middlewares.tdarr-pathregex.replacepathregex.regex=^/tdarr(.*)"
  - "traefik.http.middlewares.tdarr-pathregex.replacepathregex.replacement=$$1"

配置详解

1. 基本路由配置：

   • 启用Traefik并设置路由规则，匹配特定域名和/tdarr路径前缀
   • 指定服务端口为Tdarr默认的8265端口

2. 中间件配置：

   • stripprefix中间件：移除请求路径中的/tdarr前缀
   • replacepathregex中间件：使用正则表达式重写路径，确保内部请求正确处理

3. 路径匹配要点：

   • PathPrefix、stripprefix.prefixes和replacepathregex.regex中的路径必须一致
   • 使用$$1而非$1来避免YAML转义问题

多级子路径配置示例

如果需要配置多级子路径（如/home/tdarr），配置应调整为：

labels:
  - "traefik.enable=true"
  - "traefik.http.routers.tdarr.rule=Host(`yourdomain.com`) && PathPrefix(`/home/tdarr`)"
  - "traefik.http.routers.tdarr.middlewares=tdarr-strip,tdarr-pathregex"
  - "traefik.http.middlewares.tdarr-strip.stripprefix.prefixes=/home/tdarr"
  - "traefik.http.middlewares.tdarr-pathregex.replacepathregex.regex=^/home/tdarr(.*)"
  - "traefik.http.middlewares.tdarr-pathregex.replacepathregex.replacement=$$1"

常见问题排查

1. 页面加载不完整：

   • 检查是否缺少replacepathregex中间件
   • 确保所有路径配置一致

2. API请求错误：

   • 确认正则表达式是否正确捕获路径
   • 检查替换模式是否使用了$$1

3. HTTPS问题：

   • 确保证书配置正确
   • 检查entrypoints是否设置为https

最佳实践建议

1. 始终测试配置前先清理浏览器缓存
2. 使用浏览器开发者工具监控网络请求，确认路径是否正确
3. 考虑在非生产环境测试配置后再部署
4. 保持Traefik和Tdarr版本更新

通过以上配置，用户可以成功地将Tdarr部署在子路径下，同时保持所有功能的完整性。这种配置方式也适用于其他需要子路径访问的Web应用。