trajano/oidc-proxy

Docker OIDC Proxy镜像说明

镜像概述

本镜像基于Apache HTTP Server和mod-auth-openidc模块构建，是一个OIDC（OpenID Connect）代理服务器。它设计为与Traefik配合使用，作为HTTPS入口点处理OIDC认证流程，然后将经过认证的请求转发至内部服务。

核心功能

1. 集成mod-auth-openidc模块，支持标准OIDC认证流程
2. 与Traefik无缝配合，作为HTTPS入口处理身份验证
3. 将认证后的请求转发至指定的内部后端服务
4. 通过环境变量灵活配置OIDC参数和后端服务信息

使用场景

• 需要为内部Web服务添加OIDC身份认证层的场景
• 企业应用中统一身份验证的代理需求
• 与Traefik结合构建安全的HTTPS入口架构

配置说明

以下是关键环境变量的说明：

部署示例

Docker Run命令

bash
docker run -d \
  -p 8080:80 \
  -e OIDC_PROVIDER_METADATA_URL="https://accounts.google.com/.well-known/openid-configuration" \
  -e OIDC_CLIENT_ID="your-client-id" \
  -e OIDC_CLIENT_SECRET="your-client-secret" \
  -e OIDC_REDIRECT_URI="/cb" \
  -e OIDC_CRYPTO_PASSPHRASE="exec:/random_password" \
  -e SERVER_NAME="your-domain.com" \
  -e SERVICE_NAME="internal-service" \
  -e SERVICE_PORT="8080" \
  docker.xuanyuan.run/trajano/oidc-proxy

Docker Compose示例

yaml
version: '3'
services:
  oidc-proxy:
    image: trajano/oidc-proxy
    ports:
      - "8080:80"
    environment:
      OIDC_PROVIDER_METADATA_URL: "https://accounts.google.com/.well-known/openid-configuration"
      OIDC_CLIENT_ID: "your-client-id"
      OIDC_CLIENT_SECRET: "your-client-secret"
      OIDC_REDIRECT_URI: "/cb"
      OIDC_***_PASSPHRASE: "exec:/random_password"
      SERVER_NAME: "your-domain.com"
      SERVICE_NAME: "internal-service"
      SERVICE_PORT: "8080"
    depends_on:
      - internal-service
  internal-service:
    image: your-internal-service-image
    ports:
      - "8080:8080"