Paperless-NGX AI (업데이트 버전)

tony — Sat, 04 Oct 2025 16:00:37 +0000

Paperless 도커에서 한단계 더 진화한 AI 기능

문서를 디지털화하고 관리하는 것은 현대 업무 환경에서 필수가 되었습니다. 이번에는 Paperless-NGX에 AI 기능을 추가하여 문서 관리를 한 단계 더 발전시킨 설정을 소개합니다

Paperless-NGX란?

Paperless-NGX는 종이 문서를 스캔하고 디지털화하여 관리할 수 있는 오픈소스 문서 관리 시스템입니다. OCR(광학 문자 인식) 기술을 활용해 스캔한 문서를 검색 가능한 형태로 저장하고, 태그와 메타데이터로 체계적으로 정리할 수 있습니다.

AI 기능의 추가: 무엇이 달라졌나?

이번 업데이트의 핵심은 paperlessngx-ai 컨테이너의 추가입니다. 이 서비스는 OpenAI API를 활용하여 문서에 자동으로 태그를 지정하고, 문서의 내용을 분석하여 적절한 분류를 제안합니다.

AI 기능의 장점

자동 태그 지정의 편리함
문서를 업로드하면 AI가 내용을 분석하여 자동으로 관련 태그를 제안합니다. 수백 개의 문서를 일일이 분류하던 시간을 대폭 줄일 수 있습니다. 청구서, 계약서, 영수증 등 문서 유형을 자동으로 파악하고 적절한 카테고리에 배치합니다.

향상된 검색 기능
AI가 문서의 맥락을 이해하기 때문에, 단순 키워드 검색을 넘어 의미 기반 검색이 가능합니다. “지난해 전기 요금 관련 문서”처럼 자연어로 검색할 수 있는 기반이 마련됩니다.

미래 지향적 접근
AI를 활용한 문서 관리는 이제 선택이 아닌 필수가 되어가고 있습니다. 이런 방식이 앞으로 문서 관리의 표준이 될 것으로 예상됩니다.

Docker Compose 구성 분석

핵심 서비스 구성

이번 설정은 4개의 주요 서비스로 구성됩니다:

Redis (캐시 및 작업 큐)
세션 데이터와 작업 큐를 관리하는 인메모리 데이터베이스입니다. 512MB의 메모리 제한으로 효율적으로 운영되며, 비밀번호 인증을 통해 보안을 강화했습니다.

PostgreSQL (데이터베이스)
문서 메타데이터, 사용자 정보, 태그 등 모든 구조화된 데이터를 저장합니다. 1GB 메모리 할당으로 안정적인 데이터베이스 운영을 보장합니다.

Paperless-NGX (메인 애플리케이션)
문서 처리와 OCR의 핵심 서비스입니다. 6GB의 메모리를 할당하여 대용량 문서 처리가 가능하며, 다양한 볼륨 마운트를 통해 문서를 체계적으로 관리합니다.

Paperless-AI (새로운 AI 서비스)
OpenAI API를 활용한 자동 태그 지정 및 문서 분석 서비스입니다. Paperless-NGX와 연동되어 문서가 업로드되면 자동으로 분석을 시작합니다.

주목할 만한 설정

파일명 자동 정리

PAPERLESS_FILENAME_FORMAT: '{{ created_year }}/{{ correspondent }}/{{ document_type }}/{{ title }}'

이 설정은 문서를 연도별, 발신자별, 문서 유형별로 자동 분류하여 저장합니다. 나중에 파일을 직접 찾아야 할 때도 쉽게 찾을 수 있습니다.

AI 서비스 환경 변수
OpenAI API 키와 모델 설정을 통해 원하는 수준의 AI 분석을 구성할 수 있습니다. GPT-4를 사용하면 더 정확한 분석이 가능하지만, GPT-3.5-turbo로도 충분히 유용한 결과를 얻을 수 있습니다.

실제 사용 경험과 기대

종이 없는 환경의 실현

더 이상 서랍 가득한 서류 더미를 뒤적일 필요가 없습니다. 스캔만 하면 모든 문서가 디지털화되고, AI가 자동으로 정리해줍니다. 필요한 문서는 몇 초 만에 검색할 수 있습니다.

현재의 한계와 미래의 가능성

아직 AI 태그 지정이 100% 완벽하지는 않습니다. 특히 전문적인 기술 문서나 특수한 형식의 문서에서는 수동 보정이 필요할 수 있습니다. 하지만 다음과 같은 개선이 이루어진다면 더욱 강력한 도구가 될 것입니다:

학습 기능: 사용자의 수정 내역을 학습하여 점점 더 정확한 태그 제안
다국어 지원 강화: 한국어 문서 분석 정확도 향상
문서 간 연관성 분석: 관련 문서를 자동으로 연결
요약 기능: 긴 문서의 핵심 내용 자동 추출

시작하기

기본적인 구성은 이렇게 설정하였는데 개인의 맞게 변형하시면 좋겠습니다.

version: “3.9”

networks:

paper_net:

driver: bridge

services:

redis:

image: redis:8

command:

– /bin/sh

– -c

– redis-server –requirepass redispass

container_name: PaperlessNGX-REDIS

hostname: paper-redis

mem_limit: 512m

mem_reservation: 256m

cpu_shares: 768

security_opt:

– no-new-privileges:true

read_only: true

user:

healthcheck:

test: [“CMD-SHELL”, “redis-cli ping || exit 1”]

volumes:

– /volume1/docker/paperlessngx/redis:/data:rw

environment:

