idealo/aws-signing-proxy

AWS Signing Proxy 镜像文档

镜像概述

AWS Signing Proxy 是一个透明代理工具，能够接收HTTP请求，自动对请求进行AWS签名处理，并将签名后的请求转发至目标AWS服务。该镜像旨在简化客户端与AWS服务的交互，无需客户端直接实现复杂的AWS签名逻辑。

核心功能与特性

• 透明请求转发：无需修改客户端代码，直接转发HTTP请求至AWS服务
• 自动AWS签名：支持AWS Signature v4签名算法，自动处理请求签名
• 灵活配置：通过环境变量配置AWS凭证、目标服务端点等参数
• 轻量级设计：基于Go语言开发，镜像体积小，性能高效
• 广泛兼容性：支持所有需要AWS签名的AWS服务（如S3、DynamoDB、EC2等）

使用场景

• 客户端无法直接实现AWS签名逻辑的场景
• 需要在不修改现有客户端代码的情况下添加AWS认证
• 开发环境中简化AWS服务访问流程
• 第三方应用需要安全访问AWS服务但无法管理AWS凭证时

使用方法与配置说明

环境变量配置

Docker Run 示例

bash
docker run -d \
  -p 8080:8080 \
  -e AWS_ACCESS_KEY_ID="your-aws-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-aws-secret-key" \
  -e AWS_REGION="us-east-1" \
  -e TARGET_URL="https://s3.us-east-1.amazonaws.com" \
  idealo/aws-signing-proxy

Docker Compose 示例

yaml
version: '3'
services:
  aws-signing-proxy:
    image: idealo/aws-signing-proxy
    ports:
      - "8080:8080"
    environment:
      - AWS_ACCESS_KEY_ID=your-aws-access-key
      - AWS_SECRET_ACCESS_KEY=your-aws-secret-key
      - AWS_REGION=us-east-1
      - TARGET_URL=https://dynamodb.us-east-1.amazonaws.com
      - FORWARD_HOST_HEADER=true
    restart: always

使用流程

1. 启动代理容器并配置必要环境变量
2. 将客户端请求发送至代理服务（默认端口8080）
3. 代理自动对请求进行AWS签名处理
4. 签名后的请求被转发至TARGET_URL指定的AWS服务
5. AWS服务响应通过代理返回给客户端

注意事项

• 生产环境中不应启用SKIP_SSL_VERIFY
• 确保AWS凭证具有访问目标服务的适当权限
• 对于需要特定Host头的AWS服务，可设置FORWARD_HOST_HEADER=true
• 代理不修改请求体内容，仅处理签名相关的HTTP头