A Docker image for ngrok, introspected tunnels to localhost. The image is built using Alpine Linux to keep the footprint as small as possible.
The container will tunnel either HTTP or HTTPS traffic by using the HTTPS_PORT or HTTP_PORT environment variables. Either environment variable can be set using the -e flag when running an ngrok container or by using linked containers, which is shown below.
This image is hosted on the Docker index as a trusted build and can be pulled down with:
docker pull fnichol/ngrok
We'll set up a simple HTTP server in a docker container called www:
docker run -v /www --name www_data busybox true
docker run --rm --volumes-from www_data busybox \
/bin/sh -c 'echo "<h1>Yo</h1>" > /www/index.html'
docker run -d -p 80 --volumes-from www_data --name www fnichol/uhttpd
Now we'll link the HTTP server container into an ngrok container to expose the server on the internet:
docker run -d -p 4040 --link www:http --name www_ngrok fnichol/ngrok
To get the *.ngrok.com address, check the container's logs:
docker logs www_ngrok
The ngrok web inspection interface is running on port 4040. To get the exposed port:
docker port www_ngrok 4040
- Source host at GitHub
- Report issues/questions/feature requests on GitHub Issues
Pull requests are very welcome! Make sure your patches are well tested. Ideally create a topic branch for every separate change you make. For example:
- Fork the repo
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add support for feature') - Push to the branch (
git push origin my-new-feature)
Created and maintained by Fletcher Nichol (fnichol@nichol.ca).
MIT (see License.txt)