Cloudflare Tunnel Client

Enthält den Kommandozeilen-Client für Cloudflare Tunnel, einen Tunneling-Daemon, der Datenverkehr vom Cloudflare-Netzwerk zu deinen Ursprüngen weiterleitet. Dieser Daemon sitzt zwischen dem Cloudflare-Netzwerk und deinem Ursprung (z. B. einem Webserver). Cloudflare zieht Client-Anfragen an und sendet sie über diesen Daemon an dich, ohne dass du Löcher in deine Firewall bohren musst --- dein Ursprung kann so geschlossen wie möglich bleiben. Umfangreiche Dokumentation findest du im Cloudflare Tunnel-Abschnitt der Cloudflare-Dokumentation. Alle Verwendungen im Zusammenhang mit dem Proxying zu deinen Ursprüngen sind unter cloudflared tunnel help verfügbar.

Du kannst cloudflared auch verwenden, um auf Tunnel-Ursprünge (die mit cloudflared tunnel geschützt sind) für TCP-Datenverkehr auf Layer 4 (d. h. nicht HTTP/Websocket) zuzugreifen, was für Anwendungsfälle wie SSH, RDP usw. relevant ist. Solche Verwendungen sind unter cloudflared access help verfügbar.

Du kannst stattdessen den WARP-Client verwenden, um auf private Ursprünge hinter Tunneln für Layer-4-Datenverkehr zuzugreifen, ohne dass cloudflared access-Befehle auf der Client-Seite erforderlich sind.

Bevor du beginnst

Bevor du Cloudflare Tunnel verwendest, musst du einige Schritte im Cloudflare-Dashboard abschließen: Du musst eine Website zu deinem Cloudflare-Konto hinzufügen. Beachte, dass es heute möglich ist, Tunnel ohne eine Website zu verwenden (z. B. für privates Routing), aber aus Legacy-Gründen ist diese Anforderung weiterhin erforderlich:

1. Eine Website zu Cloudflare hinzufügen
2. Deine Domain-Nameserver auf Cloudflare umstellen

cloudflared installieren

Downloads sind als eigenständige Binärdateien, ein Docker-Image sowie Debian-, RPM- und Homebrew-Pakete verfügbar. Du findest Releases auch hier im cloudflared-GitHub-Repository.

• Du kannst auf macOS installieren über Homebrew oder durch Herunterladen des neuesten Darwin-amd64-Releases
• Binärdateien, Debian- und RPM-Pakete für Linux findest du hier
• Ein Docker-Image von cloudflared ist auf DockerHub verfügbar
• Du kannst auf Windows-Rechnern mit den Schritten hier installieren
• Um aus dem Quellcode zu bauen, installiere die erforderliche Go-Version, die im Abschnitt Entwicklung unten erwähnt wird. Dann kannst du make cloudflared ausführen.

Benutzerdokumentation für Cloudflare Tunnel findest du unter https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/

Tunnel erstellen und Datenverkehr weiterleiten

Nach der Installation kannst du cloudflared in deinem Cloudflare-Konto authentifizieren und mit dem Erstellen von Tunneln beginnen, um Datenverkehr zu deinen Ursprüngen zu liefern.

• Erstelle einen Tunnel mit diesen Anweisungen
• Leite Datenverkehr zu diesem Tunnel weiter:
  • Über öffentliche DNS-Einträge in Cloudflare
  • Oder über einen öffentlichen Hostnamen, der von einem Cloudflare Load Balancer geleitet wird
  • Oder aus dem privaten Datenverkehr des WARP-Clients

TryCloudflare

Möchtest du Cloudflare Tunnel testen, bevor du eine Website zu Cloudflare hinzufügst? Du kannst dies mit TryCloudflare unter Verwendung der hier verfügbaren Dokumentation tun.

Breaking Changes

Das Entfernen von CLI-Flags, Umgebungsvariablen, Konfigurationsschlüsseln oder Befehlen ist eine Breaking Change. Solche Entfernungen müssen im Cloudflare Tunnel-Changelog vor dem Release, das sie entfernt, angekündigt werden.

Veraltete Versionen

Cloudflare unterstützt derzeit Versionen von cloudflared, die innerhalb eines Jahres nach dem neuesten Release liegen. Breaking Changes, die nicht mit der Verfügbarkeit von Funktionen zusammenhängen, können eingeführt werden und Versionen beeinträchtigen, die vor mehr als einem Jahr veröffentlicht wurden. Mehr über das Aktualisieren von cloudflared kannst du in unserer Entwicklerdokumentation lesen.

Zum Beispiel wird Cloudflare ab Januar 2023 cloudflared Version 2023.1.1 bis cloudflared 2022.1.1 unterstützen.

Entwicklung

Anforderungen

• GNU Make
• capnp
• go >= 1.27
• Optionale Tools:
  • capnpc-go
  • goimports
  • golangci-lint
  • gomocks

Build

Um cloudflared lokal zu bauen, führe make cloudflared aus

Test

Um die Tests lokal auszuführen, führe make test aus

Linting

Um den Code zu formatieren und eine gute Codequalität beizubehalten, verwende make fmt und make lint

Mocks

Nach Änderungen an Interfaces musst du möglicherweise die Mocks neu generieren, also führe make mocks aus

Git Hooks

Um CI-Fehler zu vermeiden, kannst du Pre-Push-Hooks installieren, die vor jedem Push Linting und Tests ausführen:

make install-hooks

Dies konfiguriert git so, dass die Hooks in .githooks/ verwendet werden, die vor jedem Push make fmt-check lint test ausführen.