시작하기

BentoPDF에 오신 것을 환영합니다! 이 가이드로 빠르게 시작해 보세요.

BentoPDF란?

BentoPDF는 브라우저에서 전부 실행되는 무료 오픈소스 개인정보 보호 중심 PDF 도구 모음입니다. 파일이 기기 밖으로 나가지 않으며, 모든 처리는 WebAssembly(WASM) 기술로 로컬에서 이루어집니다.

빠른 시작

옵션 1: 호스팅 버전 사용하기

bentopdf.com에 접속하면 설치 없이 바로 BentoPDF를 사용할 수 있습니다.

옵션 2: Docker로 직접 호스팅하기

IMPORTANT

Office 파일 변환에는 SharedArrayBuffer가 필요하며, 다음이 모두 충족되어야 합니다:

• Cross-Origin-Opener-Policy: same-origin
• Cross-Origin-Embedder-Policy: require-corp
• 보안 컨텍스트

http://localhost는 브라우저가 루프백을 신뢰할 수 있는 주소로 취급하므로 로컬 테스트에서 작동합니다. http://192.168.x.x 같은 LAN IP는 대체로 그렇지 않으므로, 네트워크의 다른 기기에서 접속할 때 Word/Excel/PowerPoint 변환에는 HTTPS가 필요합니다.

# Pull and run the Docker image (self-hosted build)
docker run -d -p 3000:8080 ghcr.io/alam00000/bentopdf-simple:latest

# Or use Docker Compose
curl -O https://raw.githubusercontent.com/alam00000/bentopdf/main/docker-compose.yml
docker compose up -d

TIP

BentoPDF는 두 가지 빌드로 제공됩니다. 위에서 사용한 셀프 호스팅 빌드(bentopdf-simple)는 내부/팀/조직 배포용이고, 상용 빌드(bentopdf:latest)는 bentopdf.com 자체와 공개 서비스를 운영하는 상용 라이선스 보유자가 사용합니다. 두 빌드 모두 같은 PDF 도구를 제공하며, 상용 빌드에는 bentopdf.com의 히어로, FAQ, 후기, 푸터가 추가됩니다. 잘 모르겠다면 셀프 호스팅 빌드를 사용하세요.

그런 다음 브라우저에서 http://localhost:3000을 여세요.

NOTE

폐쇄망 OCR 배포를 준비한다면 Tesseract 워커, 코어 런타임, traineddata 파일 외에 OCR 텍스트 레이어 글꼴도 내부에서 호스팅해야 합니다. VITE_OCR_FONT_BASE_URL과 번들된 ocr-fonts/ 디렉터리를 포함한 전체 설정은 셀프 호스팅에 문서화되어 있습니다.

옵션 3: 소스에서 빌드하기

# Clone the repository
git clone https://github.com/alam00000/bentopdf.git
cd bentopdf

# Install dependencies
npm install

# Start development server
npm run dev

한눈에 보는 기능

카테고리	도구
PDF로 변환	Word, Excel, PowerPoint, 이미지, Markdown, EPUB, MOBI 등
PDF에서 변환	JPG, PNG, 텍스트, Excel, SVG 등
편집 및 주석	서명, 하이라이트, 민감 정보 삭제, 양식 작성, 스탬프 추가
정리	병합, 분할, 회전, 페이지 삭제, 순서 변경
최적화	압축, 복구, 평탄화, OCR
보안	암호화, 복호화, 제한 해제

브라우저 지원

BentoPDF는 최신 브라우저에서 가장 잘 작동합니다:

• ✅ Chrome/Edge 90+
• ✅ Firefox 90+
• ✅ Safari 15+

다음 단계

• 모든 도구 살펴보기
• BentoPDF 직접 호스팅하기
• 프로젝트에 기여하기