A Docker image for ngrok v2, introspected tunnels to localhost. The idea was originally inspired by the wernight/ngrok image.
- Small: Built using busybox.
- Simple: Just link as
httporhttpsin most cases, see below; exposes ngrok server4040port. - Secure: Runs as non-root user with a random UID
6737(to avoid mapping to an existing UID).
Supposing you've an Apache or Nginx Docker container named web listening on port 8080:
$ docker run --rm -it --link web oanhnn/ngrok ngrok http web:8080To see command-line options, run docker run --rm oanhnn/ngrok ngrok --help.
| Environment variable | Note |
|---|---|
NGROK_AUTH |
Authentication key for your Ngrok account. This is needed for custom subdomains, custom domains, and HTTP authentication |
NGROK_HOSTNAME |
Paying Ngrok customers can specify a custom domain. Only one subdomain or domain can be specified, with the domain taking priority |
NGROK_SUBDOMAIN |
Name of the custom subdomain to use for your tunnel. You must also provide the authentication token |
NGROK_REMOTE_ADDR |
Name of the reserved TCP address to use for a TCP tunnel. You must also provide the authentication token |
NGROK_USERNAME |
Username to use for HTTP Basic authentication on the tunnel. You must also specify an authentication token |
NGROK_PASSWORD |
Password to use for HTTP Basic authentication on the tunnel. You must also specify an authentication token |
NGROK_PROTOCOL |
Can either be HTTP or TCP, and it defaults to HTTP if not specified. If set to TCP, Ngrok will allocate a port instead of a subdomain and proxy TCP requests directly to your application |
NGROK_PORT |
Port to expose (defaults to 80 for HTTP protocol). If the server is non-local, the hostname can also be specified, e.g. 192.168.0.102:80 |
NGROK_REGION |
Location of the ngrok tunnel server; can be us (United States, default), eu (Europe), ap (Asia/Pacific) or au (Australia) |
NGROK_HEADER |
|
NGROK_DEBUG |
If specified, container will show output to stdout |
NGROK_LOOK_DOMAIN |
This is the domain name referred to by ngrok. (default: localhost) |
NGROK_BINDTLS |
Toggle tunneling only HTTP or HTTPS traffic. When true, Ngrok only opens the HTTPS endpoint. When false, Ngrok only opens the HTTP endpoint |
All code contributions must go through a pull request and approved by a core developer before being merged. This is to ensure proper review of all the code.
Fork the project, create a feature branch, and send a pull request.
If you would like to help take a look at the list of issues.
This project is released under the MIT License.
Copyright © Oanh Nguyen
Please see License File for more information.