neemuchaordic/aws-ecr-proxy

AWS ECR***代理镜像

镜像概述

本镜像基于官方nginx alpine镜像构建，提供AWS ECR（亚马逊弹性容器注册表）的***代理服务，可自动每6小时更新AWS访问令牌，帮助用户无需直接配置AWS凭证即可访问ECR仓库。

核心功能

1. 实现AWS ECR仓库的***代理访问
2. 自动每6小时刷新AWS访问令牌
3. 支持通过环境变量或AWS CLI配置文件（~/.aws/config）提供AWS凭证
4. 支持自定义SSL证书配置

使用场景

1. 需要***访问AWS ECR仓库的场景
2. 简化团队或服务对ECR仓库的访问配置，避免每个客户端单独配置AWS凭证
3. 在Kubernetes等容器编排环境中统一管理ECR访问代理

配置说明

必要环境变量

• AWS_KEY：AWS访问密钥ID
• AWS_SECRET：AWS秘密访问密钥
• REGION：AWS区域（若在AWS实例上且未声明，将从IAM自动发现）

可选环境变量

• RENEW_TOKEN：令牌更新间隔，默认值为6h

配置文件方式

可通过挂载~/.aws/config文件提供凭证，文件格式需包含：

[default]
region = 你的AWS区域
aws_access_key_id = 你的AWS访问密钥ID
aws_secret_access_key = 你的AWS秘密访问密钥

部署示例

Docker Run

无SSL配置

bash
docker run -e AWS_SECRET='你的AWS秘密访问密钥' \
-e AWS_KEY='你的AWS访问密钥ID' \
-e REGION='你的AWS区域' \
-d docker.xuanyuan.run/catalinpan/aws-ecr-proxy

注：需添加不安全注册表URL或使用带有效SSL证书的负载均衡器，详情见https://docs.docker.com/registry/insecure/

带自定义SSL证书

bash
docker run -e AWS_SECRET='你的AWS秘密访问密钥' \
-e AWS_KEY='你的AWS访问密钥ID' \
-e REGION='你的AWS区域' \
-v `pwd`/你的证书.key:/etc/nginx/ssl/default.key:ro \
-v `pwd`/你的证书.crt:/etc/nginx/ssl/default.crt:ro \
-d docker.xuanyuan.run/catalinpan/aws-ecr-proxy

带AWS CLI配置文件

bash
docker run -v ~/.aws:/root/.aws:ro \
-v `pwd`/你的证书.key:/etc/nginx/ssl/default.key:ro \
-v `pwd`/你的证书.crt:/etc/nginx/ssl/default.crt:ro \
-d docker.xuanyuan.run/catalinpan/aws-ecr-proxy

Kubernetes部署

提供的Kubernetes配置包含健康检查，需配置有效SSL证书或部署在带有效SSL的负载均衡器后方，可将AWS配置和SSL证书作为Secret管理。

SSL说明

镜像内置证书仅用于启动nginx，建议生成自签名证书、使用有效SSL证书或通过负载均衡器提供SSL支持。自签名证书生成命令：

bash
openssl req -x509 -nodes -days 3650 -newkey rsa:2048 -keyout default.key -out default.crt