Zum Inhalt springen

Leitfaden zur Fehlerbehebung

Bei der Installation oder Verwendung von SetFN können Probleme auftreten. Dieses Dokument fasst Ursachen und Lösungen nach häufig gemeldeten Symptomen zusammen. Suchen Sie in der folgenden Liste das Symptom, das bei Ihnen auftritt.


Installation

Q: Tritt während der Installation ein Portkonflikt auf?

Dies passiert, wenn ein anderes Programm den von SetFN verwendeten Port bereits belegt.

  1. Prüfen Sie, welches Programm den betreffenden Port verwendet
  2. Beenden Sie das Programm, das den Konflikt verursacht, oder ändern Sie die Porteinstellung von SetFN
  3. Führen Sie die Installation erneut durch

Q: Die Installation ist abgeschlossen, aber der Dienst startet nicht?

Wenn Sie den automatischen Start (systemd) eingerichtet haben, prüfen Sie Dienststatus und Protokolle.

  1. Prüfen Sie den Laufstatus mit systemctl status setfn-spacebuilder
  2. Ist der Dienst gestoppt, starten Sie ihn mit sudo systemctl start setfn-spacebuilder
  3. Startet er weiterhin nicht, prüfen Sie die Fehlermeldungen mit journalctl -u setfn-spacebuilder -n 100 --no-pager
  4. Prüfen Sie, ob User und ExecStart in der Dienstdatei mit dem tatsächlichen Benutzernamen und dem Pfad der ausführbaren Datei übereinstimmen

Wenn Sie den automatischen Start nicht eingerichtet haben, führen Sie die ausführbare Datei im Terminal erneut aus. Details finden Sie unter Installation unter Linux.

Q: Kann ich SetFN mit Docker installieren?

Ein offizielles Docker-Image wird derzeit noch nicht bereitgestellt. Führen Sie docker pull oder docker run nicht mit beliebigen Image-Namen aus.

  1. Installieren Sie SetFN derzeit wie unter Installation unter Linux beschrieben
  2. Den Stand der Docker-Unterstützung finden Sie unter Installation mit Docker

Zugriff

Q: SetFN lässt sich nicht im Browser aufrufen?

Möglicherweise liegt ein Problem mit den Netzwerkeinstellungen oder dem Dienststatus vor.

  1. Prüfen Sie, ob der SetFN-Dienst ordnungsgemäß läuft
  2. Prüfen Sie, ob die Zugriffsadresse (IP, Port) korrekt ist
  3. Prüfen Sie, ob der betreffende Port in der Firewall freigegeben ist
  4. Versuchen Sie den Zugriff von einem anderen Gerät im selben Netzwerk

Q: Die Anmeldung funktioniert nicht?

  1. Prüfen Sie, ob Benutzername und Passwort korrekt sind
  2. Prüfen Sie, ob die Feststelltaste (Caps Lock) nicht aktiviert ist
  3. Haben Sie Ihr Passwort vergessen, verwenden Sie die Funktion zum Zurücksetzen des Passworts
  4. Das Konto wurde möglicherweise vom Administrator deaktiviert; wenden Sie sich an den Administrator

Q: Der Zugriff von außen funktioniert nicht?

Prüfen Sie, ob der externe Zugriff korrekt konfiguriert ist.

  1. Prüfen Sie zuerst, ob der Zugriff über die Adresse im internen Netzwerk aus demselben Netzwerk funktioniert
  2. Prüfen Sie, ob die Verbindung für den externen Zugriff, z. B. Cloudflare Tunnel, läuft
  3. Prüfen Sie, ob die Domain korrekt verbunden ist
  4. Prüfen Sie unter Blockierungsverwaltung > Liste aktiver Blockierungen, ob die IP-Adresse, von der aus zugegriffen wird, blockiert ist

Q: Nur bestimmte Benutzer können nicht zugreifen?

  1. Nach wiederholten Anmeldefehlern kann die IP-Adresse automatisch blockiert werden. Prüfen Sie die IP-Adresse des Benutzers unter Blockierungsverwaltung > Liste aktiver Blockierungen
  2. Prüfen Sie, ob Berechtigungen und Status des Benutzerkontos in Ordnung sind

