CADDY_FILE_SERVER

Caddy Image Processor

This repository contains a CaddyServer module for processing images on the fly using libvips.

Features

• Automatic image processing based on URL query parameters
• Supports resizing, rotating, cropping, quality adjustments, format conversion, and more
• Efficient processing using libvips

Prerequisites

• Caddy >= 2.8.0-beta.1 installed on your system
• libvips installed on your system
• libvips-dev installed on your system (only for xcaddy build)

Installation and Configuration

Using Docker

• Pull the Docker image from the GitHub Container Registry:

  docker pull ghcr.io/quix-labs/caddy-image-processor:latest
  

Using xcaddy

• Before building the module, ensure you have xcaddy installed on your system. You can install it using the following command:

  go install github.com/caddyserver/xcaddy/cmd/xcaddy@latest
  

• To build this module into Caddy, run the following command:

  CGO_ENABLED=1 xcaddy build --with github.com/quix-labs/caddy-image-processor
  

  This command compiles Caddy with the image processing module included.

Using prebuilt assets

• You can also install the tool using release assets.

  Download the appropriate package from the Releases page, and then follow the instructions provided for your specific platform.

Usage

Using Docker

docker run -p 80:80 -v $PWD/Caddyfile:/etc/caddy/Caddyfile -d ghcr.io/quix-labs/caddy-image-processor:latest

Your can see more information in the official docker documentation for caddy

Using xcaddy build / prebuilt assets

/path/to/your/caddy run --config /etc/caddy/Caddyfile

Your can see more information in the official documentation for caddy

Example Caddyfile

Using file_server

localhost {
    root /your-images-directory
    file_server
    image_processor
}

Using reverse_proxy

localhost {
    reverse_proxy your-domain.com
    image_processor
}

In this example, all requests undergo processing by the image processor module before being served by the caddy.

Available Query Parameters

Examples

• Resize an image to a width of 400 pixels and a height of 300 pixels:
  • http://example.com/image.jpg?w=400&h=300
• Crop an image to a width of 200 pixels and a height of 150 pixels starting from the top-left corner (x=50, y=50):
  • http://example.com/image.jpg?w=200&h=150&t=50&l=50&crop=true
• Adjust the quality of the image to 80:
  • http://example.com/image.jpg?q=80
• Convert an image to PNG format and apply a Gaussian blur of 5:
  • http://example.com/image.jpg?fm=png&b=5
• Rotate an image by 180 degrees and flip it horizontally:
  • http://example.com/image.jpg?r=180&flop=true
• Apply a color threshold of 0.5 and adjust the brightness to -10:
  • http://example.com/image.jpg?th=0.5&br=-10
• Convert an image to AVIF format with lossless compression:
  • http://example.com/image.jpg?fm=avif&ll=true

Planned Features

The following features are planned for future implementation:

• Sharp compliance: fit,...

Development

To contribute to the development of Caddy Image Processor, follow these steps:

1. Make sure you have Go installed on your system.

2. Clone this repository to your local machine:

   git clone https://github.com/quix-labs/caddy-image-processor.git
   

3. Navigate to the project directory:

4. Install xcaddy if you haven't already:

   go get -u github.com/caddyserver/xcaddy/cmd/xcaddy
   

5. Make your changes in the source code.

6. Run tests to ensure your changes haven't introduced any issues:

   make test
   

7. If tests pass, you can build the project:

   make build
   

8. To run the project in development mode, use the following command:

   make run
   

9. Once you're satisfied with your changes, create a pull request to the main branch of the repository for review.

Credits

• COLANT Alan
• All Contributors

License

The MIT License (MIT). Please see License File for more information.