不想再手改 Traefik YAML?这个小工具真能省你不少事

0 阅读4分钟

如果你本来就在用 Traefik,而且路由规则是走 File Provider,那你大概率也踩过一个坑:配置本身不难,但一多起来就开始烦。

今天加一个域名,明天改一个后端,后天再补个 HTTPS 跳转。文件越改越多,命名越来越乱,过一阵自己都得先读半天 YAML,才敢继续下手。

Traefik Route Manager 干的事情很直接:给 Traefik 的文件路由配置套一个很轻的 Web UI,让你不用再靠手改 YAML 硬撑。

项目地址: github.com/jae-jae/tra…

你是不是也有这个痛点

很多 Homelab 和自托管玩家,其实并不怕折腾。

怕的是重复折腾。

尤其是这种事情:

  • 想给 plex.example.com 挂到内网服务上,还得自己写一段配置
  • 想开 HTTPS,顺手还得把 entryPointstls、跳转规则一起补上
  • 配置文件越来越多,但里面哪些是自己写的,哪些是工具生成的,时间一长就容易混
  • 临时改个端口,结果还得 SSH 上去翻目录、找文件、改 YAML、再检查有没有写错

说白了,Traefik 很强,File Provider 也很灵活,但日常管理确实不够轻松。

它到底解决了什么

这个项目的思路很讨喜,不走“大而全”,也不额外引入一堆依赖。

它就是专门帮你管理 Traefik File Provider 路由,而且只管它自己生成的那部分配置。每个域名对应一个文件,规则清楚,边界也清楚。

你在界面里填好域名、后端地址、要不要 HTTPS、要不要强制跳转 HTTPS,它就帮你生成标准的 Traefik 动态配置文件。Traefik 继续按你原来的方式监听目录、热加载配置,整个使用习惯不用推倒重来。

简单理解,它很像一个更轻、更专注 Traefik 的路由管理面板。

几个最值得记住的点

1. 没数据库,真的轻

很多人做自托管,最烦的不是功能少,而是“为了一个小工具再带一串依赖”。

Traefik Route Manager 这点很克制:不用数据库,不用 Redis,也不需要额外服务配合。你只要给它一个配置目录,它就能干活。

2. 一域名一文件,后期维护很舒服

每条路由都会落成一个 trm-{domain}.yml 文件。

这点特别适合 Homelab 场景。你以后要排查、备份、同步、做 Git 管理,都会轻松很多。文件名一看就知道谁是谁,不容易把自己维护的别的 Traefik 配置误伤掉。

3. 输出就是 Traefik 原生配置

它不是自己搞一套“私有规则”,也不是把配置藏起来。

生成出来的就是标准 Traefik dynamic config。换句话说,就算哪天你不用这个 UI 了,理解和接管这些配置也没什么门槛,不会被工具反向绑架。

4. HTTPS 和跳转这种高频需求,点一下就够

很多时候我们要的并不复杂,无非就是:

  • 这个域名转发到哪个内网服务
  • 要不要走 HTTPS
  • 要不要把 HTTP 自动跳到 HTTPS

这些在这个项目里都是直接可配的,不用你再手写一堆重复 YAML。

5. 对 AI Agent 也很友好

这个点挺有意思。

项目自带了给 AI 助手调用的说明,后面如果你想让 AI 直接帮你“新增一个域名路由”“把后端改成另一个地址”,它是有基础能力接上的。

对喜欢自动化、自托管、Agent 工作流的人来说,这个方向挺顺手。

界面长什么样

不是那种花里胡哨的面板风格,整体就是清爽、直接、够用。

Traefik Route Manager Screenshot.png

Traefik Route Manager Screenshot (1).png

你打开就能明白它是拿来干嘛的,不需要先研究半天。

怎么快速跑起来

如果你已经有 Traefik,只需要把它和 Traefik 的动态配置目录挂到同一个位置就行。

最省事的方式还是 Docker:

docker run -d \
  --name traefik-route-manager \
  -p 8892:8892 \
  -v /path/to/traefik/dynamic:/data \
  -e AUTH_TOKEN=your-secret-token \
  -e CONFIG_DIR=/data \
  ghcr.io/jae-jae/traefik-route-manager:main

如果你更习惯 Compose,也一样很好接。

核心就两件事:

  • 给它一个 AUTH_TOKEN
  • 让它和 Traefik 盯同一个动态配置目录

剩下的基本就交给它了。

适合谁用

这项目尤其适合这几类人:

  • 已经在用 Traefik File Provider,但不想继续手改 YAML 的人
  • 有 NAS、软路由、小主机、自建服务,想把反代管理再整理一点的人
  • 不想为了一个路由面板再引入数据库的人
  • 希望配置文件依然可读、可控、可备份的人

如果你要的是一个轻量、够用、边界清楚的 Traefik 路由管理工具,那它真的值得试一下。

最后一句

Traefik Route Manager 不是那种“功能多到你看不完”的项目,它更像一个很懂自托管用户痛点的小工具:不折腾你,不绑架你,还确实能把那堆重复的 YAML 工作省下来。