quiq/oauth2_proxy Docker 镜像 - 轩辕镜像

oauth2_proxy 镜像文档

概述

本镜像为轻量级 OAuth2 代理服务容器，基于最新 Alpine Linux 构建，集成 oauth2_proxy 功能。通过 Docker Notary 签名确保镜像完整性和真实性，具备体积小、资源占用低的特点，适用于需要 OAuth2 认证代理的各类场景。

核心功能与特性

• 最小化基础：基于 Alpine Linux，镜像体积精简，运行时资源消耗低
• 安全保障：通过 Docker Notary 签名，确保镜像在分发和部署过程中未被篡改
• OAuth2 代理能力：集成 oauth2_proxy 核心功能，支持主流 OAuth2 提供方（如 Google、GitHub、Azure 等）的认证流程

使用场景

• 保护无内置认证机制的 Web 应用或 API 服务，实现基于 OAuth2 的访问控制
• 作为微服务架构中的统一认证入口，提供单点登录（SSO）能力
• 在边缘计算或资源受限环境中部署轻量级 OAuth2 代理服务

使用方法与配置说明

基本部署（docker run）

bash
docker run -d --name oauth2-proxy \
  -p 4180:4180 \
  [镜像名称] \
  --provider=<oauth-provider> \
  --client-id=<your-client-id> \
  --client-secret=<your-client-secret> \
  --redirect-url=http://<your-domain>:4180/callback \
  --upstream=http://<protected-service>:<port>

关键参数说明

环境变量配置

支持通过环境变量传递配置参数，常用变量对应关系如下：

• OAUTH2_PROXY_PROVIDER → --provider
• OAUTH2_PROXY_CLIENT_ID → --client-id
• OAUTH2_PROXY_CLIENT_SECRET → --client-secret
• OAUTH2_PROXY_REDIRECT_URL → --redirect-url
• OAUTH2_PROXY_UPSTREAM → --upstream

注：完整配置参数及高级用法可参考 oauth2_proxy 官方文档