Q: Auch der Administrator kann sich nicht anmelden?

Wenn auch das Administratorkonto blockiert ist oder das Passwort unbekannt ist und Sie die Administrationsseite nicht aufrufen können, stellen Sie den Zugang über Befehle im Terminal des Computers wieder her, auf dem SpaceBuilder installiert ist.

  1. Eine Anmeldesperre heben Sie mit dem Befehl unblock auf
  2. Das Administratorpasswort ändern Sie mit dem Befehl user password
  3. Ist der Zugriff auf die Administrationsseite wegen der IP-Zugriffsbeschränkung nicht möglich, korrigieren Sie die Zulassungsliste mit dem Befehl ip

Details finden Sie unter Server über Befehle verwalten.

Dateien

Q: Der Datei-Upload schlägt fehl?

  1. Prüfen Sie, ob Sie Schreibrechte für den Zielordner haben
  2. Prüfen Sie den freien Speicherplatz auf dem Server
  3. Prüfen Sie, ob die Dateigröße das festgelegte Limit überschreitet
  4. Prüfen Sie, ob die Netzwerkverbindung stabil ist

Q: Der Datei-Download ist langsam?

  1. Prüfen Sie, ob sich Server und Client im selben internen Netzwerk befinden
  2. Prüfen Sie, ob die Netzwerkbandbreite ausreicht
  3. Prüfen Sie, ob die CPU- und Speicherauslastung des Servers übermäßig hoch ist
  4. Bei vielen gleichzeitigen Zugriffen sollten Sie ein Upgrade der Serverausstattung in Betracht ziehen

Q: Eine Datei wird in der Liste nicht angezeigt?

  1. Prüfen Sie, ob der aktuelle Benutzer mit seiner Stufe und seinem Team auf den Ordner zugreifen darf
  2. Prüfen Sie, ob ein Ordnerfilter aktiv ist, der die Datei ausblendet
  3. Leeren Sie den Browser-Cache und laden Sie die Seite neu

Leistung

Q: SetFN ist insgesamt langsamer geworden?

Möglicherweise reichen die Serverressourcen nicht aus.

  1. Prüfen Sie die CPU- und Speicherauslastung des Servers
  2. Prüfen Sie, ob genügend Festplattenspeicher vorhanden ist (bei weniger als 10 % freiem Speicher kann die Leistung sinken)
  3. Prüfen Sie unter Systemmanagement > Hintergrunddienste, ob Aufgaben wie KI oder Indexierung übermäßig viele Ressourcen verbrauchen
  4. Starten Sie den Server neu

Q: Die Suche ist langsam oder liefert keine Ergebnisse?

  1. Prüfen Sie, ob der Suchindex ordnungsgemäß aufgebaut wurde
  2. Bei sehr vielen Dateien grenzen Sie den Suchbereich auf einen bestimmten Ordner ein
  3. Nach einem Serverneustart kann es einige Zeit dauern, bis der Index neu aufgebaut ist

Sonstiges

Q: Gibt es Probleme mit der Browserkompatibilität?

SetFN empfiehlt einen aktuellen Webbrowser. Prüfen Sie Folgendes.

  1. Prüfen Sie, ob Sie die neueste Version von Chrome, Edge, Firefox oder Safari verwenden
  2. Internet Explorer wird nicht unterstützt; verwenden Sie einen anderen Browser
  3. Löschen Sie Browser-Cache und Cookies und versuchen Sie es erneut

Q: Das Problem lässt sich mit den obigen Methoden nicht lösen?

  1. Prüfen Sie die Fehlermeldungen im Serverprotokoll. Läuft SpaceBuilder mit automatischem Start, verwenden Sie journalctl -u setfn-spacebuilder -n 100 --no-pager
  2. Prüfen Sie den Zustand von Betriebssystem und Festplatte unter Systemmanagement > Geräteinformationen
  3. Wenden Sie sich an den offiziellen technischen Support von SetFN und geben Sie dabei die Fehlermeldung und Informationen zu Ihrer Umgebung an

Verwandte Dokumente