bettersorted Logo
Teknisyen sunucu donanımı üzerinde çalışıyor
Açık kaynak ve teknolojiler

Paperless-ngx kurulumu: Şirketler için Docker ile rehber

YazarMuhamed Alahmed
Yayınlanma tarihi
Okuma süresi3 dk.

Görsel: JESHOOTS.COM / Unsplash

Kısaca açıklanmıştır

Paperless-ngx en kolay Docker Compose ile kurulur: web sunucusu, veritabanı (PostgreSQL), Redis ve isteğe bağlı olarak Office dosyaları için Tika ve Gotenberg. Küçük bir şirket için 4 GB RAM’e sahip bir sunucu yeterlidir. İşletim için belirleyici olanlar veri yedekleme, güncellemeler ve anlamlı bir temel yapıdır.

Paperless-ngx en kolay Docker Compose ile kurarsınız. Kurulum, birden fazla konteynerden oluşur: Paperless-ngx'nin web sunucusu ve bir PostgreSQL veritabanı, Redis kuyruk olarak ve isteğe bağlı olarak Tika ve Gotenberg, böylece Word, Excel ve e-posta dosyaları da işlenebilir. Küçük bir şirket için 2 ila 4 işlemci çekirdeği ve 4 GB bellekli bir sunucu yeterlidir. Kurulum bir saat içinde tamamlanır – asıl çaba veri yedekleme, güncellemeler ve iyi bir temel yapıda yatar.

Bileşen

Görev

Paperless-ngx (Web sunucusu)

Arayüz, metin tanıma (OCR), otomatik atama

PostgreSQL

Meta veriler, etiketler, kullanıcılar için veritabanı

Redis

Arka plan görevleri için kuyruk

Tika (isteğe bağlı)

Office dosyalarından ve e-postalardan metin okur

Gotenberg (isteğe bağlı)

Office dosyalarını PDF'ye dönüştürür

Gereksinimler

  • Linux sunucusu veya sanal makine, örneğin bir Alman barındırma sağlayıcısında ya da kendi ağınızda
  • Docker ve Docker Compose
  • Belgeler için depolama alanı – mevcut tarama hacminizin birkaç katını hesaba katın, çünkü orijinal ve arşiv sürümü saklanır
  • Dışarıdan erişilecekse HTTPS ile bir domain

Altı adımda kurulum

  1. Docker'ı kurun ve Paperless-ngx için bir klasör oluşturun.
  2. Compose dosyasını seçin: Proje, örneğin PostgreSQL ve Tika/Gotenberg ile hazır şablonlar sunar. Alternatif olarak, resmi bir kurulum betiği soruları adım adım yanıtlamayı sağlar.
  3. Ayarları yapın: Saat dilimi, OCR dili Almanca (deu), gizli anahtar, kurulum adresi.
  4. Klasörleri belirleyin: veriler, medya, dışa aktarma ve tarayıcı ya da ağ sürücüsünün bırakacağı giriş klasörü („consume“) için.
  5. Başlatın ve bir yönetici hesabı oluşturun.
  6. HTTPS'yi yapılandırın erişimi açmadan önce bir reverse proxy üzerinden.

İlk kurulum: temel yapı

İlk belgeler gelmeden önce şunu oluşturun: Belge türleri (fatura, sözleşme, teslimat irsaliyesi …), önemli muhataplar ve bazı anahtar kelimeler girin. Ardından fatura posta kutusu için e-posta çekimini ve ilk kuralları ayarlayın. Bunun nasıl göründüğünü gösteriyoruz Paperless-ngx iş akışları ve Paperless-ngx'yi uygulamak.

Veri yedekleme ve güncellemeler

  • Dışa aktarma işlevini kullanın: Paperless-ngx’in belge dışa aktarıcısı, belgeleri meta verileriyle birlikte bir klasöre yedekler – bunu düzenli olarak bir zaman planına göre çalıştırın.
  • Veritabanını yedekleyin: ayrıca PostgreSQL veritabanını.
  • İkinci konum: Yedekleri şifrelenmiş olarak sunucunun dışında saklayın ve geri yüklemeyi test edin.
  • Güncellemeler: yeni sürümleri zamanında yüklemek, önce sürüm notlarını okumak ve bir yedek almak.

Tipik hatalar

  • OCR dili Almanca olarak ayarlanmamış – umlautlar yanlış tanınır.
  • Gelen klasörü uygun ayar olmadan bir ağ sürücüsünde – dosyalar tanınmaz.
  • Medya klasörünün yedeği alınmamış – bir çökmeden sonra belgeler eksik olur.
  • İnternete HTTPS olmadan erişim sağlanmış.

Vergi açısından ilgili belgeler için ayrıca bir süreç dokümantasyonu da gerekir – bkz. Open Source ile GoBD uyumlu arşivleme. Kurulum ve işletimi kendiniz üstlenmek istemiyorsanız, Paperless-ngx sistemini Almanya’daki sunucularda kuruyoruz.

Sıkça sorulan sorular

Paperless-ngx için hangi donanım gerekir?

Küçük bir işletme için 2 ila 4 işlemci çekirdeği ve 4 GB RAM yeterlidir. Metin tanıma daha fazla çekirdekten fayda sağlar; bellek ihtiyacı belge miktarına bağlıdır.

Paperless-ngx'i Docker olmadan kurabilir miyim?

Evet, manuel kurulum mümkündür, ancak kurulum ve güncellemeler daha zahmetlidir. Önerilen yol Docker'dır.

PostgreSQL'e ihtiyacım var mı, yoksa SQLite yeterli mi?

Testler için SQLite yeterlidir. İşletme kullanımında PostgreSQL daha sağlam bir seçenektir.

Paperless-ngx’i nasıl yedeklerim?

Belgeleri ve meta verileri yedekleyen yerleşik belge dışa aktarıcısı ile birlikte, veritabanının da yedeği alınır – şifrelenmiş olarak ikinci bir konumda.

Paperless-ngx e-postaları otomatik olarak alabilir mi?

Evet. Paperless-ngx, posta kutularını IMAP üzerinden alır ve ekleri veya tüm e-postaları kurallara göre arşive aktarır.

Durum: Kasım 2026. Özellikler, lisanslar ve fiyatlar hızla değişir – esas alınması gereken üreticilerin verdiği bilgilerdir.

bettersorted kurucusu Muhamed Alahmed’in portresi
Yazar hakkında

Muhamed Alahmed

10 yılı aşkın BT deneyimimle, yalnızca teknik olarak çalışan değil, aynı zamanda gerçek katma değer sağlayan ve alan açan çözümler geliştiriyorum.

bettersorted hakkında daha fazla bilgi →

Diğer yazılar

Bülten

Yapay zeka konularında güncel kalın

Yapay zeka otomasyonu, teşvikler ve yeni içerikler hakkında kısa güncellemeler — spam yok, dilediğiniz zaman abonelikten çıkabilirsiniz.

Pazarlama platformu olarak Brevo kullanıyoruz. Formu göndererek verilerinin Brevo'nun gizlilik politikası uyarınca aktarılmasını kabul etmiş olursun.

AraYazİletişim formuSEO/GEO Kontrolü