hartje/oauth2-proxy

hartje/oauth2-proxy 镜像说明

镜像概述

hartje/oauth2-proxy是基于docker buildx构建的多架构OAuth2认证代理镜像，同时支持arm64和amd64平台，可在不同硬件环境中提供一致的身份验证服务。

核心功能

• 实现OAuth2协议认证，兼容Google、GitHub、Azure AD等主流身份提供商
• 多架构支持：统一镜像适配arm64（如树莓派）和amd64（如x86服务器）平台
• 保护Web应用/API，拦截未认证请求并引导用户完成登录
• 支持会话管理、令牌刷新及Cookie加密等安全特性

使用场景

• 为内部办公系统、私有API添加身份验证层
• 在混合架构环境中部署统一的认证代理服务
• 替代传统用户名密码登录，提升应用安全性

配置说明

通过环境变量或挂载配置文件（/etc/oauth2-proxy/oauth2-proxy.cfg）配置，关键参数示例：

• OAUTH2_PROXY_CLIENT_ID：身份提供商分配的Client ID
• OAUTH2_PROXY_CLIENT_SECRET：身份提供商分配的Client Secret
• OAUTH2_PROXY_UPSTREAMS：目标服务地址（如http://app:8080）
• OAUTH2_PROXY_COOKIE_SECRET：Cookie加密密钥（建议用openssl rand -hex 16生成）

部署示例

Docker Run命令

bash
docker run -d \
  --name oauth2-proxy \
  -p 4180:4180 \
  -e OAUTH2_PROXY_CLIENT_ID="your-client-id" \
  -e OAUTH2_PROXY_CLIENT_SECRET="your-client-secret" \
  -e OAUTH2_PROXY_UPSTREAMS="http://your-upstream:80" \
  -e OAUTH2_PROXY_COOKIE_SECRET="$(openssl rand -hex 16)" \
  hartje/oauth2-proxy

Docker Compose示例

yaml
version: "3.8"
services:
  oauth2-proxy:
    image: hartje/oauth2-proxy
    ports:
      - "4180:4180"
    environment:
      OAUTH2_PROXY_CLIENT_ID: "your-client-id"
      OAUTH2_PROXY_CLIENT_SECRET: "your-client-secret"
      OAUTH2_PROXY_UPSTREAMS: "[***]"
      OAUTH2_PROXY_COOKIE_SECRET: "your-cookie-secret"
    restart: always