Skip to content

Latest commit

 

History

History
33 lines (25 loc) · 2.02 KB

README.md

File metadata and controls

33 lines (25 loc) · 2.02 KB
Raw

caddy2-gen

Based on https://github.com/Siemko/caddy2-gen but with the goal of not needing a custom-built docker image that bundles caddy and docker-gen, much like the nginx-proxy separate-containers example

See docker-compose.yml for implementation details. The configuration is exactly the same as for https://github.com/Siemko/caddy2-gen because it's based on the same template, with slight adjustments to the upstream selection code (taken from nginx-proxy).

Configuration

Use labels.

The main idea is simple. Every labeled service exposes a virtual.host to be handled. Then, every container represents a single reverse_proxy's to option to serve requests.

Options to configure:

  • virtual.host domain name, don't pass http:// or https://, you can separate them with space,
  • virtual.alias domain alias, e.q. www prefix,
  • virtual.port port exposed by container, e.g. 3000 for React apps in development,
  • virtual.tls-email the email address to use for the ACME account managing the site's certificates,
  • virtual.host.directives set custom Caddyfile directives for the host. These will be inlined into the site block.
  • virtual.host.import include Caddyfile directives for the host from a file on the container's filesystem. See Caddy import.
  • virtual.proxy.matcher have the reverse proxy only match certain paths.
  • virtual.proxy.lb_policy specify load balancer policy, defaults to round_robin.
  • virtual.proxy.directives include any reverse_proxy directives. These will be inlined into the reverse proxy block.
  • virtual.proxy.import include any reverse_proxy directives from a file on the container's filesystem. See Caddy import.
  • virtual.auth.username and
  • virtual.auth.password together provide HTTP basic authentication.

Password should be a string base64 encoded from bcrypt hash. You can use https://bcrypt-generator.com/ with default config and https://www.base64encode.org/.