tinfoil-knight / gargoyle

HTTP Web Server w/ Reverse Proxy & File Server

gargoyle

HTTP Web Server

Features

• Reverse Proxying
  • Load Balancing
  • Active Healthchecks
• File Server
  • Browsing Directories
  • Serving Static Sites
• HTTP Response Header Modification
• Authentication
  • Basic HTTP Auth
  • Key Auth
• Optional TLS Support
• URL Rewrites

Getting Started

Pre-requisites

• Go >= 1.18
• GNU Make

Configuration

• See CONFIG.md

Build from Source

After cloning the repo, run

make build

This will create a binary in the bin directory.

Usage

./gargoyle <optional path to config file>

Default config file path: ./config.json

Author

• Kunal Kundu - @tinfoil-knight

License

Distributed under the MIT License. See LICENSE for more information.

Acknowledgements

• Blog Posts & Documentation from
  • Caddy
  • Nginx
• Learning Centers
  • Cloudflare
  • Kong
• Talk on "Building a proxy server in Golang" by @mauricio