anchorfree/oauth2

anchorfree/oauth2镜像说明

镜像概述

anchorfree/oauth2是一款集成Let's Encrypt证书支持的OAuth2代理镜像，旨在为Web服务提供安全的第三方认证机制，通常与steveltn/https-portal配合使用，实现HTTPS加密和GitHub身份验证。

核心功能

• OAuth2认证代理：支持GitHub作为身份提供商，验证用户身份；
• Let's Encrypt集成：自动管理HTTPS证书，确保通信加密；
• 无缝协作：与steveltn/https-portal工具配合，简化部署流程；
• 灵活配置：通过环境变量自定义域名、端口、认证参数等。

使用场景

• 需要为Web服务添加GitHub身份验证的场景；
• 希望通过HTTPS加密和第三方认证提升服务安全性的场景；
• 企业内部服务或公开服务的访问控制需求。

配置说明

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

• url：目标服务域名（如example.com）；
• http_port：本地HTTP服务端口；
• github_id：GitHub应用ID；
• github_secret：GitHub应用密钥；
• github_af_group：允许访问的GitHub组名。 需挂载SSL目录（如/path/to/ssl/directory）存储证书文件。

部署示例

以下是使用docker-compose部署anchorfree/oauth2与steveltn/https-portal的示例：

yaml
version: '2'
services:
  oauth2:
    image: anchorfree/oauth2
    container_name: oauth2
    network_mode: "host"
    ports:
      - '443:443'
    volumes:
      - "/path/to/ssl/directory:/etc/oauth2/ssl"
    environment:
      url: 'example.com'
      http_port: 'local_http_port'
      github_id: 'application_github_id_here'
      github_secret: 'application_github_secret_here'
      github_af_group: 'your_group_name'
    restart: always
    depends_on:
      - https-portal
  https-portal:
    image: steveltn/https-portal
    container_name: https-portal
    ports:
      - '80:80'
    volumes:
      - "/path/to/ssl/directory:/var/lib/https-portal"
    environment:
      DOMAINS: 'example.com'
      STAGE: 'production'