dockfront

Simple (emulated) CDN server (similar to CloudFront) for Docker with support for S3-like and web origins.

Usage

To launch a container from this image, you must have Docker installed. If already, run the below command:

# proxy a web origin
$ docker run -d --name dockfront -p 8080:80 -e WEB_URL=https://example.com syncloudsoftech/dockfront
# proxy an S3 origin
$ docker run -d --name dockfront -p 8080:80 \
-e ORIGIN_TYPE=s3 \
-e S3_ACCESS_KEY_ID=your_access_key_id \
-e S3_BUCKET=your_bucket_name \
-e S3_ENDPOINT=https://sgp1.digitaloceanspaces.com \
-e S3_REGION=sgp1 \
-e S3_SECRET_ACCESS_KEY=your_secret_access_key

To start/stop the (named) container at a later point in time, use below commnads:

# start "dockfront" named container
$ docker start dockfront
# stop "dockfront" named container
$ docker stop dockfront

Once running, you can access the files using http://127.0.0.1:8080/ as base URL.

docker-compose.yml

To include this container as a service in your existing docker-compose.yml setup, use below definition:

version: '3'services:
dockfront:
image: syncloudsoftech/dockfrontenvironment:
WEB_URL: https://example.comWEB_USER_AGENT: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36'ports:
- '8080:80'

Or if you are using it with MinIO:

version: '3'services:
dockfront:
image: syncloudsoftech/dockfrontenvironment:
ORIGIN_TYPE: s3S3_ACCESS_KEY_ID: dockfrontS3_BUCKET: dockfrontS3_ENDPOINT: http://minio:9091S3_PATH_STYLE_ENDPOINT: 'true'S3_REGION: us-east-1S3_SECRET_ACCESS_KEY: dockfrontports:
- '8080:80'minio:
image: minio/miniocommand: minio server /data/minio --address ":9091" --console-address ":9092"environment:
MINIO_ROOT_USER: dockfrontMINIO_ROOT_PASSWORD: dockfrontports:
- '9091:9091'
- '9092:9092'volumes:
- minio-data:/data/miniovolumes:
minio-data:

Development

Building or modifying the container yourself from source is also quite easy. Just clone the repository and run below command:

$ docker build -t dockfront .

Run the locally built container as follows:

$ docker run -it -p 8080:80 -e WEB_URL=https://example.com dockfront

License

See the LICENSE file.