Paperless-ngx: Ukryte Funkcje i Automatyzacja

Pełny Tutorial Krok po Kroku

Paperless-ngx natywnie nie analizuje plików Microsoft Office. Aby to umożliwić, doinstalujemy dwa narzędzia: Gotenberg (konwerter) oraz Tika (wyodrębnianie tekstu).

Po ich uruchomieniu, każdy plik typu Word czy Excel przesłany do systemu zostanie przekonwertowany i poddany automatycznemu procesowi OCR.

W celu uniknięcia chaosu przy dużej ilości kategorii:

1. Przejdź do sekcji Tags w panelu bocznym.
2. Utwórz kategorię nadrzędną (np. Pojazdy).
3. Kategorie podrzędne twórz z ukośnikiem, np. Pojazdy/Samochód oraz Pojazdy/Motocykl.
4. Dla zachowania estetyki, przypisz powiązanym tagom podobne, harmonijne kolory.

Zamiast ręcznie opisywać dokumenty, pozwól systemowi zrobić to za Ciebie:

• Dowolne (Any): Przypisuje tag, jeśli w tekście występuje chociaż jedno ze wskazanych słów.
• Wszystkie (All): Wymaga obecności każdego z podanych słów kluczowych.
• Dokładne (Exact): Szuka precyzyjnego sformułowania.
• Automatyczne (Auto): Wykorzystuje uczenie maszynowe na podstawie dotychczas ręcznie oznaczonych dokumentów.

Skonfiguruj reguły pocztowe, aby Paperless sam monitorował Twojego maila i zapisywał przysyłane faktury:

1. W menu Settings -> Mail Accounts podłącz skrzynkę przez protokół IMAP.
2. W sekcji Mail Rules określ regułę przetwarzania (np. sprawdzaj tylko wiadomości z ostatniego miesiąca i przenoś przetworzone do innego katalogu).
3. Ustaw automatyczne nakładanie tagów na załączniki pochodzące od określonych nadawców.

Skrypty Instalacyjne (Docker Compose)

Poniżej znajdują się skrypty pozwalające na błyskawiczne uruchomienie całego stosu technologicznego w Twoim środowisku.

mkdir -p ~/paperless-stack/{data,media,export,consume,db}
cd ~/paperless-stack

# Kodowanie i strefa czasowa
PAPERLESS_TIME_ZONE=Europe/Warsaw
PAPERLESS_OCR_LANGUAGE=pol+eng

# Dane bazy danych PostgreSQL
POSTGRES_DB=paperless
POSTGRES_USER=paperless
POSTGRES_PASSWORD=TwojeBezpieczneHaslo123!

# Klucz zabezpieczający (zmień na dowolny unikalny ciąg znaków)
PAPERLESS_SECRET_KEY=super_tajny_klucz_generatora_123456

version: "3.8"

services:
  broker:
    image: docker.io/library/redis:7
    restart: unless-stopped
    volumes:
      - redisdata:/data

  db:
    image: docker.io/library/postgres:15
    restart: unless-stopped
    volumes:
      - ./db:/var/lib/postgresql/data
    env_file: docker-compose.env

  gotenberg:
    image: docker.io/gotenberg/gotenberg:8
    restart: unless-stopped
    command:
      - "gotenberg"
      - "--chromium-disable-javascript=true"
      - "--chromium-allow-list=file:///tmp/.*"

  tika:
    image: docker.io/apache/tika:latest
    restart: unless-stopped

  webserver:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    restart: unless-stopped
    depends_on:
      - broker
      - db
      - gotenberg
      - tika
    ports:
      - "8010:8000"
    volumes:
      - ./data:/usr/src/paperless/data
      - ./media:/usr/src/paperless/media
      - ./export:/usr/src/paperless/export
      - ./consume:/usr/src/paperless/consume
    env_file: docker-compose.env
    environment:
      PAPERLESS_REDIS: redis://broker:6379
      PAPERLESS_DBHOST: db
      PAPERLESS_TIKA_ENABLED: 1
      PAPERLESS_TIKA_ENDPOINT: http://tika:9998
      PAPERLESS_TIKA_GOTENBERG_ENDPOINT: http://gotenberg:3000

volumes:
  redisdata:

Uruchom kontenery w tle:

docker compose up -d

Stwórz konto głównego użytkownika (administratora):

docker compose run --rm webserver createsuperuser

Po zakończeniu konfiguracji panel będzie dostępny pod adresem: http://localhost:8010.

 Projekt bazujący na funkcjonalnościach Paperless-ngx. Rok produkcji: 2026.