apply custom rules

[boardmain]

hi i want to call the proxy with custom rules ( not defined into imgproxy.conf )
how i can call it?

for example i have this

/@s3img/_small/KEY.jpp

where @s3img is the s3 source, and _small is the presset
but i want to test antother settings
i can call directly it as

/unsafe/size:640:0:0:0/plain/s3://BUCKETNAME/KEY.jpg@webp

?

[shinsenter]

@boardmain

You need to add your S3 bucket in the $origin_server block of imgproxy.conf:

map $uri $origin_server
{
    default         'local://';

    # your desired path @s3img and the bucket will be here
    ~^/@s3img/      's3://BUCKETNAME';
}

Then in the docker-compose.yml, please uncomment S3 setting lines within environment key:

services:
  imgproxy:
    environment:
      ### External source (S3)
      ### See: https://docs.imgproxy.net/serving_files_from_s3
      IMGPROXY_USE_S3: "true"
      IMGPROXY_S3_REGION: "us-east-2"
      IMGPROXY_S3_ENDPOINT: "<your endpoint>"
      AWS_ACCESS_KEY_ID: "<your id>"
      AWS_SECRET_ACCESS_KEY: "<your key>"

Then start the docker after updating the above settings by running:

docker compose up

Now you can access your image with custom filter on browser by opening:

http://localhost/@s3img/_small/path_to_your_file.jpp

If you want to add your own imgproxy settings, please add extra rules inside the preset_name or imgproxy_preset section of the imgproxy.conf.

For example, I want to add a max640 setting, then I should add these lines:

## **`$preset_name`**
## Parse preset name from requested URI.
map $uri_omitted_origin $preset_name
{
    default '';

    # set the preset name to "max640" when the URI starts with max640
    ~^/max640/  'max640';
}

## **`$imgproxy_preset`**
## Define `imgproxy` options for each preset name.
map $preset_name $imgproxy_preset
{
    default 'size:1600:0:0:0/preset:logo';

    # define custom imgproxy congfig for the preset named "max640"
    max640 'size:640:0:0:0';
}

After restart your docker container, you can access your image with the new filter on browser by opening:

http://localhost/@s3img/max640/path_to_your_file.jpp