PDF 파일을 외부에 올리지 않아도 됩니다—Stirling-PDF

PDF 파일 하나 변환하려고 iLovePDF나 어도비에 올리다가 괜히 찜찜했던 적 있는가? 그 찜찜함이 오픈소스 시장을 바꾸고 있다. 2026년 6월 23일 하루에만 별 691개가 쏟아지며 Stirling-PDF가 GitHub 트렌딩 정상에 올랐다. 누적 ★82,830개. "PDF 처리 = 남의 서버에 파일 올리기"라는 공식이 흔들리고 있다.

이게 뭔가

Stirling-PDF는 PDF 편집·병합·분할·OCR·서명·압축·변환 등 50가지 이상의 기능을 내 컴퓨터나 내 서버에서 직접 돌리는 오픈소스 플랫폼이다. 웹 브라우저 UI로 조작하기 때문에 비개발자도 어렵지 않게 쓴다. 데스크탑 앱, 셀프호스팅 서버, Kubernetes 배포까지 선택지가 다양하다.

핵심 가치는 간단하다. 파일이 외부로 나가지 않는다. 계약서·의료 기록·재무 보고서처럼 민감한 문서를 제3자 서버에 업로드하는 리스크가 사라진다.

왜 지금 뜨는가

세 흐름이 동시에 수렴했다.

1. Adobe 구독 피로: Acrobat Pro 구독료가 꾸준히 오르면서 "공짜 대안" 수요가 임계점을 넘었다.
2. 데이터 주권 의식: GDPR·국내 개인정보보호법 강화로 기업·기관이 외부 서비스에 내부 문서를 맡기는 것을 꺼리기 시작했다. 법무·의료·금융 업계에선 이미 규정상 불가인 경우도 있다.
3. Docker 대중화: "내 서버에 설치"의 진입 장벽이 명령어 한 줄로 사실상 사라졌다. 비개발자도 NAS나 홈 서버에 띄울 수 있는 시대다.

핵심 기능

• 50+ PDF 도구: 병합, 분할, 압축, OCR, 서명, 편집, Word·Excel·이미지 변환, 워터마크, 암호화
• 노코드 자동화 파이프라인: UI에서 드래그·드롭으로 워크플로 구성, 수백만 건 처리도 가능
• REST API 전면 개방: 거의 모든 도구에 API가 열려 있어 기존 시스템 통합 가능
• 40개 이상 언어 UI: 한국어 포함
• 엔터프라이즈 옵션: SSO, 감사 로그, 온프레미스 배포 (유료 플랜)

누구에게 쓸모 있나

대상	활용 포인트
개인 사용자	민감 문서 로컬 처리, 어도비 구독 없이 PDF 편집
중소기업	SaaS 구독비 절감, 사내 PDF 처리 서버 구축
법무·의료·금융	외부 서버 미전송 규정 준수
개발자	REST API로 PDF 처리 파이프라인 자동화

시작하기

공식 README 기준, 가장 빠른 시작은 Docker 한 줄이다.

docker run -p 8080:8080 docker.stirlingpdf.com/stirlingtools/stirling-pdf

실행 후 브라우저에서 http://localhost:8080 접속하면 끝이다. 데스크탑 앱·Kubernetes 배포는 공식 문서를 참고한다.

사용 예시

① 포트 충돌 시 포트 변경

# 로컬 8080이 이미 사용 중이면 왼쪽 숫자만 바꾼다
docker run -p 9090:8080 docker.stirlingpdf.com/stirlingtools/stirling-pdf

② 설정·데이터 영속 보존 (볼륨 마운트)

docker run -p 8080:8080 \
  -v ./stirling-configs:/configs \
  -v ./stirling-logs:/logs \
  docker.stirlingpdf.com/stirlingtools/stirling-pdf

컨테이너를 재시작해도 설정·로그가 로컬에 남는다.

③ REST API로 PDF 병합 자동화

# API 엔드포인트는 공식 문서(https://registry.scalar.com/@stirlingpdf/apis/)에서 확인
curl -X POST http://localhost:8080/api/v1/general/merge-pdfs \
  -F "fileInput=@report1.pdf" \
  -F "fileInput=@report2.pdf" \
  --output merged.pdf

두 PDF를 병합해 merged.pdf로 저장. CI/CD나 사내 자동화 스크립트에 바로 붙인다.

한계·주의

• 라이선스 불명확: 레포 라이선스가 NOASSERTION으로 표기돼 있다. 상업적 사용 전 레포 내 LICENSE 파일을 반드시 직접 확인해야 한다. 엔터프라이즈 기능 일부는 유료다.
• OCR은 Tesseract 기반: 복잡한 레이아웃·손글씨·저해상도 스캔에선 인식 정확도가 떨어질 수 있다. 고정밀 OCR이 필요하다면 별도 엔진 도입을 검토하라.
• 리소스 사용량 주의: 대용량 PDF 일괄 처리 시 메모리 사용량이 상당히 오른다. 개인 사용엔 문제없지만 팀 단위 배포 시 서버 스펙을 여유 있게 잡아야 한다.

한 줄 요약: 파일 보안이 중요하거나 어도비 구독료가 아깝다면, Docker 한 줄로 내 서버에 PDF 팀을 고용하는 셈이다.