Paperless-ngx: Ordnerfreigabe per SMB (Samba) im Proxmox LXC einrichten

Wenn Sie Paperless-ngx in einem LXC-Container unter Proxmox betreiben, kann das Hochladen von Dokumenten über die Weboberfläche mühsam sein. Mit dieser Anleitung richten Sie eine SMB-Freigabe ein, um Dokumente direkt in den consume-Ordner zu ziehen und die archivierten Originale bequem einzusehen.

Diese Anleitung setzt voraus, dass Sie sich per SSH mit Ihrem Paperless-ngx LXC-Container verbinden können.

🛠️ 1. Installation und Vorbereitung im LXC

Der erste Schritt ist die Installation des Samba-Dienstes im Paperless-ngx Container.

1.1 Samba installieren

Verbinden Sie sich mit Ihrem LXC und installieren Sie die notwendigen Pakete:

sudo apt update
sudo apt install samba -y

1.2 Samba-Benutzer anlegen

Wir erstellen einen dedizierten Benutzer für den SMB-Zugriff. Wir nennen ihn hier smbuser.

1. Linux-Benutzer erstellen:Bashsudo adduser smbuser --disabled-password
2. Samba-Passwort festlegen: Dieses Passwort wird für die Anmeldung über SMB benötigt.Bashsudo smbpasswd -a smbuser Geben Sie das gewünschte Passwort ein und wiederholen Sie es.
3. Benutzer zur Paperless-Gruppe hinzufügen: Der Paperless-ngx-Dienst läuft unter einem bestimmten Benutzer/Gruppe (oft paperless). Der SMB-Benutzer muss dieser Gruppe angehören, um Schreibrechte zu erhalten.Bashsudo usermod -aG paperless smbuser

⚙️ 2. Konfiguration der SMB-Freigaben

Nun passen wir die Samba-Konfigurationsdatei an, um die Freigaben für den consume– und den originals-Ordner zu definieren.

2.1 Konfigurationsdatei öffnen

Öffnen Sie die Samba-Konfiguration im Editor (z.B. nano):

sudo nano /etc/samba/smb.conf

2.2 Optimierte Freigaben hinzufügen

Fügen Sie die folgenden Abschnitte ganz am Ende der Datei hinzu. Diese Konfiguration stellt sicher, dass der consume-Ordner Schreibrechte hat und neue Dateien automatisch die Gruppe paperless erben.

Wichtig: Ersetzen Sie smbuser durch den Benutzernamen, den Sie in Schritt 1.2 verwendet haben.

# --- Freigabe zum Ablegen neuer Dokumente (Lese- & Schreibzugriff) ---
[paperless-consume]
comment = Paperless Consume Share (Dropzone)
path = /opt/paperless_data/consume
valid users = smbuser @paperless
force group = +paperless
public = no
writable = yes
create mask = 0664
directory mask = 2775
printable = no

# --- Freigabe zur Einsicht archivierter Originale (Nur Lesezugriff) ---
[paperless-originals]
comment = Paperless Originals PDF Share (Read-Only)
path = /opt/paperless_data/media/documents/originals
valid users = smbuser @paperless
force group = +paperless
public = no
writable = no
create mask = 0644
directory mask = 2775
printable = no

Speichern und schließen Sie die Datei (STRG+O, ENTER, STRG+X in nano).

🔒 3. Linux-Dateirechte korrigieren

Damit der SMB-Dienst und später Paperless-ngx reibungslos zusammenarbeiten, müssen die Linux-Berechtigungen auf dem Ordner korrekt gesetzt werden.

3.1 Berechtigungen für den consume-Ordner

Wir setzen das Set GID Bit (2) und geben dem Besitzer (7) und der Gruppe (7) Schreibrechte (775). Dies stellt sicher, dass der Paperless-Dienst die von Samba erstellten Dateien verarbeiten kann.

# 1. Sicherstellen, dass der Ordner der Gruppe "paperless" gehört
sudo chown -R paperless:paperless /opt/paperless_data/consume

# 2. Schreibrechte für Gruppe und Set GID Bit setzen (2775)
sudo chmod 2775 /opt/paperless_data/consume

3.2 Berechtigungen für den originals-Ordner

Auch hier stellen wir sicher, dass die Gruppe Leserechte hat:

sudo chown -R paperless:paperless /opt/paperless_data/media/documents/originals
sudo chmod 2775 /opt/paperless_data/media/documents/originals

🏁 4. Abschluss und Test

Starten Sie den Samba-Dienst neu, um alle Konfigurationsänderungen zu übernehmen.

sudo systemctl restart smbd

4.1 Testen des Zugriffs

Greifen Sie nun von Ihrem Client-PC (Windows, Mac, Linux) auf die IP-Adresse Ihres LXC-Containers zu:

• Windows: Geben Sie \\IP_IHRES_LXC in die Adressleiste des Explorers ein.
• macOS/Linux: Gehen Sie zu smb://IP_IHRES_LXC im Dateimanager.

Melden Sie sich mit dem Benutzer smbuser und dem Samba-Passwort an.

Sie sollten nun die Freigaben paperless-consume (zum Hochladen) und paperless-originals (zum Lesen) sehen können.