TZ: America/Chicago

restart: unless-stopped

networks:

– paper_net

db:

image: postgres:17

container_name: PaperlessNGX-DB

hostname: paper-db

mem_limit: 1g

cpu_shares: 768

security_opt:

– no-new-privileges:true

healthcheck:

test: [“CMD”, “pg_isready”, “-q”, “-d”, “paperless”, “-U”, “paperlessuser”]

timeout: 45s

interval: 10s

retries: 10

volumes:

– /volume1/docker/paperlessngx/db:/var/lib/postgresql/data:rw

environment:

POSTGRES_DB:

POSTGRES_USER:

POSTGRES_PASSWORD:

restart: unless-stopped

networks:

– paper_net

paperless:

image: ghcr.io/paperless-ngx/paperless-ngx:latest

container_name: PaperlessNGX

hostname: paperless-ngx

mem_limit: 6g

cpu_shares: 1024

security_opt:

– no-new-privileges:true

healthcheck:

test: [“CMD”, “curl”, “-fs”, “-S”, “–max-time”, “2”, “http://localhost:8000”]

interval: 30s

timeout: 10s

retries: 5

ports:

– 8777:8000

volumes:

– /volume2/docker/paperlessngx/data:/usr/src/paperless/data:rw

– /volume2/docker/paperlessngx/media:/usr/src/paperless/media:rw

– /volume2/docker/paperlessngx/export:/usr/src/paperless/export:rw

– /volume2/docker/paperlessngx/consume:/usr/src/paperless/consume:rw

– /volume2/docker/paperlessngx/trash:/usr/src/paperless/trash:rw

environment:

PAPERLESS_REDIS: redis://:redispass@paper-redis:6379

PAPERLESS_DBENGINE: postgresql

PAPERLESS_DBHOST: paper-db

PAPERLESS_DBNAME:

PAPERLESS_DBUSER:

PAPERLESS_DBPASS:

PAPERLESS_EMPTY_TRASH_DIR: ../trash

PAPERLESS_FILENAME_FORMAT: ‘{{ created_year }}/{{ correspondent }}/{{ document_type }}/{{ title }}’

PAPERLESS_OCR_ROTATE_PAGES_THRESHOLD: 6

PAPERLESS_TASK_WORKERS: 1

USERMAP_UID:

USERMAP_GID:

PAPERLESS_TIME_ZONE:

PAPERLESS_ADMIN_USER:

PAPERLESS_ADMIN_PASSWORD:

PAPERLESS_URL: http://192.168.1.3:8777

PAPERLESS_CSRF_TRUSTED_ORIGINS:

PAPERLESS_OCR_LANGUAGE: eng

restart: unless-stopped

depends_on:

db:

condition: service_healthy

redis:

condition: service_healthy

networks:

– paper_net

paperlessngx-ai:

image: clusterzx/paperless-ai

container_name: PaperlessNGX-AI

networks:

– paper_net

security_opt:

– no-new-privileges:true

user: “0:0”

ports:

– “3747:3000”

volumes:

– /volume1/docker/paperlessngxai:/app/data:rw

– /volume1/docker/paperlessngxai/logs:/app/logs:rw

– type: tmpfs

target: /root/.pm2

– type: tmpfs

target: /tmp

– type: tmpfs

target: /.pm2

healthcheck:

test: [“CMD-SHELL”, “curl -fsS http://127.0.0.1:3000/ || exit 1”]

interval: 15s

timeout: 5s

retries: 5

start_period: 120s

environment:

TZ: America/Chicago

PM2_HOME: /.pm2

HOME: /tmp

OPENAI_BASE_URL:

OPENAI_API_KEY:

INFERENCE_TEXT_MODEL:

PAPERLESS_API_URL: http://paperless:8000

PAPERLESS_API_TOKEN:

restart: unless-stopped

depends_on:

paperless:

condition: service_started

위의 Docker Compose 파일을 사용하려면 다음 환경 변수들을 설정해야 합니다:

데이터베이스 관련: POSTGRES_DB, POSTGRES_USER, POSTGRES_PASSWORD
Paperless 관리자: PAPERLESS_ADMIN_USER, PAPERLESS_ADMIN_PASSWORD
시스템 설정: USERMAP_UID, USERMAP_GID, PAPERLESS_TIME_ZONE
AI 서비스: OPENAI_API_KEY, OPENAI_BASE_URL, INFERENCE_TEXT_MODEL, PAPERLESS_API_TOKEN

모든 설정이 완료되면 docker-compose up -d 명령으로 서비스를 시작할 수 있습니다.

마무리

Paperless-NGX에 AI 기능을 추가하는 것은 단순한 기능 추가가 아닙니다. 문서 관리 방식 자체를 변화시키는 진화입니다. 자동화된 태그 지정은 시간을 절약하고, 더 나은 검색 경험은 생산성을 높입니다.

아직 완벽하지는 않지만, AI 기술의 발전과 함께 이 시스템도 계속 개선될 것입니다. 종이 없는 환경을 구축하고 싶다면, 지금이 바로 시작할 때입니다.

paperless – Anthony's Life

Paperless-NGX AI (업데이트 버전)

Paperless 도커에서 한단계 더 진화한 AI 기능

Paperless-NGX란?

AI 기능의 추가: 무엇이 달라졌나?

AI 기능의 장점

Docker Compose 구성 분석

핵심 서비스 구성

주목할 만한 설정

실제 사용 경험과 기대

종이 없는 환경의 실현

현재의 한계와 미래의 가능성

시작하기

마무리