a5huynh/oauth2_proxy

oauth2_proxy Docker镜像

这是bitly开源工具https://github.com/bitly/oauth2_proxy%E7%9A%84Docker%E5%8C%96%E7%89%88%E6%9C%AC%EF%BC%8C%E7%94%A8%E4%BA%8E%E6%8F%90%E4%BE%9BOAuth2%E8%AE%A4%E8%AF%81%E4%BB%A3%E7%90%86%E6%9C%8D%E5%8A%A1%EF%BC%8C%E4%BF%9D%E6%8A%A4%E4%B8%8A%E6%B8%B8Web%E5%BA%94%E7%94%A8%E6%88%96API%E7%9A%84%E8%AE%BF%E9%97%AE%E5%AE%89%E5%85%A8%E3%80%82

核心功能

• 基于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 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