Zugriffsmodi

VirtueBot kann auf drei Arten erreichbar gemacht werden — von „nur in meinem Heimnetz" bis „von überall im Internet". Du wählst beim Setup, welcher Modus zu dir passt. Wechseln geht später auch jederzeit (siehe Abschnitt unten).

Die drei Modi im Vergleich

Modus 1 — Lokal (Standard)

Das Webpanel ist nur in deinem Heim- oder Firmennetz erreichbar. Niemand von außen kann darauf zugreifen.

Geeignet, wenn:

• du den Bot allein oder mit Personen im selben WLAN nutzt
• du keine externe Erreichbarkeit brauchst
• dein Server ohnehin nur intern läuft

Wie es aussieht:

• Panel-Adresse: http://localhost:3000 (auf dem Server selbst) oder http://<server-ip>:3000 (von einem anderen Gerät im Heimnetz)

Beim Setup: wähle bei der Zugriffsmodus-Frage 1.

Modus 2 — Cloudflare-Tunnel (Empfehlung für die meisten)

Das Webpanel ist über eine sichere Cloudflare-Adresse aus dem Internet erreichbar. Cloudflare baut einen Tunnel zwischen dir und deinem Server — du musst keine Ports an deinem Router öffnen.

Geeignet, wenn:

• du von unterwegs aufs Panel zugreifen willst
• mehrere Personen aus verschiedenen Netzen das Panel nutzen
• du keine eigene Domain hast oder keine DNS-Einträge selbst pflegen willst

Was du brauchst:

• Einen kostenlosen Cloudflare-Account
• Eine Domain bei Cloudflare verwaltet (Cloudflare bietet kostenlos welche an, du kannst auch eine bestehende übertragen)
• Einen Tunnel-Token, den du im Cloudflare-Dashboard erzeugst

Vorteile:

• HTTPS automatisch aktiv (Cloudflare kümmert sich um die Zertifikate)
• Schutz gegen Überlastungs-Angriffe inklusive
• Tunnel funktioniert hinter jedem Router, auch ohne öffentliche IP

Beim Setup: wähle 2. Die komplette Schritt-für-Schritt-Anleitung findest du unter Cloudflare-Tunnel einrichten.

Modus 3 — Eigene Domain mit Reverse Proxy

Du nutzt eine eigene Domain (z. B. virtuebot.deine-seite.de) und hast schon Erfahrung mit Server-Konfiguration. Ein Reverse Proxy (z. B. Caddy oder nginx) nimmt die Verbindung von außen entgegen, sorgt für HTTPS und leitet an den Bot weiter.

Geeignet, wenn:

• du eine eigene Domain hast und sie nutzen willst
• du dich mit DNS-Einträgen und Reverse Proxies auskennst
• du volle Kontrolle behalten willst

Was du brauchst:

• Eine Domain mit Möglichkeit, DNS-Einträge zu setzen
• Einen Reverse Proxy auf deinem Server (Caddy holt sich HTTPS automatisch, nginx braucht Let's Encrypt extra)
• Wenn dein Server hinter einem Router steht: Port 80 und 443 weiterleiten

Beim Setup: wähle 3. Die komplette Anleitung findest du unter Eigene Domain mit Reverse Proxy.

Welcher Modus passt zu dir?

• Nur du, nur dein Heimnetz? → Lokal
• Du oder ein paar Freunde wollen von überall aufs Panel? → Cloudflare-Tunnel
• Du hast eine Domain und magst alles selbst machen? → Eigene Domain

Im Zweifel: Cloudflare-Tunnel. Er ist die universellste Lösung, kostet nichts und ist nach 5 Minuten eingerichtet.

Zugriffsmodus später wechseln

Du kannst jederzeit zwischen den Modi wechseln. Der einfachste Weg ist, den Installer noch einmal laufen zu lassen — er erkennt die bestehende Installation und passt nur das an, was du jetzt anders haben willst:

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

In der Konfigurations-Phase wählst du den neuen Modus und gibst die zusätzlichen Daten ein (z. B. den Cloudflare-Tunnel-Token bei Wechsel auf Modus 2). Deine bestehenden Daten und Einstellungen bleiben erhalten.

Wenn du nur die Adresse änderst (z. B. Domain wechseln im Reverse-Proxy-Modus), reicht es, in der Konfigurations-Datei unter /opt/virtuebot/.env den Eintrag AUTH_URL anzupassen und danach virtuebot restart auszuführen.

Wichtig nach jedem Wechsel:

• Im Discord Developer Portal die neue Adresse als Redirect-URL eintragen (siehe Schritt 7 im Discord-Setup).
• Die alte Adresse darfst du dort drin lassen — Discord erlaubt mehrere Redirects.