Aigis

A simple and configurable content proxy.

Note

Aigis is a hobby project, is not considered production ready, and has an unstable API. Anything about it, including features and functionality, is subject to change until stablised. This project is designed with my own infrastructure and needs in mind, and may not be a perfect fit for yours. Be sure to look at other options such as imageproxy or ImageWizard.

Features

• Content transformations via query parameters.
  • Image format and size.
• Request caching that respects Cache-Control headers.
• Content-Type allow-list with wildcard support.
• 'Embed' endpoint that turns OpenGraph meta tags into JSON.
• Subdomain wildcard support for --proxy-allowed-domains.

Installing

Docker

An official Docker image is published to GHCR upon every release and is the recommended way to run the server.

Assuming you have Docker or another container tool installed locally simply run the following (replace <tag> with the version you would like to use).

docker run --name aigis -p 3005:3005 ghcr.io/blooym/aigis:<tag>

Cargo

Assuming you already have Cargo installed locally you can simply run following to compile the binary yourself:

cargo install aigis

Configuration

Aigis is configured via command-line flags or environment variables and has full support for configuration information from.env files. Below is a list of all supported configuration options. You can also run aigis --help to get up-to-date help including default values.