coopernurse/nginx-s3-proxy

镜像概述

本镜像旨在为dogestry提供服务，通过在服务器与S3之间建立缓存HTTP代理，实现S3资源的一次下载、多次复用，降低S3的访问频率与成本。

核心功能

• 基于Nginx实现S3的HTTP缓存代理
• 支持自定义缓存路径、大小及有效期
• 可配置AWS访问密钥与S3桶信息
• 支持缓存锁机制，避免同一资源重复请求S3

使用场景

• 网站静态资源（图片、文档等）存储在S3时，通过缓存代理提升访问速度
• 需要减少S3 API调用次数，降低云服务成本的场景
• 分布式系统中S3资源的高效共享与访问加速

配置说明

1. 需挂载自定义nginx.conf文件到容器的/nginx.conf路径
2. 可选：将缓存目录绑定到宿主机路径（如/my/path），防止容器重启后缓存丢失
3. 调整nginx.conf中的参数（缓存大小、有效期、S3桶信息等）以适配业务需求

部署示例

基础运行

bash
docker run -p 8000:8000 -v /path/to/nginx.conf:/nginx.conf coopernurse/nginx-s3-proxy

绑定宿主机缓存目录

bash
docker run -p 8000:8000 -v /path/to/nginx.conf:/nginx.conf -v /my/path:/data/cache coopernurse/nginx-s3-proxy

示例nginx.conf配置

nginx
worker_processes 2;
pid /run/nginx.pid;
daemon off;

events {
    worker_connections 768;
}

http {
    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;
    keepalive_timeout 65;
    types_hash_max_size 2048;
    server_names_hash_bucket_size 64;

    include /usr/local/nginx/conf/mime.types;
    default_type application/octet-stream;

    access_log /usr/local/nginx/logs/access.log;
    error_log  /usr/local/nginx/logs/error.log;

    gzip on;
    gzip_disable "msie6";
    gzip_http_version 1.1;
    gzip_types text/plain text/css application/json application/x-javascript text/xml application/xml application/xml+rss text/javascript;

    proxy_cache_lock on;
    proxy_cache_lock_timeout 60s;
    proxy_cache_path /data/cache levels=1:2 keys_zone=s3cache:10m max_size=30g;

    server {
        listen     8000;

        location / {
            proxy_pass https://your-bucket.s3.amazonaws.com;

            aws_access_key your-access-key;
            aws_secret_key your-secret-key;
            s3_bucket your-bucket;

            proxy_set_header Authorization $s3_auth_token;
            proxy_set_header x-amz-date $aws_date;

            proxy_cache        s3cache;
            proxy_cache_valid  200 302  24h;
        }
    }
}

需调整的关键参数：

• proxy_cache_path：修改max_size（缓存最大容量）和路径（若绑定宿主机目录）
• proxy_pass：替换为你的S3桶URL
• aws_access_key/aws_secret_key：填写你的AWS访问密钥
• s3_bucket：替换为你的S3桶名称
• proxy_cache_valid：调整缓存有效期（如24h改为12h）