https://github.com/jakejarvis/docker-cloudflare-argo

An intermediary between Cloudflare's Argo tunneling service and your local containers/network.
https://github.com/jakejarvis/docker-cloudflare-argo

cloudflare cloudflare-argo docker network tunnel

Last synced: 2 months ago
JSON representation

An intermediary between Cloudflare's Argo tunneling service and your local containers/network.

• Host: GitHub
• URL: https://github.com/jakejarvis/docker-cloudflare-argo
• Owner: jakejarvis
• License: mit
• Created: 2019-03-21T17:05:13.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2021-11-26T21:44:08.000Z (about 3 years ago)
• Last Synced: 2024-10-04T13:18:17.304Z (3 months ago)
• Topics: cloudflare, cloudflare-argo, docker, network, tunnel
• Language: Dockerfile
• Homepage: https://hub.docker.com/r/jakejarvis/cloudflare-argo
• Size: 8.79 KB
• Stars: 23
• Watchers: 3
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# docker-cloudflare-argo

[![CI](https://github.com/jakejarvis/docker-cloudflare-argo/actions/workflows/ci.yml/badge.svg)](https://github.com/jakejarvis/docker-cloudflare-argo/actions/workflows/ci.yml)

![Docker Pulls](https://img.shields.io/docker/pulls/jakejarvis/cloudflare-argo.svg)

A Docker image designed to be an intermediary between your local containers (or anything on your local network) and [Cloudflare's Argo tunneling service](https://www.cloudflare.com/products/argo-tunnel/).

(AKA: A fantastic way to avoid exposing your containers **and** your host to the scary, scary world.)

## Prerequisites

Registration for Argo is done through the [Cloudflare dashboard](https://dash.cloudflare.com/) (it currently costs $5/month).

And, for now, a certificate file (`.pem`) [needs to be obtained via `cloudflared tunnel login`](https://developers.cloudflare.com/argo-tunnel/quickstart/#step-3-login-to-your-cloudflare-account) *before* using the container. This can be done on any computer.

## Configuration

The following environment variables are required:

- `TUNNEL_HOSTNAME`: The hostname/subdomain of the public-facing zone registered with Cloudflare

- `TUNNEL_URL`: The backend URL server you want to dig the tunnel to, probably on your local/Docker network

...and your `.pem` file (the login certificate from Cloudflare) needs to be mounted to `/etc/cloudflared/cert.pem` on the Argo container, as shown in the example.

## Usage

```bash

docker run -d \

           -e "TUNNEL_HOSTNAME=mytunnel.jarv.is" \

           -e "TUNNEL_URL=http://localhost:8080" \

           -v "/Users/jake/config/cert.pem:/etc/cloudflared/cert.pem" \

           jakejarvis/cloudflare-argo:latest

```

If building locally, a [`cloudflared` version](https://github.com/cloudflare/cloudflared/releases) can be specified as a build-time argument (e.g. `2021.10.11`; defaults to `latest`):

```bash

docker build --build-arg CLOUDFLARED_VERSION=2021.10.5 .

```

## License

MIT