Skip to content

Acts as ACME challenge proxy. Deploy Let's Encrypt certificates in networks with split DNS.

License

Notifications You must be signed in to change notification settings

JoelLinn/acme-proxy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ACME Proxy

Forward ACME challenge requests to local clients. Clients on the intranet with valid local dns entries can request certs using standard acme tools.

Breaking Changes

ACME_DOMAINS has been renamed to ACME_LEGAL_HOSTS to match command line argument.

Configuration

Make sure your docker host uses the intranet dns server for name resolution.

By default, all domains are allowed. You should limit this to the domain prefixes used on the intranet to not leak requests. The environment variable ACME_LEGAL_HOSTS holds a regex to filter incomming requests with.

ACME_LEGAL_HOSTS matches
.* any string/domain (default)
^intra\.example\.com$ exactly intra.example.com
(\.i\.example\.com)$|(\.iana\.org)$ any subdomain under i.example.com or any subdomain under iana.org

Keep in mind that a regex like iana\.org$ also matches a domain like whateverisinfrontiana.org, so better use something like (\.|^)iana.org$ in that case.

The timeout for the proxied acme token requests can be set in milliseconds using the ACME_TIMEOUT variable.

Starting

Change 8888 to the port you want your firewall/gateway to forward requests to

docker run -p 8888:8080 -e ACME_LEGAL_HOSTS="(\.i\.example\.com)$" -d joellinn/acme-proxy

About

Acts as ACME challenge proxy. Deploy Let's Encrypt certificates in networks with split DNS.

Resources

License

Stars

Watchers

Forks

Packages

No packages published