arm64v8/traefik Docker 镜像 - 轩辕镜像

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

更多参考信息

• 问题反馈：[***]
• 支持的架构（更多信息）：
  • amd64 (amd64/traefik)
  • arm32v6 (arm32v6/traefik)
  • arm64v8 (arm64v8/traefik)
  • ppc64le (ppc64le/traefik)
  • riscv64 (riscv64/traefik)
  • s390x (s390x/traefik)
  • windows-amd64 (winamd64/traefik)
• 镜像 artifact 详情：repo-info仓库的traefik目录（含镜像元数据、传输大小等，历史记录）。
• 镜像更新：official-images仓库的library/traefik标签及对应文件（历史记录）。
• 描述来源：docs仓库的traefik目录（历史记录）。

!Traefik Logo

详细使用方法与配置说明

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

步骤5：访问Dashboard

浏览器访问http://localhost:8080，查看v2版本Dashboard。

!Traefik v2 Dashboard

官方文档与社区支持

• 完整文档：
  • Traefik v3.x：[***]
  • Traefik v2.11：[***]
• 社区支持：[***]

许可证信息

• 软件许可证：查看Traefik源码许可证。
• 镜像包含软件：本镜像可能包含基础发行版中的其他软件（如Bash等）及依赖，其许可证可能不同。
• 额外许可证信息：可在repo-info仓库的traefik目录中获取自动检测的许可证详情。

使用本镜像时，用户需自行确保对其中所有软件的使用符合相关许可证要求。