dwpdigital/squid-s3

docker-squid-s3

镜像概述和主要用途

docker-squid-s3是一个包含Squid代理服务器的Docker容器，其核心功能是从Amazon S3存储桶中获取Squid的配置文件。该容器适用于需要动态管理Squid配置的场景，支持通过多种AWS认证方式访问S3资源。镜像可通过Docker Hub获取：https://hub.docker.com/r/dwpdigital/squid-s3%E3%80%82

核心功能和特性

• 动态配置获取：从S3存储桶自动拉取Squid配置文件，实现配置的集中化和动态更新
• 灵活的AWS认证：支持IAM角色（EC2实例配置文件、ECS任务执行角色）、AWS访问密钥直接认证以及角色切换（AssumeRole）等多种认证方式
• 环境变量配置：通过环境变量灵活配置S3资源路径和AWS认证参数，无需修改容器内部文件

使用场景和适用范围

• 云环境中（如EC2、ECS）需要动态管理Squid配置的部署
• 需要集中化管理多个Squid实例配置的场景
• 开发测试环境中快速部署带有特定配置的Squid代理
• 需要通过角色切换（AssumeRole）访问跨账户S3配置文件的场景

详细使用方法和配置说明

构建镜像

bash
docker build -t squid-s3 .

环境变量配置

Squid配置文件位置（必填）

• SQUID_CONFIG_S3_BUCKET：必填，存储Squid配置文件的S3桶名称
• SQUID_CONFIG_S3_PREFIX：必填，S3桶中Squid配置文件的前缀路径

AWS认证凭据（可选）

当部署环境未使用IAM配置文件（如任务执行角色或EC2实例配置文件）时，需提供以下凭据：

• AWS_ACCESS_KEY_ID：用于S3认证的访问密钥ID
• AWS_SECRET_ACCESS_KEY：用于S3认证的密钥

角色切换配置（可选）

当需要通过切换角色访问S3资源时，需提供以下参数：

• AWS_ASSUMEROLE_ACCOUNT：目标角色所属的AWS账户ID
• AWS_ASSUMEROLE_ROLE：需要切换的角色名称
• AWS_SESSION_TOKEN：（可选，带MFA时需要）会话令牌

运行示例

在EC2（带实例配置文件）或ECS（带任务执行角色）上运行

bash
SQUID_CONFIG_S3_BUCKET=config-files
SQUID_CONFIG_S3_PREFIX=squid squid

本地运行（无需角色切换）

bash
docker run \
  -e SQUID_CONFIG_S3_BUCKET=config-files \
  -e SQUID_CONFIG_S3_PREFIX=squid \
  -e AWS_ACCESS_KEY_ID=ASIAABCDEF00GHI0JK0L \
  -e AWS_SECRET_ACCESS_KEY=xaitooGheiJ4ieBaeshah3omush3Bei3wie6Ahz0 \
  squid

本地运行（带角色切换）

bash
docker run \
  -e SQUID_CONFIG_S3_BUCKET=config-files \
  -e SQUID_CONFIG_S3_PREFIX=squid \
  -e AWS_ACCESS_KEY_ID=ASIAABCDEF00GHI0JK0L \
  -e AWS_SECRET_ACCESS_KEY=xaitooGheiJ4ieBaeshah3omush3Bei3wie6Ahz0 \
  -e AWS_ASSUMEROLE_ACCOUNT=012345678901 \
  -e AWS_ASSUMEROLE_ROLE=s3_read_role squid

本地运行（带MFA的角色切换）

bash
docker run \
  -e SQUID_CONFIG_S3_BUCKET=config-files \
  -e SQUID_CONFIG_S3_PREFIX=squid \
  -e AWS_ACCESS_KEY_ID=ASIAABCDEF00GHI0JK0L \
  -e AWS_SECRET_ACCESS_KEY=xaitooGheiJ4ieBaeshah3omush3Bei3wie6Ahz0 \
  -e AWS_ASSUMEROLE_ACCOUNT=012345678901 \
  -e AWS_ASSUMEROLE_ROLE=s3_read_role \
  -e AWS_SESSION_TOKEN=aw8Gae3thagei6... squid