jkernech/oauth2-proxy

Docker OAuth2 Proxy

镜像概述

本镜像基于 https://github.com/bitly/oauth2_proxy 进行Docker化封装，是一款集反向代理与静态文件服务于一体的身份认证工具，通过OAuth2协议对接主流提供商实现用户身份验证。

核心功能

1. 反向代理：作为中间层转发请求，保护后端服务免受直接暴露；
2. 静态文件服务：支持直接托管并提供静态资源访问；
3. 多提供商支持：兼容Google、GitHub等主流OAuth2认证服务；
4. 精细化权限控制：可按用户***、所属域名或组筛选合法访问者。

使用场景

• 内部系统的访问权限控制；
• 静态资源（如文档、前端页面）的安全访问保护；
• API接口的身份认证前置层。

配置说明

主要通过环境变量配置关键参数：

• OAUTH2_PROXY_CLIENT_ID：OAuth2提供商分配的客户端ID；
• OAUTH2_PROXY_CLIENT_SECRET：OAuth提供商分配的客户端密钥；
• OAUTH2_PROXY_COOKIE_SECRET：用于加密Cookie的随机字符串（建议用openssl rand -hex 16生成）；
• OAUTH2_PROXY_ALLOWED_EMAILS：允许访问的***列表（逗号分隔）；
• OAUTH2_PROXY_ALLOWED_DOMAINS：允许访问的域名（逗号分隔）。

部署示例

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_COOKIE_SECRET="$(openssl rand -hex 16)" \
  -e OAUTH2_PROXY_ALLOWED_DOMAINS="example.com" \
  jkernech/oauth2-proxy

Docker Compose示例

yaml
version: '3'
services:
  oauth2-proxy:
    image: jkernech/oauth2-proxy
    ports:
      - "4180:4180"
    environment:
      OAUTH2_PROXY_CLIENT_ID: "your-client-id"
      OAUTH2_PROXY_CLIENT_SECRET: "your-client-secret"
      OAUTH2_PROXY_COOKIE_SECRET: "your-cookie-secret"
      OAUTH2_PROXY_ALLOWED_DOMAINS: "example.com"
    restart: always