무료 온라인 PDF 변환 사이트에 계약서나 신분증 스캔본을 업로드해본 적이 있다면, 그 파일이 어느 서버에 얼마나 오래 저장되는지 정확히 알고 있는 사람은 드뭅니다. Stirling-PDF는 병합·분할·압축·OCR·워터마크·전자서명까지 50가지가 넘는 PDF 작업을 웹 UI 하나로 제공하면서도, 모든 처리가 내가 운영하는 서버 안에서 끝나는 오픈소스 도구입니다. 그렇다면 Stirling-PDF로 셀프호스팅 PDF 편집 툴을 어떻게 만들 수 있을까요?
Stirling-PDF는 무엇인가
Stirling-PDF는 PDF 병합, 분할, 압축, 변환, OCR, 워터마크, 전자서명 등 실무에서 자주 쓰이는 PDF 작업을 하나의 웹 애플리케이션에서 처리할 수 있게 해주는 올인원 오픈소스 도구예요. 온라인에 흩어진 개별 PDF 도구 사이트를 여러 개 오가며 작업하는 대신, 하나의 로컬 웹 UI에서 필요한 작업을 골라 쓸 수 있다는 게 핵심이에요. Java 기반의 백엔드가 Docker 컨테이너 하나로 배포되기 때문에 설치도 간단한 편이에요.
온라인 PDF 도구의 진짜 문제
무료 온라인 PDF 변환 사이트 대부분은 광고 수익이나 사용자 데이터로 운영비를 충당해요. 파일을 업로드하는 순간 그 문서는 정체를 알 수 없는 제3자 서버로 전송되고, 처리가 끝난 뒤에도 실제로 삭제됐는지 확인할 방법이 없어요. 계약서, 급여명세서, 신분증 스캔본처럼 민감한 정보가 담긴 문서라면 이 위험은 더 커져요. Stirling-PDF는 이 모든 처리를 내가 통제하는 서버 안에서 끝내기 때문에 파일이 애초에 내 네트워크를 벗어나지 않아요. 프라이버시가 걱정돼서 온라인 도구를 꺼렸던 사람이라면, 이 지점 하나만으로도 셀프호스팅으로 넘어올 이유가 충분해요.
설치하기
Stirling-PDF는 별도의 데이터베이스나 외부 의존성 없이 컨테이너 하나로 바로 실행할 수 있어요.
services:
stirling-pdf:
image: frooodle/s-pdf:latest
ports:
- "8080:8080"
environment:
- DOCKER_ENABLE_SECURITY=false
- LANGS=ko_KR,en_US
volumes:
- stirling_data:/usr/share/tessdata
- stirling_config:/configs
restart: unless-stopped
volumes:
stirling_data:
stirling_config:
컨테이너를 올린 뒤 8080 포트로 접속하면 바로 웹 UI가 뜨고, 로그인 없이 바로 사용할 수도 있고 DOCKER_ENABLE_SECURITY 값을 켜서 사용자 인증을 붙일 수도 있어요. 여러 사람이 함께 쓰는 환경이라면 계정 기능을 켜두는 게 안전해요.
자주 쓰는 기능들
Stirling-PDF가 제공하는 기능은 대부분 실무에서 반복적으로 필요한 작업들로 구성돼 있어요.
- 병합/분할: 여러 PDF를 하나로 합치거나, 특정 페이지 범위만 잘라내 새 파일로 만들 수 있어요.
- 압축: 이미지가 많이 포함된 PDF의 용량을 줄여서 이메일 첨부나 업로드 용량 제한을 맞출 수 있어요.
- OCR 텍스트 인식: 스캔된 이미지 PDF에 텍스트 레이어를 추가해서 검색과 복사가 가능하게 만들어줘요.
- 워터마크와 전자서명: 문서에 워터마크를 삽입하거나 전자서명을 추가할 수 있어요.
- 포맷 변환: PDF를 Word, 이미지 등 다른 포맷으로 바꾸거나 반대로 변환해올 수 있어요.
문서 관리 워크플로우에 끼워넣기
Stirling-PDF는 단독으로도 쓸모가 있지만, Paperless-ngx로 종이 문서를 디지털화하는 워크플로우와 함께 두면 진가가 더 드러나요. 스캐너로 문서를 스캔한 뒤 Stirling-PDF의 OCR 기능으로 텍스트 레이어를 먼저 입히고, 필요하면 여러 장으로 나뉜 스캔본을 병합해서 Paperless-ngx로 넘기는 식으로 파이프라인을 구성할 수 있어요. 두 도구 모두 셀프호스팅이라 이 과정 전체에서 문서가 외부 서버를 거치지 않는다는 점도 자연스럽게 이어져요.
결론
계약서를 온라인 변환 사이트에 올리기 전 한 번 더 망설이게 만드는 그 찜찜함을, Stirling-PDF는 처리 전체를 내 서버 안에 가둬버리는 방식으로 없애줘요. 50가지가 넘는 기능을 하나의 Docker 컨테이너로 갖출 수 있고, Paperless-ngx와 엮으면 스캔부터 OCR, 아카이빙까지 이어지는 문서 관리 워크플로우를 완전히 로컬 환경 안에서 완성할 수 있어요.
자주 묻는 질문
Q1. 온라인 PDF 변환 사이트와 뭐가 다른가요?
가장 큰 차이는 파일이 내 서버를 벗어나지 않는다는 점이에요. 온라인 사이트는 업로드한 파일을 정체를 알 수 없는 서버에 보내 처리하지만, Stirling-PDF는 내가 직접 운영하는 서버 안에서 모든 처리가 끝나요.
Q2. PDF 병합, 분할 말고 다른 기능도 있나요?
네, 압축, OCR 텍스트 인식, 워터마크 삽입, 전자 서명, 페이지 회전, 포맷 변환까지 50가지가 넘는 기능을 하나의 도구에서 제공해요.
Q3. OCR로 스캔한 문서도 검색 가능하게 만들 수 있나요?
네, Stirling-PDF의 OCR 기능은 이미지로 스캔된 PDF에 텍스트 레이어를 추가해서, 스캔본이어도 키워드로 검색하거나 텍스트를 복사할 수 있게 만들어줘요.
Q4. 설치가 복잡한가요?
아니요, Docker 이미지 하나로 실행할 수 있고 별도의 데이터베이스나 외부 의존성 없이 컨테이너 하나만 띄우면 바로 웹 UI에 접속할 수 있어요.
Q5. 로그인 기능이나 사용자별 권한 관리도 되나요?
네, Stirling-PDF는 선택적으로 로그인 기능을 활성화할 수 있고, 여러 사용자가 함께 쓰는 환경이라면 사용자별 접근 권한을 설정할 수도 있어요.
Q6. 민감한 계약서나 개인정보가 담긴 문서도 안전하게 처리할 수 있나요?
네, 모든 처리가 내 서버 안에서 끝나고 외부로 파일이 전송되지 않기 때문에 계약서나 신분증 스캔본처럼 민감한 문서를 다룰 때 특히 안전해요.


