자체 호스팅이 실제로 사 주는 것과 그 대가
PDF123 자체 호스팅은 업로드를 직접 운영하는 pdfx-server에 두고 같은 REST, MCP, CLI 카탈로그를 그대로 씁니다. SaaS 편의 대신 운영 책임이라는 비용을 치릅니다.
공개 변환기는 익명 일회성 작업에 최적화되어 있습니다. PDF123을 자체 호스팅하면 계약이 달라집니다. 업로드가 직접 운영하는 머신에 남고, 카탈로그의 모든 도구가 브라우저 폼이 아니라 HTTP로도 닿습니다.
무엇을 사는가
첫 번째로 사는 것은 데이터 지역성입니다. 파일이 직접 운영하지 않는 임시 저장소가 아니라 내 pdfx-server에 닿습니다. 두 번째는 같은 머신에 딸린 개발자 표면입니다. /api/v1/… 아래의 REST, /v1/openapi.json의 OpenAPI, /mcp의 MCP, 그리고 내 base URL을 향하는 pdfx --cloud입니다.
Docker Compose는 Rust 백엔드와 Next.js 포털을 함께 띄워 사람과 스크립트가 하나의 카탈로그를 공유하게 합니다. 그 경로에는 데스크톱 설치 프로그램이 없습니다. 오프라인 사용은 Compose와 CLI입니다(자체 호스팅). 로컬 네이티브 작업은 포털 옆에서 task pdfx:dev를, Compose는 task docker:build / task docker:up을 씁니다(API :8080, 포털 :3000).
키를 가진 에이전트나 CI 작업은 공개 사이트와 같은 op를 호출합니다. PDF 병합, PDF 압축, OCR, 변환 등이 같은 경로와 매개변수를 유지합니다. 그 동일함이 제품이고, 구호가 아닙니다.
공개 사이트를 먹여 살리는 광고는 자체 호스팅 배포에 들어가지 않습니다. 호스팅 쪽 익명 할당량 문제도 건너뜁니다. OCR이나 대형 병합 중의 CPU 급증을 포함한 용량 계획이 내 몫이 됩니다. 내 머신에서도 OCR은 Markdown(text/markdown)을 반환합니다. 서버 위치를 옮겨도 op 계약은 바뀌지 않습니다.
무엇을 치르는가
가동 시간, 이미지 업그레이드, 임시 파일용 디스크, TLS, 키 교체를 직접 책임집니다. Compose는 시작은 빠르지만 건강하게 유지하는 일은 계속됩니다. 인스턴스에 고정 API 키 게이트를 두고 싶으면 SECURITY_CUSTOMGLOBALAPIKEY를 설정하세요. 선택 기능(예: SYSTEM_ENABLEURLTOPDF=true로 켜는 URL→PDF)은 의도적으로 켜는 플래그이지, 공개 사이트에 있다는 이유로 따라오는 기본값이 아닙니다.
자체 호스팅이 플래그 하나로 시각적 “Edit PDF” 캔버스를 더해 주지도 않습니다. 표면은 폼 도구와 API로 남습니다. 캔버스 편집이 필요하면 여전히 다른 제품이 필요합니다. 서버를 옮긴다고 그 UI가 생기지 않습니다.
요청 제한과 계량 동작은 그 머신을 어떻게 설정했는지에 따릅니다. 공개 사이트가 알리는 헤더와 상한이 그대로 이식된다고 가정하지 마세요. 예산이 중요하면 내 인스턴스가 돌려주는 헤더를 읽으세요. 의존성이 무거운 op(OCR 모델, 선택적 변환기)는 이미지에 바이너리나 모델 팩이 설치돼 있지 않으면 구조화된 missing_dependency / unavailable problem 코드로 실패합니다.
공개 사이트와의 관계
설정 없이 시험해 보려면 호스팅 PDF123을 쓰세요. 그곳의 카탈로그 도구와 익명 /api/v1/ 호출에는 계정이 필요 없습니다. 응답은 X-RateLimit-*를 알리고, 429 응답에는 Retry-After가 들어 있습니다(익명 요청 제한).
보존 규칙이나 에어갭 네트워크, 사내 자동화가 요구할 때 자체 호스팅하세요. /llms.txt는 어느 base URL에서 운영하든 에이전트가 도구를 찾도록 돕습니다. Google 검색은 이를 순위 신호로 취급하지 않습니다. MCP와 OpenAPI는 그 같은 base에서 포털 옆에 그대로 있습니다.
아직 자체 호스팅하지 말아야 할 때
오늘 오후에 병합 한 번만 하면 된다면 호스팅 폼으로 충분합니다. 내일부터 매일 사적인 바이트가 필요하다면, SaaS 습관에 데스크톱 설치 프로그램을 얹으려 하지 말고 지금 Compose에서 시작하세요. 우리가 지원하는 오프라인 방식은 스토어 등록이 아니라 자체 호스팅에 문서화돼 있습니다.
자체 호스팅에서 시작하세요. 키와 OpenAPI는 개발자에 있습니다. 브라우저 전용 변환기와의 더 짧은 대비는 PDF 툴킷을 자체 호스팅하는 이유를 보세요. 사설 경로가 .exe가 아니라 Compose인 이유는 데스크톱 앱을 만들지 않은 이유를 보세요.