Cloudflare Tunnel Setup

Some internal services at Datawords HK are accessible through Cloudflare Tunnel. Instead of connecting directly, your traffic goes through Cloudflare's secure network.

This means you can access internal services like our Gitea server from anywhere — no VPN required. You just need to install cloudflared, Cloudflare's tunnel client.

What you need: Just install cloudflared on your machine. No account or login is required — it works automatically.

Services that require Cloudflare Tunnel:

Gitea SSH (git-ssh.datawords.hk) — for pushing/pulling code via SSH

Install cloudflared using the package manager for your operating system:

macOS (Homebrew):

$ brew install cloudflared

Windows (winget):

> winget install --id Cloudflare.cloudflared

Windows (manual download):

Download the latest cloudflared-windows-amd64.msi from the cloudflared releases page and run the installer.

Linux (Debian/Ubuntu):

# Add Cloudflare's GPG key and repository
$ sudo mkdir -p --mode=0755 /usr/share/keyrings
$ curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-main.gpg > /dev/null
$ echo "deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/cloudflared.list

# Install
$ sudo apt update && sudo apt install cloudflared

Check that cloudflared is installed correctly:

$ cloudflared --version
cloudflared version 2025.x.x (built ...)

If you see a version number, you're all set.

Done!

cloudflared is installed. You can now follow individual service guides to configure access. For Gitea SSH access, see the SSH Key Setup Guide.

Problem	Solution
`cloudflared: command not found`	Make sure `cloudflared` is in your PATH. On macOS, run `brew link cloudflared`. On Windows, restart your terminal after installation.
Connection timeout through tunnel	Check your internet connection. Cloudflare Tunnel requires outbound HTTPS access. Corporate firewalls may block it — try a different network.
Permission denied during installation	On Linux, make sure to use `sudo` for apt commands. On macOS, Homebrew should not need sudo.