a278753bbf
Jitter is important to avoid every cloudflared in the world trying to reconnect at t=1, 2, 4, etc. That could overwhelm the backend. But if each cloudflared randomly waits for up to 2, then up to 4, then up to 8 etc, then the retries get spread out evenly across time. On average, wait times should be the same (e.g. instead of waiting for exactly 1 second, cloudflared will wait betweeen 0 and 2 seconds). This is the "Full Jitter" algorithm from https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/ |
||
---|---|---|
.mac_resources | ||
.teamcity | ||
buffer | ||
carrier | ||
certutil | ||
cmd/cloudflared | ||
connection | ||
dbconnect | ||
dbconnect_tests | ||
edgediscovery | ||
h2mux | ||
hello | ||
ingress | ||
logger | ||
metrics | ||
origin | ||
overwatch | ||
signal | ||
socks | ||
ssh_server_tests | ||
sshgen | ||
teamnet | ||
tlsconfig | ||
tunneldns | ||
tunnelrpc | ||
tunnelstore | ||
validation | ||
vendor | ||
watcher | ||
websocket | ||
.docker-images | ||
.dockerignore | ||
.gitignore | ||
Dockerfile | ||
LICENSE | ||
Makefile | ||
README.md | ||
RELEASE_NOTES | ||
cfsetup.yaml | ||
cloudflared_man_template | ||
dev.Dockerfile | ||
github_message.py | ||
github_release.py | ||
go.mod | ||
go.sum | ||
jet.yaml | ||
postinst.sh | ||
postrm.sh | ||
wix.json |
README.md
Argo Tunnel client
Contains the command-line client for Argo Tunnel, a tunneling daemon that proxies any local webserver through the Cloudflare network. Extensive documentation can be found in the Argo Tunnel section of the Cloudflare Docs.
Before you get started
Before you use Argo Tunnel, you'll need to complete a few steps in the Cloudflare dashboard. The website you add to Cloudflare will be used to route traffic to your Tunnel.
Installing cloudflared
Downloads are available as standalone binaries, a Docker image, and Debian, RPM, and Homebrew packages. You can also find releases here on the cloudflared
GitHub repository.
- You can install on macOS via Homebrew or by downloading the latest Darwin amd64 release
- Binaries, Debian, and RPM packages for Linux can be found here
- A Docker image of
cloudflared
is available on DockerHub - You can install on Windows machines with the steps here
User documentation for Argo Tunnel can be found at https://developers.cloudflare.com/argo-tunnel/
Creating Tunnels and routing traffic
Once installed, you can authenticate cloudflared
into your Cloudflare account and begin creating Tunnels that serve traffic for hostnames in your account.
- Create a Tunnel with these instructions
- Route traffic to that Tunnel with DNS records in Cloudflare or with a Cloudflare Load Balancer
TryCloudflare
Want to test Argo Tunnel before adding a website to Cloudflare? You can do so with TryCloudflare using the documentation available here.
Deprecated versions
Cloudflare currently supports all versions of cloudflared
. Starting on March 20, 2021, Cloudflare will no longer support versions released prior to 2020.5.1.
All features available in versions released prior to 2020.5.1 are available in current versions. Breaking changes unrelated to feature availability may be introduced that will impact versions released prior to 2020.5.1. You can read more about upgrading cloudflared
in our developer documentation.
Version(s) | Deprecation status |
---|---|
2020.5.1 and later | Supported |
Versions prior to 2020.5.1 | Will no longer be supported starting March 20, 2021 |