Cloudflare-Tunnel einrichten

Mit einem Cloudflare-Tunnel ist dein Webpanel sicher aus dem Internet erreichbar — ohne dass du Ports an deinem Router öffnen musst. Cloudflare baut einen Tunnel zwischen sich und deinem Server. Dieser Weg ist kostenlos und für die meisten Self-Hoster die einfachste Internet-Anbindung.

Plane für die komplette Einrichtung etwa 15 Minuten ein.

Voraussetzungen

Ein kostenloser Cloudflare-Account (anmelden unter https://dash.cloudflare.com/sign-up)
Eine Domain, die bei Cloudflare verwaltet wird (siehe Schritt 2, falls noch nicht vorhanden)
VirtueBot ist installiert oder du bist gerade mitten im Setup

Schritt 1 — Bei Cloudflare anmelden

Öffne https://dash.cloudflare.com und melde dich an.

Schritt 2 — Domain bei Cloudflare verwalten lassen (falls noch nicht)

Wenn du noch keine Domain bei Cloudflare hast, gibt es zwei Optionen:

Option A — Bestehende Domain übernehmen (kostenlos)

Im Dashboard auf „Add a Site" klicken.
Domain eingeben → „Continue".
Den Free-Plan wählen → „Continue".
Cloudflare liest deine vorhandenen DNS-Einträge ein.
Du bekommst zwei Nameserver angezeigt (z. B. xyz.ns.cloudflare.com).
Bei deinem aktuellen Domain-Anbieter die Nameserver auf diese zwei umstellen. Wie das geht, ist je nach Anbieter unterschiedlich — schau in dessen Hilfe nach „Nameserver ändern".
Cloudflare prüft alle 1–2 Stunden, ob die Umstellung durch ist. Wenn ja, bekommst du eine Bestätigungs-Email.

Option B — Neue Domain direkt bei Cloudflare

Im linken Menü auf „Registrar" klicken.
Eine freie Domain suchen und bestellen.

Cloudflare verkauft Domains zum Großhandelspreis ohne Aufschlag.

Schritt 3 — Zero Trust öffnen

Im Cloudflare-Dashboard im linken Menü ganz unten auf „Zero Trust" klicken.
Beim ersten Mal wirst du gebeten, einen Team-Namen festzulegen. Wähle etwas, das du wiedererkennst — z. B. deinen Vornamen oder deinen Discord-Server-Namen.
Wähle den Free-Plan und bestätige.

Du landest auf dem Zero-Trust-Dashboard.

Schritt 4 — Tunnel anlegen

Im linken Menü auf „Networks" → „Tunnels" klicken.
„Create a tunnel" klicken.
Als Connector-Typ „Cloudflared" auswählen → „Next".
Tunnel-Namen vergeben (z. B. virtuebot) → „Save tunnel".

Schritt 5 — Tunnel-Token kopieren

Du landest auf einer Seite mit Installations-Anweisungen für verschiedene Betriebssysteme. Wir brauchen nur den Token.

Wähle als Betriebssystem „Docker" (oder ein beliebiges anderes — wir nehmen nur den Token).
In der angezeigten Befehlszeile findest du einen langen Wert hinter --token. Das ist dein Tunnel-Token.
Kopiere ihn komplett.

Beispiel (gekürzt):

docker run cloudflare/cloudflared:latest tunnel --no-autoupdate run --token eyJhIjoi.....

Alles nach --token ist der Wert, den du brauchst.

Wichtig: Wenn du den Token später verlieren solltest, kannst du im Tunnel-Detail unten auf „Refresh" klicken und einen neuen erzeugen. Der alte ist dann nicht mehr gültig.

Schritt 6 — Öffentliche Adresse vergeben

Auf derselben Tunnel-Seite gibt es weiter unten den Bereich „Public Hostnames".

Auf „Add a public hostname" klicken.
Subdomain: Name unter dem dein Panel erreichbar sein soll (z. B. virtuebot).
Domain: deine Cloudflare-Domain auswählen.
Path: leer lassen.
Service Type: HTTP.
URL: localhost:3000 → das ist die Adresse, an der VirtueBot auf deinem Server lauscht. Falls du beim Setup einen anderen Port wegen Konflikten gewählt hast (z. B. 3001), nimm den entsprechend.
Unten auf „Save tunnel" klicken.

Die vollständige Adresse, unter der dein Panel später erreichbar sein wird, lautet dann z. B. https://virtuebot.deine-domain.de. Notiere sie dir — du brauchst sie gleich in Schritt 7 und 8.

Schritt 7 — Token und Adresse im VirtueBot-Setup eintragen

Jetzt hast du beide Werte, die der Installer braucht:

Tunnel-Token (aus Schritt 5)
Öffentliche URL (aus Schritt 6, z. B. https://virtuebot.deine-domain.de)

Bei einer neuen Installation

Während des Installer-Laufs wählst du in der Konfigurations-Phase den Modus 2 (Cloudflare-Tunnel) und gibst beide Werte ein. Fertig.

Bei einer bestehenden Installation

Lass den Installer einfach noch einmal laufen:

curl -fsSL https://get.virtuebot.eu/install.sh | sudo bash

In der Konfigurations-Phase wähle 2 und gib die beiden Werte ein. Deine bestehenden Daten bleiben unberührt.

Schritt 8 — Redirect-URL im Discord Developer Portal eintragen

Damit Discord-Logins funktionieren, muss die neue Adresse als Redirect im Discord Developer Portal stehen:

Öffne https://discord.com/developers/applications und wähle deine VirtueBot-App.
Links auf „OAuth2" → bei „Redirects" auf „Add Another".

Trage ein:

https://virtuebot.deine-domain.de/api/auth/callback/discord

(mit deiner echten Domain aus Schritt 6).

„Save Changes" unten klicken.

Die bisherige Redirect-URL (z. B. http://localhost:3000/...) darfst du stehen lassen — Discord erlaubt mehrere.

Schritt 9 — Testen

Öffne im Browser deine neue Adresse: https://virtuebot.deine-domain.de.
Du landest auf der Anmelde-Seite des Panels.
Klick auf „Anmelden" und logg dich mit Discord ein.

Wenn du danach dein Panel siehst, ist der Tunnel komplett eingerichtet.

Was, wenn etwas nicht klappt?

Cloudflare zeigt eine Fehlerseite („Error 1033" oder ähnlich):

Der Tunnel-Dienst auf deinem Server läuft noch nicht. Führe virtuebot logs aus und schau, ob der Tunnel-Eintrag Fehler meldet.
Prüfe, ob der Tunnel-Token korrekt eingetragen ist. Bei Tippfehler: Installer noch einmal laufen lassen und Token neu eingeben.

„Bad Gateway" beim Aufruf:

Die Public-Hostname-Konfiguration im Cloudflare-Dashboard zeigt nicht auf den richtigen Port. Vergleich nochmal mit Schritt 6.

Login schlägt fehl, du landest auf einer Fehlerseite:

Die Redirect-URL im Discord Developer Portal stimmt nicht mit deiner Tunnel-Adresse überein. Vergleich nochmal mit Schritt 8.
Achte auf Groß-/Kleinschreibung und auf das https:// vorne.

Weitere Hilfe: Troubleshooting.

Tunnel später ändern oder ausschalten

Subdomain wechseln: im Cloudflare-Dashboard unter dem Tunnel den Public-Hostname-Eintrag bearbeiten und im Discord Developer Portal die neue Redirect-URL ergänzen.

Tunnel komplett ausschalten: Installer noch einmal laufen lassen und Modus 1 (Lokal) wählen. Den Tunnel im Cloudflare-Dashboard kannst du danach manuell löschen (Tunnel öffnen → unten auf „Delete").