Fehlerbehebung

Häufige Probleme und Fehlerbehebung

Überprüfen Sie die Protokolle

Unabhängig davon, welches Problem bei Ihnen auftritt, sollten Sie als Erstes die Protokolle überprüfen. Führen Sie dazu den folgenden Befehl aus:

 logread -f 

Konfigurationen ändern

Im Notfall kann in Cosmos alles über das Terminal geändert werden. Navigieren Sie einfach zu Ihrem Konfigurationsordner (standardmäßig /opt/cosmos-config) und öffnen Sie die Datei cosmos-config.json. Sie können dort beliebige Werte ändern und den Container neu starten, um die Änderungen zu übernehmen.

Probleme mit HTTPS

Es kann vorkommen, dass Ihr Zertifikat nicht automatisch von Let’s Encrypt erneuert wird. Wenn ein solches Problem auftritt, startet Cosmos im HTTP-Modus. Sie können dann Ihre Einstellungen ändern oder alle neu hinzugefügten URLs entfernen, die das Problem verursachen könnten.

Häufige Ursachen hierfür sind:

  • Cosmos oder eine URL in Cosmos verwendet eine Domäne, auf die Sie keine Berechtigung haben, die SSL-Zertifizierung vorzunehmen.
    • Überprüfen Sie alle URL’s auf Tippfehler oder Domains ohne Berechtigung. Der API-Key oder API-Token braucht Schreibberechtigung auf alle verwendeten Domains.
  • Sie haben bei der Konfiguration einen Fehler gemacht (falsches Feld verwendet oder Fehlerhafter API-Key oder API-Token)
    • Überprüfen Sie das Token auf Kopierfehler (z.B. unbewusste Leerschläge oder Zeilenumbrüche mit kopiert)
    • Einige DNS-Anbieter verwenden separiert API-Token oder API-Keys. Prüfen Sie, ob Sie in den Einstellungen das richtige Feld verwenden und Token nicht mit Keys verwechseln.

Anmeldung nicht möglich / Probleme mit der Datenbank

Wenn Sie sich überhaupt nicht anmelden können, obwohl Sie sicher sind, dass Ihre Anmeldedaten korrekt sind, ist es sehr wahrscheinlich, dass Ihre Datenbankkonfiguration fehlerhaft ist. Stellen Sie sicher, dass

  • Ihre Datenbank läuft; Überprüfen Sie die MongoDB-Logs:  docker logs -n 100 $(docker ps | grep -Eo 'cosmos-mongo-[0-9a-zA-Z]{3}') 
  • Ihr Speicher nicht voll ist ( Wenn Ihr Speicher voll ist, kann die Datenbank nicht mehr korrekt ausgeführt werden)
  • Sie die richtige Datenbankkonfiguration in der Konfiguration eingerichtet haben
  • Sie über die richtigen Anmeldedaten für Ihre Datenbank verfügen

Probleme mit Constellation

Wenn Sie Constellation debuggen, überprüfen Sie zuallererst immer die VPN-Protokolle auf der Registerkarte „Constellation“. Die häufigsten Gründe für Verbindungsfehler sind:

  • alte Version: Ihr Client verwendet ein veraltetes Zertifikat. Versuchen Sie, ein Gerät von Grund auf neu anzulegen.
  • Port Forwarding: Ihr Netzwerk hat den Port 4242 nicht an Cosmos weitergeleitet (es muss ein UDP-Port sein!).
  • CG-NAT: Stellen Sie sicher, dass Sie mindestens einen öffentlich zugänglichen Lighthouse in Ihrem Netzwerk haben. Wenn Sie sich hinter einem CGNAT befinden, können Sie ein $5 DigitalOcean-Droplet als Lighthouse verwenden.
  • Sie können nicht zwei VPNs auf demselben Server ausführen. Wenn Sie Wireguard verwenden, müssen Sie dieses zuerst deaktivieren.

Vergessen Sie nicht, die Protokolle des VPNs (sowohl auf der Constellation-Registerkarte als auch auf Ihrem Gerät) auf Details zu überprüfen.

Wenn eine Fehlermeldung angezeigt wird, dass Port 4242 belegt ist, starten Sie Cosmos Cloud neu – das Problem sollte dann behoben sein.

Wenn das Problem weiterhin besteht, führe bitte die üblichen Schritte zur Fehlerbehebung durch:

  • Starten Sie das VPN neu (Registerkarte „Constellation“)
  • Starten Sie Cosmos Cloud neu
  • Starten Sie den Cosmos Cloud Host neu
  • Starten Sie die Client-App auf Ihrem Endgerät neu
  • Verbinden Sie Ihr Gerät von Grund auf neu (löschen Sie das Gerät, erstellen Sie ein neues, verbinden Sie es erneut)