Paperclip ile Kendi Kendine Barındırma: Belge Yönetimi Kendi VPS'nizde

Paperclip ile Kendi Kendine Barındırma: Belge Yönetimi Kendi VPS’nizde

Gizli belgeleri - sözleşmeler, faturalar, tıbbi kayıtlar, araştırma materyalleri - yöneten herkes için, bunları bir bulut SaaS’e teslim etmek güven açısından riskli olabilir. Paperclip, her baytını senin kontrolünde tutabileceğin kendi kendine barındırılan bir belge yönetim sistemidir.

Bu makale, Paperclip’in ne iyi yaptığı, kime uygun olduğu, VPS üzerinde nasıl dağıtılacağı ve daha geniş bir kendi kendine barındırılan çalışma akışına nasıl entegre edileceği hakkında bilgiler içerir.

Paperclip’i Diğerlerinden Ayıran Özellikler

Çoğu kendi kendine barındırılan dosya yöneticisi (Nextcloud, Seafile) genel amaçlı bulut depolama sistemleridir. Paperclip ise belge yönetimi için özel olarak tasarlanmıştır: giriş, OCR, meta veri ve erişim üzerine odaklanır; senkronizasyon veya dosya paylaşımından çok.

Ana farklar:

• Giriş sırasında OCR: Yüklediğiniz her PDF veya resim otomatik OCR işlemi ile erişilebilir hale gelir.
• Meta veri odaklı tasarım: Başlık, tarih, muhatap, belge tipi, etiketler - bunlar sadece dosya adı değil, yapılandırılmış alanlardır.
• Toplu içe aktarma: Yüzlerce dosyayı gözlenen bir klasöre bırakın, Paperclip otomatik olarak işler.
• Saklama kuralları: Belge türüne göre otomatik silme veya arşivleme politikaları belirleyin.

Kimler Paperclip Kullanmalı

• Serbest çalışanlar ve taşeronlar: Faturaları, sözleşmeleri ve vergi belgelerini otomatik OCR ve etiketleme ile düzenleyin.
• Küçük takımlar: Erişim kontrolleri ve tam metin arama özellikli ortak belge deposu.
• Homelab kullanıcıları: NAS/VPS üzerindeki klasör hiyerarşisini, aranabilir ve etiketlenmiş belge veritabanıyla değiştirin.
• Gizlilik bilincine sahip kullanıcılar: Belgelerinize hiç bir bulut sağlayıcısı erişemez.

VPS Gereksinimleri

Paperclip, giriş seviyesi bir VPS için yeterince hafiftir:

Tavsiye edilen sağlayıcılar:

• Hetzner Cloud - €4.15/ay, 2 vCPU, 4GB RAM - AB kullanıcıları için en iyi genel kullanım
• Contabo VPS - €5.99/ay, 4 vCPU, 8GB RAM, 200GB depolama - büyük arşiviniz varsa en uygunu

Tam Kurulum Kılavuzu

1. Docker’ı Kurun

curl -fsSL https://get.docker.com | sh
systemctl enable --now docker

2. Docker Compose ile Paperclip’i Dağıtın

/opt/paperclip/docker-compose.yml dosyasını oluşturun:

version: "3.8"

services:
  paperclip:
    image: paperclip/paperclip:latest
    container_name: paperclip
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - paperclip_data:/data
      - /mnt/documents:/watch  # isteğe bağlı izleme klasörü
    environment:
      - PAPERCLIP_SECRET_KEY=buraya_rastgele_bir_secret_yazın
      - PAPERCLIP_OCR_ENABLED=true
      - PAPERCLIP_OCR_LANGUAGE=eng  # diğer diller için değiştirin

volumes:
  paperclip_data:

Kümesini başlatın:

cd /opt/paperclip && docker compose up -d

3. HTTPS Üzerinden Erişim

Otomatik TLS için Caddy kullanın:

apt install caddy -y

/etc/caddy/Caddyfile:

docs.yourdomain.com {
    reverse_proxy localhost:8080
}

systemctl reload caddy

4. Belge Türlerini Yapılandırın

Paperclip web arayüzünde belge türlerini (ör. “Fatura”, “Sözleşme”, “Makbuz”) tanımlayın ve depolama kuralları atayın. Bu, erişimi dosya adlarına göre çok daha hızlı hale getirir.

5. İzleme Klasörü Kurun

VPS üzerinizdeki yerel bir klasörü /watch mount noktasına işaret edin. Buraya bırakılan dosyalar otomatik olarak işlenir, OCR yapılır ve kütüphaneye eklenir - toplu içe aktarım veya otomatik çalışma akışları için idealdir.

Entegrasyonlar ve Eklentiler

Paperless tarzı çalışma akışı: Paperclip’i, tarayıcı uygulaması (Scanbot, Adobe Scan) ile birleştirin. Tarayıcı uygulaması, doğrudan Paperclip’in gelen kutusuna e-posta veya yükleme yapar, böylece tam otomatik bir kağıt-dijital arşiv akışı sağlar.

S3’e yedekleme: rclone kullanarak Paperclip veri hacminizi Backblaze B2 veya başka bir S3 uyumlu buluta yedekleyin:

rclone sync /var/lib/docker/volumes/paperclip_data/_data remote:paperclip-backup

Nginx Proxy Manager: VPS’nizde zaten çalışan bir NPM varsa, bir proxy anahtarı belirleyin ve GUI’den Let’s Encrypt’i etkinleştirin.

Authentik / Authelia: Çok kullanıcılı kurulumlar için SSO ekleyin, kimlik sağlayıcısı ile giriş yapmayı sağlayın.

Bakım Tavsiyeleri

• Güncellemeleri düzenli yapın: docker compose pull && docker compose up -d
• Disk kullanımını izleyin: OCR çıktısı ve küçük resimler zamanla artar - df -h uyarılarını ayarlayın
• Veri hacmini yedekleyin: Her güncellemeden önce veri hacmini yedekleyin
• PostgreSQL ayarlarını optimize edin: Büyük kütüphaneler için postgresql.conf içinde work_mem ve max_connections değerlerini artırın

Özet

Paperclip, en iyi bakımı yapılan kendi kendine barındırılan belge yöneticilerinden biridir. VPS dağıtımı için Hetzner Cloud çoğu kullanıcı için €4.15/ay, büyük belge arşivleri için ise Contabo 200GB NVMe depolama ile €5.99/ay’da hizmet sağlar.

Docker’ın basitliği, varsayılan OCR ve meta veri odaklı organizasyon özellikleri sayesinde Paperclip, bulut tabanlı belge hizmetlerine güçlü bir alternatif sunar.

Ayrıca bakınız: selfhostvps.com’daki tam VPS karşılaştırması