a5huynh/oauth2_proxy

oauth2_proxy Docker镜像

这是bitly开源工具https://github.com/bitly/oauth2_proxy的Docker化版本，用于提供OAuth2认证代理服务，保护上游Web应用或API的访问安全。

核心功能

• 基于OAuth2协议的认证代理，支持多种身份提供商（如Google、GitHub等）
• 支持通过命令行参数或环境变量配置关键参数（客户端ID、密钥、Cookie密钥等）
• 提供Docker Compose和直接运行两种部署方式，便于快速集成
• 自动构建镜像，提供多个版本标签选择

使用场景

• 保护内部Web应用，仅允许已认证用户访问
• 为API服务添加OAuth2认证层，增强安全性
• 简化Web应用的OAuth2集成流程

配置说明

默认参数

镜像默认配置：

• 上游服务地址：http://0.0.0.0:8080/
• 代理监听地址：0.0.0.0:4180

环境变量配置

可通过以下环境变量设置关键参数：

• OAUTH2_PROXY_COOKIE_SECRET：安全Cookie的种子字符串
• OAUTH2_PROXY_CLIENT_ID：OAuth2客户端ID
• OAUTH2_PROXY_CLIENT_SECRET：OAuth2客户端密钥

部署示例

Docker Compose部署

1. 修改docker-compose.yml中的客户端ID、密钥、Cookie密钥，替换example.com为你的域名
2. 运行命令：

bash
docker-compose up

3. 访问http://localhost:4180/ping验证代理是否正常运行

Docker直接运行

假设上游服务地址为upstream:80：

bash
docker run -P docker.xuanyuan.run/a5huynh/oauth2_proxy \
    --cookie-secure=false \
    --upstream="http://upstream:80" \
    --http-address="0.0.0.0:4180" \
    --redirect-url="http://example.com/oauth2/callback" \
    --email-domain="example.com" \
    --cookie-secret=<你的Cookie密钥> \
    --client-id=<你的客户端ID> \
    --client-secret=<你的客户端密钥>

环境变量方式运行

bash
docker run -e OAUTH2_PROXY_COOKIE_SECRET=<你的Cookie密钥> \
    -e OAUTH2_PROXY_CLIENT_ID=<你的客户端ID> \
    -e OAUTH2_PROXY_CLIENT_SECRET=<你的客户端密钥> \
    a5huynh/oauth2_proxy