mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 20:02:47 +01:00
81 lines
3.6 KiB
Markdown
81 lines
3.6 KiB
Markdown
# 시작하기
|
|
|
|
BentoPDF에 오신 것을 환영합니다! 이 가이드로 빠르게 시작해 보세요.
|
|
|
|
## BentoPDF란?
|
|
|
|
BentoPDF는 **브라우저에서 전부 실행되는** 무료 오픈소스 개인정보 보호 중심 PDF 도구 모음입니다. 파일이 기기 밖으로 나가지 않으며, 모든 처리는 WebAssembly(WASM) 기술로 로컬에서 이루어집니다.
|
|
|
|
## 빠른 시작
|
|
|
|
### 옵션 1: 호스팅 버전 사용하기
|
|
|
|
[bentopdf.com](https://www.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가 필요합니다.
|
|
|
|
```bash
|
|
# 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/` 디렉터리를 포함한 전체 설정은 [셀프 호스팅](/ko/self-hosting/)에 문서화되어 있습니다.
|
|
|
|
### 옵션 3: 소스에서 빌드하기
|
|
|
|
```bash
|
|
# 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+
|
|
|
|
## 다음 단계
|
|
|
|
- [모든 도구 살펴보기](/ko/tools/)
|
|
- [BentoPDF 직접 호스팅하기](/ko/self-hosting/)
|
|
- [프로젝트에 기여하기](/ko/contributing)
|