Zum Inhalt

Fehlerbehebung

Warum Paperless-Dokumente nicht erscheinen, und wie du es behebst. Fang dort an, wo dein Problem anfängt:

Die Einstellungen zeigen den Benutzern keinen Fehler: Eine Suche, die fehlschlägt, zeigt ihnen keine Paperless-Dokumente, wie eine Suche, die keine findet. Deshalb führen die Einstellungen den Verlauf dieser Probleme für die Administratoren, unter Probleme der Suche, auch wenn der Hoster das Protokoll von Nextcloud vor ihnen verbirgt.

Keine Paperless-Dokumente in der Suche

Sechs Fragen, eine nach der anderen, finden, warum ein Dokument für einen Benutzer nicht erscheint, hier Dokument 412 für jamie:

---
config:
  flowchart:
    wrappingWidth: 400
    nodeSpacing: 30
---
flowchart TB
    accTitle: Warum die Suche keine Paperless-Dokumente zeigt
    accDescr: jamie sucht nach Rechnung und sieht Dokument 412 nicht unter Paperless-Dokumente. Sechs Fragen, eine nach der anderen, finden die Ursache. Ist Verbundene Dienste durchsuchen eingeschaltet, oder ist Paperless in den Einstellungen vertrauenswürdig? Wenn nicht, schalte es ein, nach jedem Neuladen der Seite erneut. Gibt es ein Archiv-Konto in den Einstellungen? Wenn nicht, gib das Konto ein, dem die synchronisierten Dateien gehören. Listet Probleme der Suche in den Einstellungen fehlgeschlagene Suchen auf? Wenn ja, behebe den Fehler, den es nennt. Findet Paperless Dokument 412 zu dem Begriff, angemeldet als das Konto des API-Tokens? Wenn nicht, lass dieses Konto das Dokument ansehen, oder baue den Index von Paperless mit document_index reindex neu auf. Hat das Archiv-Konto eine Datei mit [P412] im Namen? Wenn nicht, lass die Synchronisierung sie schreiben, und scanne einen externen Speicher mit occ files:scan. Kann jamie diese Datei öffnen? Wenn nicht, teile die Datei oder ihren Ordner nur lesend mit jamie. Dann erscheint Dokument 412 unter Paperless-Dokumente.

    start(["jamie sucht nach Rechnung<br>und sieht Dokument 412 nicht"])
    switch{"Verbundene Dienste durchsuchen<br>an, oder Paperless vertraut?"}
    archive{"Ein Archiv-Konto<br>in den Einstellungen?"}
    problems{"Probleme der Suche listet<br>fehlgeschlagene Suchen?"}
    paperless{"Findet Paperless 412<br>zu dem Begriff, als das Konto<br>des Tokens?"}
    marker{"Hat das Archiv-Konto<br>eine Datei mit [P412]<br>im Namen?"}
    shared{"Kann jamie diese<br>Datei öffnen?"}
    shows(["Dokument 412 erscheint unter<br>Paperless-Dokumente"])

    fixSwitch["Einschalten: Nextcloud schaltet<br>es bei jedem Neuladen aus"]
    fixArchive["Das Konto eingeben, dem die<br>synchronisierten Dateien gehören"]
    fixProblems["Den Fehler beheben, den es nennt,<br>wie die Tabellen unten sagen"]
    fixPaperless["Das Konto das Dokument ansehen<br>lassen, oder den Index neu aufbauen:<br>document_index reindex"]
    fixMarker["Die Synchronisierung sie<br>schreiben lassen; einen externen<br>Speicher scannen: occ files:scan"]
    fixShare["Die Datei oder ihren Ordner<br>nur lesend mit jamie teilen"]

    start --> switch
    switch -- "ja" --> archive
    switch -- "nein" --> fixSwitch
    archive -- "ja" --> problems
    archive -- "nein" --> fixArchive
    problems -- "nein" --> paperless
    problems -- "ja" --> fixProblems
    paperless -- "ja" --> marker
    paperless -- "nein" --> fixPaperless
    marker -- "ja" --> shared
    marker -- "nein" --> fixMarker
    shared -- "ja" --> shows
    shared -- "nein" --> fixShare
    %% Die Abhilfen in einer Spalte neben den Fragen, damit die Fragen in einer bleiben.
    fixSwitch ~~~ fixArchive ~~~ fixProblems ~~~ fixPaperless ~~~ fixMarker ~~~ fixShare

    classDef you fill:#f59e0b2e,stroke:#f59e0b,stroke-width:2px
    classDef done fill:#16a34a2e,stroke:#16a34a,stroke-width:2px
    class fixSwitch,fixArchive,fixProblems,fixPaperless,fixMarker,fixShare you
    class shows done
  1. Verbundene Dienste durchsuchen. Nextcloud fragt Paperless nur, solange der Benutzer es in der Suche eingeschaltet hat, und schaltet es bei jedem Neuladen der Seite aus (warum). Paperless immer in die globale Suche einbeziehen in den Einstellungen fragt Paperless stattdessen bei jeder Suche.
  2. Das Archiv-Konto. Ohne eines steht keine Datei für ein Dokument, und die Suche fragt Paperless gar nicht erst. Die Einstellungen nehmen das Konto von Paperless Sync, wenn das Feld leer ist, und warnen, wenn das Konto des Feldes nicht existiert. Sagen sie, dass das gespeicherte API-Token nicht entschlüsselt werden kann, etwa nach einem Umzug von Nextcloud mit einem anderen secret in der config.php, gib es erneut ein.
  3. Probleme der Suche. Eine fehlgeschlagene Suche erscheint dort mit ihrem Fehler; unten steht, was jede Zeile bedeutet, und die Tabellen des Tests der Verbindung sagen, wie du die Fehler behebst, denn eine Suche schlägt aus denselben Gründen fehl wie der Test.
  4. Was Paperless findet. Melde dich als das Konto des API-Tokens bei Paperless an und suche nach demselben Begriff. Paperless zeigt diesem Konto nur die Dokumente, die es ansehen darf: Gib ihm die Berechtigung, die anderen anzusehen, oder einer Gruppe, in der es ist, wie Einrichten beschreibt. Findet Paperless selbst ein Dokument nicht, dessen Text den Begriff enthält, fehlt das Dokument in seinem Index: Bau ihn neu auf.
  5. Die Datei mit der Kennung. Die Datei muss dem Archiv-Konto gehören und die genaue Kennung des Dokuments, [P412], im Namen tragen: Eine Kopie in einem anderen Konto oder P412 ohne die Klammern steht für nichts. Eine Datei, die die Synchronisierung noch nicht geschrieben hat, etwa für ein Dokument, das noch im Posteingang von Paperless liegt, kann ebenfalls nicht erscheinen. Nextcloud findet nur die Dateien, die sein Datei-Cache kennt: Für einen externen Speicher oder Dateien, die an Nextcloud vorbei in seinen Datenordner kopiert wurden, lass occ files:scan --path=/paperless/files/Paperless den Ordner des Archivs scannen.
  6. Die Freigabe. Der Benutzer muss diese Datei öffnen können: das Archiv-Konto selbst oder ein Benutzer oder eine Gruppe, mit dem oder der es die Datei oder einen Ordner darum nur lesend geteilt hat, wie Einrichten zeigt. Melde dich als der Benutzer an und such die Datei in Dateien: Wo der Benutzer sie nicht öffnen kann, kann die Suche sie nicht zeigen.

