Scannen¶
Ein Netzwerkscanner legt seine PDFs in den Eingangsordner; von dort nimmt der Worker jede
fertige Datei ins Archiv. Viele Geräte schreiben nur auf einen FTP-Server („Scan to FTP“). Dafür bringt Belegt einen
kleinen FTP-Dienst mit (Profil ftp, Image tristanteu/belegt-ftp, vsftpd).
Warning
Nur im eigenen Netz: FTP überträgt Passwort und Dateien ohne Verschlüsselung. Gib die Ports 21 und 30000–30009 nie
ins Internet frei, sondern nur im LAN, in dem der Scanner steht. Kann der Scanner FTPS („FTP over TLS“, „SSL/TLS“),
schalte es mit FTP_TLS ein.
FTP einrichten¶
- Den Eingangsordner anlegen und beim Worker einhängen, wie unter Betrieb beschrieben
(
mkdir eingang && sudo chown 1000 eingang, die Zeile- ./eingang:/var/lib/belegt/eingangeinkommentieren,EINGANG_ORDNER=/var/lib/belegt/eingang). -
In
.envden Zugang für den Scanner setzen:FTP_BENUTZER=scanner FTP_PASSWORT=… # mindestens 8 Zeichen, etwa openssl rand -hex 12 FTP_PASV_ADRESSE=192.168.1.20FTP_PASV_ADRESSEist die Adresse des Rechners mit Belegt im LAN. Im passiven Modus nennt der FTP-Server dem Scanner diese Adresse und einen Port aus 30000–30009 für die Daten; ohne sie bricht das Senden ab. 3. Starten:
Der Dienst nimmt Port 21 (anders mit FTP_PORT) und die Ports 30000–30009 an. Er kennt nur den einen Benutzer, der in
den Eingangsordner eingesperrt ist und dort als UID 1000 schreibt, damit der Worker aufgenommene Dateien entfernen
darf. Herunterladen geht nicht, Punktdateien lehnt er ab. Jede Übertragung steht mit Dateiname im Log (docker compose logs ftp), das Passwort
nie.
FTPS: FTP_TLS=an erlaubt TLS, FTP_TLS=pflicht verlangt es für Anmeldung und Daten. Ohne eigenes Zertifikat
(PEM mit Schlüssel und Zertifikat, eingehängt unter /etc/ssl/private/belegt-ftp.pem) erzeugt der Dienst beim Start
ein selbst signiertes; der Scanner muss es dann annehmen, oft unter „Zertifikat prüfen: aus“.
Ein Unterordner als Zielordner wird mit EINGANG_ORDNER_TAGS=true zum Tag, etwa ein eigenes Profil Steuer für Belege
zur Steuer. Stapel mit Trennblättern teilt der Worker wie jede andere Datei.
Brother MFC: Scan to FTP¶
Die Namen der Menüs unterscheiden sich je nach Modell und Firmware ein wenig; so geht es bei aktuellen MFC-Geräten:
- Die Web-Oberfläche des Geräts öffnen: seine Adresse im Browser, anmelden mit dem Kennwort des Geräts (steht oft unten auf dem Gerät, „Pwd“).
- Scannen › Scannen an FTP/SFTP/Netzwerk (oder „Scan to FTP/SFTP/Network/SharePoint“): bei einem freien Profil FTP wählen und senden.
-
Scannen › Profil Scannen an FTP/SFTP/Netzwerk › das Profil öffnen und eintragen:
Feld Wert Profilname etwa Belegt; so erscheint es am GerätHost-Adresse die Adresse aus FTP_PASV_ADRESSE, etwa192.168.1.20Port-Nummer 21(oderFTP_PORT)Benutzername, Kennwort FTP_BENUTZERundFTP_PASSWORTZielordner /für den Eingangsordner selbst oder ein Unterordner wieSteuerPassiver Modus Ein Dateityp PDF (mehrseitig); PDF/A geht auch, „Sicheres PDF“ mit Kennwort nicht, denn Belegt kann es nicht lesen Auflösung 300 dpi in Farbe oder Graustufen, für die Texterkennung Dateiname frei; Brother hängt Datum und Zähler an, gleiche Namen überschreiben sich also nicht -
Senden und am Gerät Scannen › an FTP › Profil „Belegt“ wählen. Nach wenigen Sekunden liegt das Dokument im Eingang von Belegt.
Kommt nichts an: docker compose logs ftp zeigt, ob sich der Scanner angemeldet hat (OK LOGIN) und was er gesendet
hat (OK UPLOAD); docker compose logs worker zeigt, was der Worker aufgenommen hat. „Verbindungsfehler“ am Gerät nach
erfolgreicher Anmeldung heißt fast immer: FTP_PASV_ADRESSE fehlt oder stimmt nicht, oder eine Firewall auf dem Rechner
sperrt 30000–30009.
Ohne FTP¶
Kann der Scanner in eine Windows-Freigabe (SMB) schreiben, reicht eine Freigabe des Eingangsordners, etwa von einem NAS oder mit Samba auf dem Rechner; einen SMB-Dienst bringt Belegt nicht mit. Ohne Scanner im Netz lädst du Scans in der Oberfläche hoch oder teilst sie vom Handy an Belegt (Eingang).