Skip to content
This repository has been archived by the owner on Mar 22, 2022. It is now read-only.

Latest commit

 

History

History
63 lines (49 loc) · 1.84 KB

README.md

File metadata and controls

63 lines (49 loc) · 1.84 KB

cdn-origin

Simple but quick Golang webserver that serves requests to get files and redirects from PostgreSQL.

Features

  • Serves files, short URLs and "tombstones" (deleted file markers)
  • Allows for URL previewing on short URLs (add ?preview)
  • Allows for thumbnail generation on images via external thumbnailer service (if enabled, add ?thumbnail)
  • Can be configured to store generalized metrics

Requirements

  • PostgreSQL server with objects table
  • Access to the folder where the files are stored
  • If metrics support is desired, you will need an Elasticsearch server setup as noted below
  • If thumbnail support is desired, you will need a webserver with an endpoint that returns a thumbnail from raw POSTed image data (jpeg, gif, png, webp) such as thumbnail-service. We recommend that the service outputs 200x200 (max) JPEG images

Usage

$ git clone https://owo.codes/whats-this/cdn-origin.git
$ cd cdn-origin
$ cp config.sample.toml config.toml
$ vim config.toml
$ go build main.go
$ ./main --config-file "./config.toml"

Metrics

If metrics.enable is true, request metadata will be indexed in the provided Elaticsearch server in the following format:

{
  "country_code": keyword,
  "hostname":     keyword,
  "object_type":  keyword,
  "status_code":  short,
  "@timestamp":   date // generated from `@timestamp` pipeline
}

The index and @timestamp pipeline are created automatically if cdn-origin has permission. Alternatively, the mapping and pipeline can be created by other means using the .json files in lib/metrics/.

TODO

  • OPTIONS/HEAD support
  • Write tests

License

cdn-origin is licensed under the MIT license. A copy of the MIT license can be found in LICENSE.