Fehlt es immer noch? Bitte um Hilfe, mit dem, was jeder dieser Schritte gezeigt hat.

Was du siehst, und warum

Was du siehst Warum Was zu tun ist
Gar kein Abschnitt Paperless-Dokumente Nextcloud zeigt einen Abschnitt nur, wenn er Treffer hat, und fragt Paperless nur mit eingeschaltetem Verbundene Dienste durchsuchen Schalte es ein und folge dann den sechs Fragen oben
Das Archiv-Konto findet die Dokumente, andere Benutzer nicht Das Archiv ist nicht mit ihnen geteilt Teile es nur lesend mit ihnen oder ihrer Gruppe
Manche Dokumente erscheinen, andere nicht Das Konto des Tokens darf sie nicht ansehen, oder sie haben noch keine Datei mit ihrer Kennung Fragen 4 und 5 oben
Paperless-Dokumente sind nach einem Umzug oder einer Wiederherstellung von Nextcloud verschwunden Das gespeicherte API-Token lässt sich mit dem neuen secret der config.php nicht entschlüsseln Gib das Token in den Einstellungen erneut ein
Paperless-Dokumente sind verschwunden, nachdem allow_local_remote_servers aus der config.php entfernt wurde Nextcloud verweigert die Adresse von Paperless im lokalen Netzwerk Wähle Paperless läuft in meinem lokalen Netzwerk und speichere
Eine Anfrage in der Syntax von Paperless findet nichts, während du sie noch tippst Paperless kann sie noch nicht verarbeiten, etwa created:[2026 to Tippe die Anfrage zu Ende; Paperless 3 findet solange ihre Wörter
Nur wenige Treffer und kein Weitere Ergebnisse laden Der Benutzer kann die Dateien nur weniger der Dokumente öffnen, die Paperless zuerst einordnet Normal: Die Suche geht für jede Seite mit Treffern bis zu 4 Seiten mit 25 Dokumenten von Paperless durch

Wenn der Test der Verbindung fehlschlägt

Verbindung testen und speichern speichert nichts, bis Paperless mit einer Liste von Dokumenten antwortet, und wenn es das nicht tut, sagt die Meldung, was fehlgeschlagen ist und was zu korrigieren ist, in der Sprache deines Kontos. Das Protokoll von Nextcloud bekommt eine Warnung mit dem Fehler selbst, etwa cURL error 6: Could not resolve host, ohne das Token und ohne die Abfrage der URL.

flowchart TB
    accTitle: Was der Test der Verbindung prüft
    accDescr: Verbindung testen und speichern fragt Paperless nach einem Dokument. Zuerst muss Nextcloud Paperless unter der URL erreichen: seinen Host finden, sich mit seiner Adresse verbinden dürfen, sich innerhalb von 3 Sekunden verbinden, seinem Zertifikat vertrauen und innerhalb von 10 Sekunden eine Antwort bekommen; sonst nennt die Meldung, was davon fehlgeschlagen ist. Dann muss Paperless mit einem Status 2xx antworten; ein abgelehntes Token, ein falscher Pfad, eine Weiterleitung oder ein Fehler des Servers haben je eine eigene Meldung. Zuletzt muss die Antwort eine Liste von Dokumenten von Paperless-ngx sein. Erst dann werden die Einstellungen gespeichert.

    test(["`**Verbindung testen und speichern**`"])
    reach{"Erreicht Nextcloud<br>Paperless unter der URL?"}
    status{"Antwortet Paperless<br>mit 2xx?"}
    list{"Ist die Antwort eine Liste<br>von Dokumenten?"}
    saved["Gespeichert"]
    network["Host nicht gefunden, lokale Adresse,<br>nicht erreicht, Zertifikat,<br>Verschlüsselung oder keine rechtzeitige Antwort"]
    refused["Token abgelehnt, falscher Pfad,<br>Weiterleitung oder Fehler des Servers"]
    other["Nicht wie Paperless-ngx"]

    test --> reach
    reach -- "ja" --> status
    reach -- "nein" --> network
    status -- "ja" --> list
    status -- "nein" --> refused
    list -- "ja" --> saved
    list -- "nein" --> other

    classDef yes fill:#16a34a2e,stroke:#16a34a,stroke-width:2px
    classDef no fill:#dc26262e,stroke:#dc2626,stroke-width:2px
    class saved yes
    class network,refused,other no
Die Meldung sagt Was fehlgeschlagen ist Was zu tun ist
Paperless hat das API-Token abgelehnt (HTTP 401 oder 403) Paperless kennt das Token nicht, oder sein Konto darf keine Dokumente ansehen. Oder die URL leitet auf ein anderes Schema, einen anderen Host oder Port um, etwa von http auf https, und Nextcloud lässt das Token bei der Weiterleitung weg Kopiere das Token erneut aus dem Profil des Paperless-Kontos und gib dem Konto die Berechtigung, Dokumente anzusehen. Gib die Adresse ein, auf die die URL weiterleitet
Diese URL antwortet, aber nicht mit der API von Paperless (HTTP 404) Der Pfad der URL oder ein Proxy vor Paperless Gib die Adresse ein, die Paperless im Browser öffnet, mit dem Pfad, wenn Paperless unter einem läuft, etwa https://example.com/paperless
Diese URL leitet an eine andere Adresse weiter Die URL leitet um, und mit Paperless läuft in meinem lokalen Netzwerk folgt Nextcloud keiner Weiterleitung Gib die Adresse ein, auf die sie weiterleitet, etwa die mit https
Paperless ist älter als 2.16 Paperless hat mit HTTP 406 geantwortet: Es spricht Version 9 seiner API nicht, nach der die App fragt Aktualisiere Paperless-ngx auf 2.16 oder neuer
Paperless hat mit einem Fehler geantwortet Paperless selbst ist fehlgeschlagen, mit einem Status 5xx Sieh in das Protokoll von Paperless, oder versuche es später erneut
Diese URL antwortet, aber nicht wie Paperless-ngx Ein anderer Dienst oder die Anmeldeseite eines Proxys Prüfe die Adresse und ihren Pfad
Nextcloud verbindet sich nicht mit Adressen des lokalen Netzwerks Paperless läuft unter einer Adresse des lokalen Netzwerks Wähle Paperless läuft in meinem lokalen Netzwerk, wie Paperless in deinem lokalen Netzwerk beschreibt
Nextcloud vertraut dem Zertifikat von Paperless nicht Ein Zertifikat deiner eigenen Zertifizierungsstelle, ein selbst signiertes oder eines für einen anderen Namen Importiere das Zertifikat der Zertifizierungsstelle mit occ security:certificates:import, oder verwende den Namen, für den das Zertifikat ausgestellt ist
Nextcloud konnte keine verschlüsselte Verbindung aufbauen Meist https an einem Port, der einfaches HTTP spricht Gib die URL mit http ein, oder den Port von HTTPS
Nextcloud konnte den Host dieser URL nicht finden Der Name lässt sich nicht auflösen, wie ein Docker-Dienst außerhalb des Netzwerks von Nextcloud Prüfe seine Schreibweise, und bring Nextcloud und Paperless in ein gemeinsames Docker-Netzwerk
Paperless hat nicht rechtzeitig geantwortet Keine Verbindung innerhalb von 3 Sekunden oder keine Antwort innerhalb von 10 Prüfe, ob Paperless läuft und nicht ausgelastet ist und ob keine Firewall die Anfragen verwirft
Nextcloud konnte Paperless unter dieser URL nicht erreichen Die Verbindung wurde abgelehnt, wie an einem falschen Port Prüfe die Adresse und den Port und ob Paperless läuft
Die Einstellungen konnten nicht gespeichert werden Etwas nach dem Test, etwa die Datenbank Sieh in das Protokoll von Nextcloud

Die Antwort der Route der Einstellungen trägt neben der Meldung einen code, etwa unauthorized, not_found oder unknown_host, für Skripte, die die Einstellungen speichern.

Kann Nextcloud selbst die Anfrage nicht annehmen, sagt die Seite das in einem Satz, statt die Seite des Fehlers zu zeigen:

Die Meldung sagt Was passiert ist Was zu tun ist
Nextcloud ist im Wartungsmodus Nextcloud wird aktualisiert oder gewartet und beantwortet jede Anfrage mit HTTP 503 und einem Header, der das sagt Versuche es in ein paar Minuten noch einmal
Deine Sitzung ist abgelaufen Die Sitzung deiner Anmeldung ist beendet, oder ihr Anfrage-Token ist nicht mehr gültig (HTTP 401 oder 412) Lade die Seite neu und versuche es noch einmal
Nextcloud ist nicht erreichbar Der Browser hat seine Verbindung zu Nextcloud verloren Prüfe deine Verbindung und versuche es noch einmal
Die Anfrage ist fehlgeschlagen (HTTP 502) Ein Proxy vor Nextcloud hat mit einem eigenen Fehler geantwortet, etwa 502, 503 oder 504, oder Nextcloud hat ein Problem mit seiner eigenen Einrichtung gefunden, etwa einen Datenordner, in den es nicht schreiben kann. Ohne Status ist die Seite selbst auf einen Fehler gestoßen Prüfe, ob Nextcloud läuft, sein Protokoll und das Protokoll des Proxys, und lade die Seite neu
Bestätige dein Passwort, um die Einstellungen zu ändern Der Dialog, der nach deinem Nextcloud-Passwort fragt, wurde geschlossen oder hat das Passwort nicht bestätigt Wähle erneut Verbindung testen und speichern oder Verbindung trennen und bestätige mit deinem Nextcloud-Passwort
Nextcloud hat unerwartet geantwortet Etwas vor Nextcloud, etwa die Anmeldeseite eines Proxys, hat statt der App geantwortet Lade die Seite neu und versuche es noch einmal

Vor dem Test prüfen die Einstellungen, was du eingegeben hast. Diese Meldungen nennen, was zu korrigieren ist:

Die Meldung sagt Was zu tun ist
Gib eine gültige Paperless-URL ein Gib die ganze Adresse ein, mit http:// oder https://, etwa https://paperless.example.com
Die Paperless-URL muss HTTP oder HTTPS verwenden Beginne die URL mit http:// oder https://
Die Paperless-URL darf keine Zugangsdaten, keine Abfrage (?…) und kein Fragment (#…) enthalten Lass user:password@, ein ? und ein # weg: Das Token ist der einzige Zugang
Gib den Host der Paperless-URL in seiner ASCII-Form (Punycode) ein Gib einen Namen mit Buchstaben wie ü als Punycode ein, etwa xn--bcher-kva.example für bücher.example
Ein Paperless-API-Token ist erforderlich Gib das Token ein: Es ist noch keines gespeichert
Gib das API-Token erneut ein: Ein gespeichertes Token wird nur an den Paperless-Server gesendet, für den es gespeichert wurde Gib das Token erneut ein: Die URL nennt ein anderes Schema, einen anderen Host oder Port als die gespeicherte
Das Archiv-Konto … existiert nicht Gib die ID eines vorhandenen Nextcloud-Kontos ein, oder lass das Feld für das Konto von Paperless Sync leer

Die Referenz listet den Code, mit dem die Route der Einstellungen jede Meldung beantwortet, für Skripte, die die Einstellungen speichern.

Paperless in deinem lokalen Netzwerk

Läuft Paperless unter einer Adresse deines lokalen Netzwerks oder unter dem Namen seines Docker-Dienstes, etwa http://192.168.1.20:8000 oder http://paperless:8000, verweigert Nextcloud die Verbindung dorthin, und der Test der Verbindung sagt das. Wähle Paperless läuft in meinem lokalen Netzwerk in den Einstellungen und speichere: Nextcloud erlaubt diese Adresse dann für die Anfragen dieser App an die URL der Einstellungen und für nichts anderes. Einrichten hat die Details und sagt, warum allow_local_remote_servers in der config.php der falsche Weg ist.

Mit dem Schalter folgt Nextcloud keiner Weiterleitung: Eine URL, die weiterleitet, etwa von http auf https, lässt den Test mit einer eigenen Meldung fehlschlagen. Gib die Adresse ein, auf die sie weiterleitet.

Eigene Zertifikate

Nextcloud prüft das Zertifikat jedes HTTPS-Servers, mit dem es sich verbindet. Ein Paperless mit dem Zertifikat einer eigenen Zertifizierungsstelle oder mit einem selbst signierten lässt den Test mit Nextcloud vertraut dem Zertifikat von Paperless nicht fehlschlagen. Importiere das Zertifikat der Zertifizierungsstelle, oder das selbst signierte Zertifikat selbst, in die Zertifikate, denen Nextcloud vertraut:

occ security:certificates:import /path/to/ca.crt
occ security:certificates

Der zweite Befehl listet die Zertifikate, die du importiert hast. In Docker muss die Datei zuerst in den Container:

docker compose cp ca.crt app:/tmp/ca.crt
docker compose exec --user www-data app php occ security:certificates:import /tmp/ca.crt

Der Name in der URL muss einer sein, für den das Zertifikat ausgestellt ist: Ein Zertifikat für paperless.example.com schlägt für https://192.168.1.20 fehl. Wechsle nicht auf http, um ein Zertifikat zu umgehen, wenn die Verbindung den Rechner verlässt, denn das Token reiste dann unverschlüsselt.

Hinter einem Reverse Proxy

Ein Proxy vor Paperless, etwa nginx, Traefik, Caddy oder der Tunnel von Cloudflare, antwortet für Paperless, und manche seiner Antworten lassen den Test fehlschlagen:

  • Ein Pfad. Läuft Paperless unter einem Pfad, etwa https://example.com/paperless mit PAPERLESS_FORCE_SCRIPT_NAME=/paperless, braucht die URL der Einstellungen diesen Pfad; die App hängt /api/documents/ daran. Ohne ihn schlägt der Test mit HTTP 404 fehl.
  • Eine Anmeldung vor Paperless, etwa die Forward-Authentifizierung von Authelia oder Authentik, antwortet mit ihrer Anmeldeseite oder einer Weiterleitung dorthin: Diese URL antwortet, aber nicht wie Paperless-ngx, oder, mit Paperless läuft in meinem lokalen Netzwerk, Diese URL leitet an eine andere Adresse weiter. Lass den Proxy den Pfad /api/ ohne seine Anmeldung an Paperless weitergeben, denn das Token authentifiziert jede Anfrage, oder lass Nextcloud Paperless hinter dem Proxy erreichen, unter seiner Adresse im lokalen Netzwerk, mit Paperless läuft in meinem lokalen Netzwerk.
  • Basic-Authentifizierung im Proxy, etwa auth_basic von nginx, beantwortet eine Anfrage, die statt seiner eigenen Anmeldung das Token trägt, mit HTTP 401: Paperless hat das API-Token abgelehnt (HTTP 401), mit einem Token, das funktioniert. Lass den Proxy den Pfad /api/ ohne sie an Paperless weitergeben.
  • Der Header Authorization. Das Token reist darin, als Authorization: Token …. Ein Proxy, der den Header verwirft oder durch einen eigenen ersetzt, lässt Paperless ein richtiges Token mit HTTP 401 ablehnen.
  • Eine Firewall oder ein Schutz gegen Bots, etwa die Challenge-Seite von Cloudflare, antwortet mit HTTP 403 oder einer eigenen Seite: Paperless hat das API-Token abgelehnt (HTTP 403) mit einem Token, das im Browser funktioniert, oder nicht wie Paperless-ngx. Lass die Anfragen des Nextcloud-Servers durch, deren User-Agent mit Nextcloud-Paperless-Unified-Search/ beginnt.
  • Eine Weiterleitung auf ein anderes Schema, einen anderen Host oder Port, etwa von http auf https oder auf einen anderen Namen: Nextcloud folgt ihr, lässt aber das Token weg, damit das Token nie einen Server erreicht, für den es nicht eingegeben wurde, und Paperless lehnt die Anfrage ohne es ab: Paperless hat das API-Token abgelehnt. Mit Paperless läuft in meinem lokalen Netzwerk folgt Nextcloud keiner Weiterleitung, und der Test sagt Diese URL leitet an eine andere Adresse weiter. So oder so: Gib die Adresse ein, auf die der Proxy weiterleitet. Eine Weiterleitung innerhalb desselben Servers, etwa auf den Pfad mit einem Schrägstrich am Ende, behält das Token.

Das Protokoll des Proxys zeigt jede Anfrage der App mit diesem User-Agent und der Version der App.

Der Index von Paperless

Paperless findet Dokumente in einem Index ihrer Wörter, den es neben seiner Datenbank führt. Nach einer Wiederherstellung, einem Umzug oder einem Absturz von Paperless kann dem Index ein Dokument fehlen, oder er enthält noch die Wörter seines alten Textes: Die Suche von Paperless selbst übersieht es dann ebenfalls, und ebenso die Suche von Nextcloud. Bau ihn neu auf:

docker compose exec webserver document_index reindex

webserver ist der Dienst von Paperless in seiner compose.yaml; ohne Docker führst du python3 manage.py document_index reindex im Ordner src von Paperless aus. Ein großes Archiv braucht eine Weile, und Paperless findet weniger, bis es fertig ist.

Probleme der Suche

Das Ende der Einstellungen zählt die Probleme der Suche und listet die letzten 20 davon, die neuesten zuerst. Es zeigt Kein Problem aufgezeichnet, bis eine Suche fehlschlägt oder eine Anfrage ihren zweiten Versuch braucht. Verlauf leeren und Verbindung trennen löschen den Verlauf; das Speichern der Einstellungen behält ihn.

Zeile Was sie zeigt
Aufgezeichnet seit Wann der Verlauf begann: das erste Problem, nachdem er zuletzt geleert wurde
Fehlgeschlagene Suchen Wie viele Suchen keine Paperless-Dokumente gezeigt haben, weil eine Anfrage fehlgeschlagen ist, auch die, die die Liste nicht mehr enthält
Erst im zweiten Versuch beantwortet Wie viele Anfragen an Paperless fehlgeschlagen sind, bevor sie es erreicht haben, und ihre Antwort im zweiten Versuch bekommen haben: Die Benutzer haben die Dokumente gesehen, einen Moment später
Letzte fehlgeschlagene Suche Wann zuletzt eine Suche fehlgeschlagen ist
Suchen funktionieren wieder seit Wann die erste Suche nach dem letzten Fehler funktioniert hat, oder Seitdem hat keine Suche funktioniert, solange Paperless noch nicht erreichbar ist
Spalte Was sie zeigt
Zeitpunkt Wann das Problem aufgetreten ist, in der Zeitzone und im Format deines Kontos
Ereignis Suche fehlgeschlagen: Der Benutzer hat keine Paperless-Dokumente gesehen. Zweiter Versuch beantwortet: Der erste Versuch ist fehlgeschlagen, bevor er Paperless erreicht hat, der zweite hat die Antwort bekommen
Schritt Anfrage an Paperless: Die Anfrage an Paperless ist fehlgeschlagen. Suche nach den Dateien in Nextcloud: Paperless hat geantwortet, aber das Finden der Dateien seiner Dokumente in Nextcloud ist fehlgeschlagen
Fehler Die Art des Fehlers und seine Meldung, etwa ConnectException: cURL error 6: Could not resolve host, ohne das API-Token, den Suchbegriff und die Abfrage einer URL
Dauer Bei Suche fehlgeschlagen, wie lange die Suche von ihrem Beginn bis zum Fehler gedauert hat: etwa 6.000 ms, wenn keiner der beiden Versuche innerhalb von 3 Sekunden eine Verbindung bekommen hat, etwa 10.000 ms bei einem Paperless, das die Verbindung angenommen, aber nicht geantwortet hat, und die Zeit der Seiten davor, wenn eine spätere Seite von Paperless fehlgeschlagen ist. Bei Zweiter Versuch beantwortet, wie lange der erste Versuch gedauert hat: etwa 3.000 ms für eine Verbindung, die nicht rechtzeitig aufgebaut wurde, ein paar Millisekunden für einen Namen, der sich nicht auflösen ließ

Eine Anfrage, die Paperless ablehnt, während sie noch getippt wird, und eine Seite nach dem letzten Treffer sind keine Probleme und erscheinen nicht. Während eines Ausfalls werden die Probleme einer Art höchstens einmal in 30 Sekunden geschrieben, die dazwischen trotzdem gezählt. Die Fehler der Spalte Fehler sind die des Tests der Verbindung; zum Beispiel:

Der Fehler sagt Was fehlgeschlagen ist
cURL error 6: Could not resolve host Der Name des Hosts der URL lässt sich auf dem Nextcloud-Server nicht auflösen
cURL error 7: Failed to connect Nichts nimmt an der Adresse und dem Port Verbindungen an
cURL error 28: Connection timed out Keine Verbindung innerhalb von 3 Sekunden, auch nicht im zweiten Versuch
cURL error 28: Operation timed out Keine Antwort innerhalb von 10 Sekunden: Paperless ist ausgelastet, etwa während es Dokumente verarbeitet oder seinen Index neu aufbaut
cURL error 60: SSL certificate problem Nextcloud vertraut dem Zertifikat nicht: Importiere es
Paperless returned HTTP 401 Das Token ist nicht mehr gültig: Lege eines an und gib es ein

Die Suche ist langsam

Eine Seite mit Treffern wartet auf Paperless: Die App verbindet sich innerhalb von 3 Sekunden, wartet bis zu 10 Sekunden auf jede Antwort und geht innerhalb von 3 Sekunden bis zu 4 Seiten mit 25 Dokumenten von Paperless durch, um eine Seite mit Treffern zu füllen. Den größten Teil dieser Zeit durchsucht Paperless seinen Index; während es viele Dokumente verarbeitet oder seinen Index neu aufbaut, antwortet es langsamer. Eine Anfrage, die vergeblich auf Paperless gewartet hat, bekommt keinen zweiten Versuch, also kostet ein hängendes Paperless jede Suche höchstens eine Wartezeit.

Such zum Vergleich in Paperless selbst: Ist es dort auch langsam, gib Paperless mehr Arbeitsspeicher oder einen schnelleren Datenträger. Ist es dort schnell, sieh dir das Netzwerk zwischen den beiden Servern an und die Probleme der Suche.

Um Hilfe bitten

Hilft nichts davon, frag in den Diskussionen oder melde einen Fehler mit der Vorlage der Issues, gern auf Englisch. Nenne die Version der App, von Nextcloud und von Paperless-ngx, ob die Suche mit Verbundene Dienste durchsuchen oder immer läuft, welcher Schritt der sechs Fragen fehlgeschlagen ist, und die Zeilen der Probleme der Suche und des Protokolls von Nextcloud. Veröffentliche nie das API-Token, private Adressen oder den Inhalt von Dokumenten.