cdrocker/traefik-forward-auth

traefik-forward-auth Docker镜像文档

镜像概述

本镜像提供traefik-forward-auth服务，基于Go 1.23及最新Go模块编译，支持arm64和amd64两种架构。traefik-forward-auth是Traefik的身份验证中间件，用于实现请求的身份验证转发与访问控制。

核心功能与特性

• 架构支持：同时支持arm64和amd64架构，适配不同硬件环境
• 编译环境：基于Go 1.23构建，确保使用最新语言特性与安全更新
• 依赖管理：集成最新Go模块，依赖库保持更新状态
• 功能完整性：完整实现traefik-forward-auth的身份验证转发功能

使用场景与适用范围

适用于需要通过Traefik进行身份验证管理的场景，包括但不限于：

• 保护内部Web服务的访问安全
• 实现基于OAuth/OIDC等协议的第三方身份认证
• 在混合架构环境（ARM/x86服务器）中部署Traefik时的身份验证组件
• 需要集中式身份验证控制的微服务架构

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name traefik-forward-auth \
  --restart always \
  -p 4181:4181 \
  [镜像名称]:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  traefik-forward-auth:
    image: [镜像名称]:latest
    container_name: traefik-forward-auth
    restart: unless-stopped
    ports:
      - "4181:4181"
    environment:
      # 基础认证配置（示例）
      - AUTH_PROVIDER=oidc
      - OIDC_ISSUER_URL=https://your-oidc-provider.com
      - OIDC_CLIENT_ID=your-client-id
      - OIDC_CLIENT_SECRET=your-client-secret
      - OIDC_REDIRECT_URL=https://auth.yourdomain.com/_oauth
    volumes:
      - ./config:/config  # 可选：挂载配置文件
    networks:
      - traefik-network

networks:
  traefik-network:
    external: true

配置说明

具体配置参数需根据实际认证需求设置，主要环境变量包括：

• AUTH_PROVIDER：认证提供商类型（如oauth、oidc等）
• 针对不同提供商的特定配置（如OIDC的OIDC_ISSUER_URL、OIDC_CLIENT_ID等）
• 详细配置请参考traefik-forward-auth官方文档，根据选择的认证提供商进行参数设置

注：实际使用时需将[镜像名称]替换为具体的镜像标识