Erste Schritte mit Anwendungen auf ServerPrism

Dieser Leitfaden führt Sie durch die Einrichtung und Konfiguration Ihrer gewählten selbstgehosteten Anwendung (5e Tools, Owncast, Rathole oder Yarr) auf Ihrem ServerPrism-Server. Er behandelt die Bestellung, die Ersteinrichtung, die Konfiguration und häufige Probleme.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie ein ServerPrism-Konto haben und bereit sind, einen neuen Server bereitzustellen, oder dass Sie einen bestehenden 'Applications'-Server zur Konfiguration bereit haben.

Bestellung auf ServerPrism

1. Wählen Sie einen Plan: Melden Sie sich bei ServerPrism an und wählen Sie einen 'Applications'-Server. Wir empfehlen, mit mindestens 2 GB RAM zu beginnen und bei anspruchsvolleren Anwendungen oder höheren Benutzerlasten auf bis zu 12 GB zu skalieren.
2. Wählen Sie eine Region: Wählen Sie den Serverstandort, der Ihren Hauptbenutzern am nächsten liegt, um eine optimale Leistung zu erzielen.
3. Bereitstellen: Schließen Sie die Bestellung ab. Ihr Server beginnt automatisch mit der Bereitstellung.

Erster Start

Nach der Bestellung beginnt Ihr Server mit der Bereitstellung. Dieser Vorgang dauert in der Regel einige Minuten. Sie können den Status über das ServerPrism-Panel unter https://serverprism.com/dashboard überwachen. Sobald der Serverstatus 'Running' anzeigt und Sie in der Konsole sehen, dass die Anwendung gestartet wurde, ist er bereit.

Verbinden / Benutzer einladen

Die Methode zum Verbinden mit Ihrer Anwendung hängt davon ab, welche Sie bereitgestellt haben:

