Traefik Docker镜像 (arm64v8架构)

注意事项

本镜像为traefik镜像的arm64v8架构专用仓库。更多信息请参见镜像文档中的“非amd64架构？”及***镜像FAQ中的“镜像源码在Git中变更后如何处理？”。

镜像概述与主要用途

Traefik（云原生边缘路由器）是一款现代HTTP反向代理和入口控制器，旨在简化微服务部署。本镜像为arm64v8架构的Traefik***Docker镜像，可直接用于基于ARM64架构的设备或环境中，提供动态、自动的流量路由能力。

核心功能与特性

多平台集成：无缝对接主流基础设施组件，包括Kubernetes、Docker、Swarm、Consul、Nomad、etcd、Amazon ECS等。
动态自动配置：无需手动编写配置文件，Traefik可通过指向编排工具自动发现并配置服务路由。
内置监控与可视化：提供Web Dashboard，实时展示路由器、服务及中间件状态。
云原生设计：轻量、高性能，专为容器化和微服务架构优化。

使用场景与适用范围

微服务部署：作为微服务架构的入口点，统一管理服务间流量路由。
云原生环境：在Kubernetes、Docker Swarm等容器编排平台中作为入口控制器。
动态服务发现：适用于服务频繁扩缩容、地址动态变化的场景。
多环境统一路由：在开发、测试、生产环境中提供一致的路由规则管理。

快速参考

维护者

Traefik项目

获取帮助

Docker社区Slack
Server Fault
Unix & Linux Stack Exchange
Stack Overflow

支持的标签及对应Dockerfile链接

v3系列

v3.5.3, 3.5.3, v3.5, 3.5, v3, 3, chabichou, latest

v2系列

v2.11.29, 2.11.29, v2.11, 2.11, v2, 2, mimolette

详细使用方法与配置说明

Traefik v3 使用示例

步骤1：创建配置文件

创建traefik.yml配置文件，启用Docker provider和Dashboard UI：

yaml
## traefik.yml

# Docker配置后端
providers:
  docker:
    defaultRule: "Host(`{{ trimPrefix `/` .Name }}.docker.localhost`)"  # 默认路由规则：容器名.docker.localhost

# API和Dashboard配置
api:
  insecure: true  # 允许不安全访问（仅用于测试，生产环境需配置TLS）

步骤2：启动Traefik v3容器

bash
docker run -d -p 8080:8080 -p 80:80 \
  -v $PWD/traefik.yml:/etc/traefik/traefik.yml \  # 挂载配置文件
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载Docker套接字（用于发现容器）
  arm64v8/traefik:v3  # 使用arm64v8架构的v3标签镜像

步骤3：启动后端测试服务

使用traefik/whoami镜像启动一个后端服务：

bash
docker run -d --name test traefik/whoami

步骤4：验证服务访问

通过Traefik访问后端服务（规则为test.docker.localhost）：

console
$ curl test.docker.localhost
Hostname: 0693100b16de
IP: 127.0.0.1
IP: ::1
IP: 192.168.215.4
RemoteAddr: 192.168.215.3:57618
GET / HTTP/1.1
Host: test.docker.localhost
User-Agent: curl/8.7.1
Accept: */*
Accept-Encoding: gzip
X-Forwarded-For: 192.168.215.1
X-Forwarded-Host: test.docker.localhost
X-Forwarded-Port: 80
X-Forwarded-Proto: http
X-Forwarded-Server: 8a37fd4f35fb
X-Real-Ip: 192.168.215.1

步骤5：访问Dashboard

打开浏览器访问http://localhost:8080，即可查看Traefik Dashboard，实时监控路由、服务及中间件状态。

!Traefik v3 Dashboard

Traefik v2 使用示例

步骤1：创建配置文件

创建traefik.yml配置文件：

yaml
## traefik.yml

# Docker配置后端
providers:
  docker:
    defaultRule: "Host(`{{ trimPrefix `/` .Name }}.docker.localhost`)"  # 默认路由规则：容器名.docker.localhost

# API和Dashboard配置
api:
  insecure: true  # 允许不安全访问（仅用于测试）

步骤2：启动Traefik v2容器

bash
docker run -d -p 8080:8080 -p 80:80 \
  -v $PWD/traefik.yml:/etc/traefik/traefik.yml \  # 挂载配置文件
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载Docker套接字
  arm64v8/traefik:v2.11  # 使用arm64v8架构的v2.11标签镜像

步骤3：启动后端测试服务

bash
docker run -d --name test traefik/whoami

步骤4：验证服务访问

console
$ curl test.docker.localhost
Hostname: 390a880bdfab
IP: 127.0.0.1
IP: 172.17.0.3
GET / HTTP/1.1
Host: test.docker.localhost
User-Agent: curl/7.65.3
Accept: */*
Accept-Encoding: gzip
X-Forwarded-For: 172.17.0.1
X-Forwarded-Host: test.docker.localhost
X-Forwarded-Port: 80
X-Forwarded-Proto: http
X-Forwarded-Server: 7e073cb54211
X-Real-Ip: 172.17.0.1