arm64v8/traefik

Traefik Docker镜像 (arm64v8架构)

注意事项

本镜像为https://hub.docker.com/_/traefik%E7%9A%84%60arm64v8%60%E6%9E%B6%E6%9E%84%E4%B8%93%E7%94%A8%E4%BB%93%E5%BA%93%E3%80%82%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84https://github.com/docker-library/official-images#architectures-other-than-amd64%E5%8F%8A%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

镜像概述与主要用途

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

核心功能与特性

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

使用场景与适用范围

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

快速参考

维护者

https://github.com/traefik/traefik-library-image

获取帮助

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

支持的标签及对应Dockerfile链接

v3系列

• https://github.com/traefik/traefik-library-image/blob/d670ca0784dab782d512d5a38ad1cf164b2cdb4a/v3.5/alpine/Dockerfile

v2系列

• https://github.com/traefik/traefik-library-image/blob/ad4563c38375d0cc39f9016241b69518398a5b2b/v2.11/alpine/Dockerfile

更多参考信息

• 问题反馈：https://github.com/traefik/traefik-library-image/issues?q=
• 支持的架构（https://github.com/docker-library/official-images#architectures-other-than-amd64%EF%BC%89%EF%BC%9A
  • amd64 (https://hub.docker.com/r/amd64/traefik/)
  • arm32v6 (https://hub.docker.com/r/arm32v6/traefik/)
  • arm64v8 (https://hub.docker.com/r/arm64v8/traefik/)
  • ppc64le (https://hub.docker.com/r/ppc64le/traefik/)
  • riscv64 (https://hub.docker.com/r/riscv64/traefik/)
  • s390x (https://hub.docker.com/r/s390x/traefik/)
  • windows-amd64 (https://hub.docker.com/r/winamd64/traefik/)
• 镜像 artifact 详情：https://github.com/docker-library/repo-info/blob/master/repos/traefik%EF%BC%88%E5%90%AB%E9%95%9C%E5%83%8F%E5%85%83%E6%95%B0%E6%8D%AE%E3%80%81%E4%BC%A0%E8%BE%93%E5%A4%A7%E5%B0%8F%E7%AD%89%EF%BC%8Chttps://github.com/docker-library/repo-info/commits/master/repos/traefik%EF%BC%89%E3%80%82
• 镜像更新：https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Ftraefik%E5%8F%8Ahttps://github.com/docker-library/official-images/blob/master/library/traefik%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/traefik%EF%BC%89%E3%80%82
• 描述来源：https://github.com/docker-library/docs/tree/master/traefik%EF%BC%88https://github.com/docker-library/docs/commits/master/traefik%EF%BC%89%E3%80%82

!https://raw.githubusercontent.com/docker-library/docs/a6cc2c5f4bc6658168f2a0abbb0307acaefff80e/traefik/logo.png

详细使用方法与配置说明

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，实时监控路由、服务及中间件状态。

!https://raw.githubusercontent.com/traefik/traefik/v3.2/docs/content/assets/img/webui-dashboard.png

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。

!https://raw.githubusercontent.com/traefik/traefik/v2.0/docs/content/assets/img/webui-dashboard.png

官方文档与社区支持

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

许可证信息

• 软件许可证：查看https://github.com/traefik/traefik/blob/master/LICENSE.md%E3%80%82
• 镜像包含软件：本镜像可能包含基础发行版中的其他软件（如Bash等）及依赖，其许可证可能不同。
• 额外许可证信息：可在https://github.com/docker-library/repo-info/tree/master/repos/traefik%E4%B8%AD%E8%8E%B7%E5%8F%96%E8%87%AA%E5%8A%A8%E6%A3%80%E6%B5%8B%E7%9A%84%E8%AE%B8%E5%8F%AF%E8%AF%81%E8%AF%A6%E6%83%85%E3%80%82

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