• 5e Tools: Greifen Sie über die IP-Adresse und den Port des Servers auf Ihre Instanz zu (z.B. http://YOUR_SERVER_IP:PORT). Der Standardport ist für Webanwendungen normalerweise 80 oder 8080. Überprüfen Sie den 'Startup'-Tab in Ihrem ServerPrism-Panel auf die Variable APP_PORT, falls diese konfigurierbar ist.
• Owncast: Ihre Owncast-Instanz ist über http://YOUR_SERVER_IP:PORT zugänglich. Der Standardport für Owncast ist 8080. Sie können auch eine benutzerdefinierte Domain oder ServerPrism-Subdomain für einen einfacheren Zugriff konfigurieren.
• Rathole: Rathole ist ein Reverse-Proxy. Die Verbindung beinhaltet die Konfiguration von Clients, um über Rathole eine Verbindung zu Ihren internen Diensten herzustellen. Dies erfordert die Einrichtung von Ratholes server.toml und Client-Konfigurationen. Es hat keine direkte Weboberfläche für Benutzer.
• Yarr: Greifen Sie über http://YOUR_SERVER_IP:PORT auf Ihre Yarr-Instanz zu. Der Standardport ist typischerweise 8080.

Um den Zugriff zu erleichtern, können Sie Ihrem Server über Ihr ServerPrism-Dashboard eine kostenlose Subdomain zuweisen.

Grundlagen der Konfiguration

Die Konfiguration für jede Anwendung erfolgt typischerweise über Umgebungsvariablen im Startup-Tab des ServerPrism-Panels oder durch Bearbeiten spezifischer Konfigurationsdateien über den File Manager oder SFTP.

5e Tools

• Datenspeicherung: 5e Tools verwendet eine lokale Datenbank. Die Konfiguration ist minimal. Einstellungen für Datenpfade finden Sie bei Bedarf normalerweise in den Startup-Variablen.
• Zugriff: Stellen Sie sicher, dass die Variable APP_PORT im Startup-Tab mit dem Port übereinstimmt, auf den Sie zugreifen möchten.

Owncast

• Konfigurationsdatei: Owncast verwendet hauptsächlich config.yaml, die sich im Datenverzeichnis der Anwendung befindet. Sie können diese über den File Manager bearbeiten.
• Admin-Zugriff: Wenn Sie Owncast zum ersten Mal aufrufen, werden Sie aufgefordert, ein Administratorkonto zu erstellen. Hier legen Sie Ihren Stream-Key und andere Einstellungen fest.
• Startup-Variablen: Überprüfen Sie den Startup-Tab auf OWNCAST_DATABASE_PATH, OWNCAST_DATA_PATH oder OWNCAST_PORT, um Datenpfade oder Listening-Ports anzupassen.

Rathole

• Konfigurationsdatei: Rathole benötigt eine server.toml-Datei. Diese Datei definiert die Listening-Ports und die Dienste, die sie proxyt. Sie müssen diese Datei bearbeiten, damit Rathole funktioniert.
  • Beispiel server.toml (Bearbeitung über den File Manager):

  [server]
  bind_addr = "0.0.0.0:8000" # Server listening port
  
  [server.services.my_service]
  type = "tcp"
  token = "your_secret_token"
  bind_addr = "0.0.0.0:2222" # Port clients connect to
  remote_addr = "127.0.0.1:22" # Internal service Rathole forwards to
  

• Tokens: Stellen Sie sicher, dass der token in server.toml mit der Client-Konfiguration für eine sichere Verbindung übereinstimmt.

Yarr

• Konfiguration: Die Konfiguration von Yarr wird oft über Umgebungsvariablen oder eine config.json-Datei verwaltet. Überprüfen Sie den Startup-Tab auf Variablen wie YARR_PORT, YARR_DATABASE_PATH oder YARR_ADMIN_EMAIL.
• Ersteinrichtung: Wenn Sie Yarr zum ersten Mal aufrufen, müssen Sie möglicherweise einen Ersteinrichtungsassistenten durchlaufen, um einen Administratorbenutzer zu erstellen und grundlegende Einstellungen zu konfigurieren.

Häufige Probleme

1. Anwendung startet nicht: Überprüfen Sie die Serverkonsole im ServerPrism-Panel auf Fehlermeldungen. Fehlende Konfigurationsdateien, falsche Umgebungsvariablen oder Portkonflikte sind häufige Ursachen. Stellen Sie sicher, dass alle erforderlichen Dateien vorhanden und korrekt formatiert sind.
2. Weboberfläche nicht zugänglich:
   • Vergewissern Sie sich, dass die Anwendung läuft und auf dem erwarteten Port (z.B. 8080) lauscht.
   • Überprüfen Sie die Firewall-Regeln Ihres Servers (ServerPrism übernimmt dies normalerweise, aber stellen Sie sicher, dass Ihre Anwendung nicht versucht, einen nicht standardmäßigen, blockierten Port zu verwenden).
   • Bestätigen Sie, dass Sie die richtige IP-Adresse und den richtigen Port in Ihrem Browser verwenden. Wenn Sie eine Domain verwenden, stellen Sie sicher, dass DNS korrekt auf Ihre Server-IP verweist.
3. Rathole-Client verbindet sich nicht: Überprüfen Sie nochmals, ob der token in Ihrer server.toml mit der Client-Konfiguration übereinstimmt. Stellen Sie sicher, dass der bind_addr für den Dienst in server.toml korrekt konfiguriert und zugänglich ist.
4. Langsame Leistung: Wenn Ihre Anwendung langsam läuft, sollten Sie ein Upgrade Ihres Serverplans für mehr RAM oder CPU in Betracht ziehen. Dies können Sie über Ihr ServerPrism-Kunden-Dashboard tun.

Wenn Sie auf anhaltende Probleme stoßen, sammeln Sie Ihre Server-ID und die relevanten Protokollausgaben aus der Konsole und öffnen Sie ein Support-Ticket unter https://serverprism.com/tickets.

Nächste Schritte

• Benutzerdefinierte Domains: Für eine professionellere Einrichtung weisen Sie Ihrer Anwendung über Ihr ServerPrism-Dashboard eine benutzerdefinierte Domain oder eine kostenlose ServerPrism-Subdomain zu.
• Laufzeitwechsel: Wenn Sie zu einer anderen Anwendung wechseln möchten (z.B. von Owncast zu Yarr), können Sie dies einfach über den Startup-Tab in Ihrem ServerPrism-Panel tun, indem Sie eine neue Laufzeit auswählen. Dadurch wird Ihr Server mit der neuen Anwendung neu aufgesetzt.
• Erweiterte Konfiguration: Für erweiterte Funktionen, Integrationen und Anpassungsoptionen lesen Sie die offizielle Dokumentation Ihrer gewählten Anwendung.