Autoalojamiento con Paperclip: Gestión Documental en tu Propio VPS

Autoalojamiento con Paperclip: Gestión Documental en tu Propio VPS

Para quienes trabajan con documentos sensibles — contratos, facturas, historiales médicos, materiales de investigación — confiarlos a un SaaS en la nube es un acto de fe que quizás prefiertas evitar. Paperclip es un sistema de gestión documental autoalojado que te da control total sobre cada byte de tu biblioteca documental.

Este artículo explica qué hace bien Paperclip, para quién es, cómo desplegarlo en un VPS y cómo integrarlo en un flujo de trabajo autoalojado más amplio.

Qué distingue a Paperclip

La mayoría de gestores de archivos autoalojados (Nextcloud, Seafile) son soluciones de almacenamiento cloud de propósito general. Paperclip está diseñado específicamente para la gestión documental: la ingesta, el OCR, los metadatos y la recuperación son el núcleo, no la sincronización o el intercambio de archivos.

Diferencias clave:

• OCR en la ingesta: cada PDF o imagen que subes se procesa automáticamente con OCR y se vuelve buscable.
• Diseño metadatos-first: título, fecha, corresponsal, tipo de documento, etiquetas — todos campos estructurados, no solo nombres de archivo.
• Importación masiva: deja cientos de archivos en una carpeta vigilada, Paperclip los procesa automáticamente.
• Reglas de retención: establece políticas de eliminación o archivado automáticas por tipo de documento.

Para quién es Paperclip

• Freelances y autónomos: organiza facturas, contratos y documentos fiscales con OCR automático y etiquetado.
• Equipos pequeños: repositorio documental compartido con controles de acceso y búsqueda de texto completo.
• Entusiastas del homelab: sustituye una jerarquía de carpetas en NAS/VPS por una base de datos documental buscable y etiquetada.
• Usuarios preocupados por la privacidad: ningún proveedor cloud tiene acceso a tus documentos.

Requisitos de VPS

Proveedores recomendados:

• Hetzner Cloud — 4,15 €/mes, 2 vCPU, 4 GB de RAM — mejor opción global para usuarios EU
• Contabo VPS — 5,99 €/mes, 4 vCPU, 8 GB de RAM, 200 GB de almacenamiento — mejor para archivos grandes

Guía de configuración completa

1. Instalar Docker

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

2. Desplegar Paperclip con Docker Compose

Crea /opt/paperclip/docker-compose.yml:

version: "3.8"

services:
  paperclip:
    image: paperclip/paperclip:latest
    container_name: paperclip
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - paperclip_data:/data
      - /mnt/documentos:/watch  # carpeta vigilada opcional
    environment:
      - PAPERCLIP_SECRET_KEY=tu_clave_aleatoria_aqui
      - PAPERCLIP_OCR_ENABLED=true
      - PAPERCLIP_OCR_LANGUAGE=spa  # para documentos en español

volumes:
  paperclip_data:

Iniciar la stack:

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

3. Exponer vía HTTPS

Con Caddy para TLS automático:

apt install caddy -y

/etc/caddy/Caddyfile:

docs.tudominio.es {
    reverse_proxy localhost:8080
}

systemctl reload caddy

4. Configurar tipos de documentos

En la interfaz web de Paperclip, define tipos de documentos (ej.: “Factura”, “Contrato”, “Recibo”) y asigna reglas de almacenamiento. La recuperación será mucho más rápida que basarse solo en nombres de archivo.

5. Configurar una carpeta vigilada

Monta una carpeta local de tu VPS en el volumen /watch. Cualquier archivo depositado allí se ingesta automáticamente, se procesa con OCR y se añade a la biblioteca — ideal para importaciones masivas o flujos de trabajo automatizados.

Integraciones y extensiones

Flujo de trabajo sin papel: combina Paperclip con una aplicación de escaneo (Scanbot, Adobe Scan) que envíe directamente a la bandeja de entrada de Paperclip por email o carga — pipeline completamente automatizado del papel al digital buscable.

Copia de seguridad en S3: usa rclone para sincronizar tu volumen de datos de Paperclip con Backblaze B2 o cualquier bucket compatible S3:

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

Nginx Proxy Manager: si ya usas NPM en tu VPS, apunta simplemente un proxy host a paperclip:8080 y activa Let’s Encrypt desde la GUI.

Authentik / Authelia: añade SSO delante de Paperclip con un proveedor de identidad para instalaciones multiusuario.

Consejos de mantenimiento

• Actualizaciones regulares: docker compose pull && docker compose up -d
• Monitorizar el espacio en disco: la salida OCR y las miniaturas crecen con el tiempo — configura alertas con df -h
• Hacer copia de seguridad del volumen de datos antes de cualquier actualización
• Ajuste de PostgreSQL: para bibliotecas grandes, incrementa work_mem y max_connections en postgresql.conf

Resumen

Paperclip es uno de los gestores documentales autoalojados mejor mantenidos disponibles. Para un despliegue en VPS, Hetzner Cloud cubre a la mayoría de usuarios a 4,15 €/mes. Si necesitas almacenamiento serio para un gran archivo documental, Contabo ofrece 200 GB NVMe a 5,99 €/mes.

La combinación de simplicidad Docker, OCR por defecto y organización basada en metadatos convierte a Paperclip en un sustituto convincente de los servicios documentales en la nube.

Ver también: Comparativa completa de VPS en selfhostvps.com