cloudflare/cloudflaredClient für Cloudflare Tunnel, der sichere, reine ausgehende Verbindungen zu Origins über eine Zero-Trust-Architektur ermöglicht. Unterstützt HTTP-, WebSocket-, SSH- und RDP-Datenverkehr ohne Firewall-Änderungen und bietet Zugriffskontrolle und Authentifizierung.
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 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:
cloudflared installierenDownloads 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.
cloudflared ist auf DockerHub verfügbarmake cloudflared ausführen.Benutzerdokumentation für Cloudflare Tunnel findest du unter https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/
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.
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.
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.
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.
Um cloudflared lokal zu bauen, führe make cloudflared aus
Um die Tests lokal auszuführen, führe make test aus
Um den Code zu formatieren und eine gute Codequalität beizubehalten, verwende make fmt und make lint
Nach Änderungen an Interfaces musst du möglicherweise die Mocks neu generieren, also führe make mocks aus
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.