+14
Daily
16,601
stars
1,537
forks
143
watchers
334
prs
1,381
issues
204
releases
README
Cloudflare Tunnel client Contains the command-line client for Cloudflare Tunnel, a tunneling daemon that proxies traffic from the Cloudflare network to your origins. This daemon sits between Cloudflare network and your origin (e.g. a webserver). Cloudflare attracts client requests and sends them to you via this daemon, without requiring you to poke holes on your firewall --- your origin can remain as closed as possible. Extensive documentation can be found in the Cloudflare Tunnel section of the Cloudflare Docs. All usages related with proxying to your origins are available under cloudflared tunnel help. You can also use cloudflared to access Tunnel origins (that are protected with cloudflared tunnel) for TCP traffic at Layer 4 (i.e., not HTTP/websocket), which is relevant for use cases such as SSH, RDP, etc. Such usages are available under cloudflared access help. You can instead use WARP client to access private origins behind Tunnels for Layer 4 traffic without requiring cloudflared access commands on the client side. Before you get started Before you use Cloudflare Tunnel, you'll need to complete a few steps in the Cloudflare dashboard: you need to add a website to your Cloudflare account. Note that today it is possible to use Tunnel without a website (e.g. for private routing), but for legacy reasons this requirement is still necessary: 1. Add a website to Cloudflare 2. Change your domain nameservers to Cloudflare 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 To build from source, install the required version of go, mentioned in the Development section below. Then you can run make cloudflared. User documentation for Cloudflare Tunnel can be found at https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/ Creating Tunnels and routing traffic Once installed, you can authenticate cloudflared into your Cloudflare account and begin creating Tunnels to serve traffic to your origins. Create a Tunnel with these instructions Route traffic to that Tunnel: Via public DNS records in Cloudflare Or via a public hostname guided by a Cloudflare Load Balancer Or from WARP client private traffic TryCloudflare Want to test Cloudflare Tunnel before adding a website to Cloudflare? You can do so with TryCloudflare using the documentation available here. Breaking Changes Removal of CLI flags, environment variables, configuration keys, or commands is a breaking change. Such removals must be announced in the Cloudflare Tunnel changelog before the release that removes them. Deprecated ve
Top issues
#23Cloudflared stops resolving DNS.90 comments · 2018-04-24#38Segmentation fault on raspberry pi 2 model b83 comments · 2018-08-01#491grpc support66 comments · 2021-10-22#1300🐛"stream #### canceled by remote with error code 0" connIndex=0 event=1 ingressRule=0 originService=" Started roughly 7/1945 comments · 2024-07-24#632users reporting tunnel failures37 comments · 2022-04-26#253Update fails on raspberry pi - context deadline exceeded32 comments · 2020-10-27#1379🐛context canceled30 comments · 2024-12-27#821How to install cloudflared on Alpine linux?30 comments · 2022-11-23
Latest release
2026.11.0 2026.11.0 2026-11-12SHA256 Checksums: cloudflared-amd64.pkg: 9ebb44efa5f2a2d42541eeec113ca708ee8aa1f693e3b9743cffa6c84541eb65 cloudflared-arm64.pkg: 89cf5f39b64ccecc6f2a53b2cf8ae7b7635a0c5763c53159973caf5add4d6ce0 cloudflared-darwin-amd64.tgz: be6be8d4aa0c3ff66917e265002fc9f702d42eae877edf495143f5b874c424af cloudflared-darwin-arm64.tgz: 97e24268d9704a570fab276293028f3580ae2c7d5d2678621a4809e90f776a5e cloudflared-fips-linux-amd64: f6e96f079de7bfaba8ddccb4a2b3b84ae2863643fbca8834e2d4455b1810f790 cloudflared-fips-linux-amd64.deb: fb1d20d57f395b452a65b378fb186250ebc5812e8f200a9aea7260b5b590a5e9 cloudflared-fips-linu