初始 Traefik

使用 Docker Compose 初始化并配置 Traefik v3 反向代理，用于服务路由和负载均衡。

快速开始

1. 创建配置目录

bash
mkdir -p ~/.docker/compose
cd ~/.docker/compose

2. 创建 docker-compose.yml

使用 assets/docker-compose.yml 作为模板。关键配置如下：

yaml
services:
traefik:
image: traefik:v3.0
container_name: traefik
ports:
- 80:80
- 443:443
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- ./traefik-dynamic.yml:/etc/traefik/dynamic.yml:ro
command:
- --api=true
- --api.dashboard=true
- --providers.docker=true
- --providers.docker.exposedbydefault=false
- --providers.file.directory=/etc/traefik
- --providers.file.watch=true
- --entrypoints.web.address=:80
- --accesslog=true
- --metrics.prometheus=true

3. 创建动态配置

使用 assets/traefik-dynamic.yml 作为服务路由模板。

4. 启动 Traefik

bash
docker compose up -d

5. 将服务连接到网络

bash
for container in ; do
docker network connect compose_default $container
done

路由选项

选项 A：路径前缀路由（IP + 路径）

通过 http:/// 访问服务：

yaml
http:
routers:
n8n:
rule: PathPrefix(/n8n)
service: n8n
entryPoints:
- web
middlewares:
- n8n-stripprefix

middlewares:
n8n-stripprefix:
stripPrefix:
prefixes:
- /n8n

services:
n8n:
loadBalancer:
servers:
- url: http://n8n:5678

访问地址：http://192.168.9.192/n8n

选项 B：基于域名的路由（.nip.io）

通过 http://..nip.io 访问服务：

yaml
http:
routers:
n8n:
rule: Host(n8n.192.168.9.192.nip.io)
service: n8n
entryPoints:
- web

services:
n8n:
loadBalancer:
servers:
- url: http://n8n:5678

访问地址：http://n8n.192.168.9.192.nip.io

选项 C：Docker 标签

直接在 docker-compose.yml 的标签中配置路由：

yaml
services:
traefik:
labels:
- traefik.enable=true
- traefik.http.routers.dashboard.rule=Host(traefik.192.168.9.192.nip.io)
- traefik.http.routers.dashboard.service=api@internal
- traefik.http.routers.dashboard.entrypoints=web

启用功能

完整功能列表及配置请参见 references/features.md。

常见任务

添加新服务

1. 1. 将容器连接到网络：