Cloudflare Tunnel-Client

Enthält den Befehlszeilen-Client für Cloudflare Tunnel, einen Tunnel-Daemon, der Datenverkehr vom Cloudflare-Netzwerk zu Ihren Ursprungsservern weiterleitet. Dieser Daemon sitzt zwischen dem Cloudflare-Netzwerk und Ihrem Ursprungsserver (z. B. einem Webserver). Cloudflare empfängt Client-Anfragen und sendet sie über diesen Daemon an Sie, ohne dass Sie Löcher in Ihre Firewall bohren müssen – Ihr Ursprungsserver kann so geschlossen wie möglich bleiben. Ausführliche Dokumentation finden Sie im Cloudflare Tunnel-Abschnitt der Cloudflare-Dokumentation. Alle Nutzungsmöglichkeiten im Zusammenhang mit der Weiterleitung zu Ihren Ursprungsservern sind unter cloudflared tunnel help verfügbar.

Sie können cloudflared auch verwenden, um Tunnel-Ursprungsserver (die mit cloudflared tunnel geschützt sind) für TCP-Datenverkehr auf Schicht 4 (d. h. nicht HTTP/WebSocket) zu erreichen, was für Anwendungsfälle wie SSH, RDP usw. relevant ist. Solche Nutzungsmöglichkeiten sind unter cloudflared access help verfügbar.

Stattdessen können Sie den WARP-Client verwenden, um ohne cloudflared access-Befehle auf der Client-Seite auf private Ursprungsserver hinter Tunneln für Schicht-4-Datenverkehr zuzugreifen.

Bevor Sie beginnen

Bevor Sie Cloudflare Tunnel verwenden, müssen Sie einige Schritte im Cloudflare-Dashboard ausführen: Sie müssen eine Website zu Ihrem Cloudflare-Konto hinzufügen. Beachten Sie, 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 notwendig:

Installieren von `cloudflared`

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

Sie können es unter macOS installieren über Homebrew oder durch Herunterladen der neuesten Darwin-amd64-Version
Binärdateien, Debian- und RPM-Pakete für Linux finden Sie hier
Ein Docker-Image von cloudflared ist auf DockerHub verfügbar
Sie können es auf Windows-Rechnern mit den Schritten hier installieren
Um aus dem Quellcode zu bauen, installieren Sie die erforderliche Version von go, die im Entwicklungsabschnitt unten erwähnt wird. Führen Sie dann make cloudflared aus.

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

Erstellen von Tunneln und Weiterleiten von Datenverkehr

Nach der Installation können Sie cloudflared bei Ihrem Cloudflare-Konto authentifizieren und beginnen, Tunnel zu erstellen, um Datenverkehr an Ihre Ursprungsserver zu leiten.

Erstellen Sie einen Tunnel mit dieser Anleitung
Leiten Sie Datenverkehr zu diesem Tunnel:
- Über öffentliche DNS-Einträge in Cloudflare
- Oder über einen öffentlichen Hostnamen, gesteuert durch einen Cloudflare Load Balancer
- Oder aus privatem WARP-Client-Datenverkehr

TryCloudflare

Möchten Sie Cloudflare Tunnel testen, bevor Sie eine Website zu Cloudflare hinzufügen? Das können Sie mit TryCloudflare tun, indem Sie die hier verfügbare Dokumentation nutzen.

Veraltete Versionen

Cloudflare unterstützt derzeit Versionen von cloudflared, die innerhalb eines Jahres nach der aktuellsten Veröffentlichung liegen. Es können bahnbrechende Änderungen eingeführt werden, die nichts mit der Verfügbarkeit von Funktionen zu tun haben und sich auf Versionen auswirken, die vor mehr als einem Jahr veröffentlicht wurden. Weitere Informationen zum Upgraden von cloudflared finden Sie in unserer Entwicklerdokumentation.

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

Entwicklung

Anforderungen

Build

Um cloudflared lokal zu erstellen, führen Sie make cloudflared aus

Test

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

Linting

Um den Code zu formatieren und eine gute Codequalität zu gewährleisten, verwenden Sie make fmt und make lint

Mocks

Nach Änderungen an Schnittstellen müssen Sie möglicherweise die Mocks neu generieren. Führen Sie daher make mocks aus

Git Hooks

Um CI-Fehler zu vermeiden, können Sie 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.

cloudflared v2026.8.1

Kategorien