mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 11:52:48 +01:00
155 lines
4.6 KiB
Markdown
155 lines
4.6 KiB
Markdown
# Cloudflare Pages에 배포하기
|
|
|
|
[Cloudflare Pages](https://pages.cloudflare.com)는 대역폭 제한 없이 빠른 글로벌 정적 사이트 호스팅을 제공합니다.
|
|
|
|
## 빠른 배포
|
|
|
|
1. [Cloudflare Pages](https://dash.cloudflare.com/?to=/:account/pages)로 이동합니다
|
|
2. "Create a project"를 클릭합니다
|
|
3. GitHub 저장소를 연결합니다
|
|
|
|
## 빌드 설정
|
|
|
|
| 설정 | 값 |
|
|
| ------------------ | --------------- |
|
|
| 프레임워크 프리셋 | None |
|
|
| 빌드 명령어 | `npm run build` |
|
|
| 빌드 출력 디렉터리 | `dist` |
|
|
| 루트 디렉터리 | `/` |
|
|
|
|
## 환경 변수
|
|
|
|
Settings → Environment variables에서 다음을 추가하세요:
|
|
|
|
| 변수 | 값 |
|
|
| ----------------------- | ------------------------------------- |
|
|
| `NODE_VERSION` | `18` |
|
|
| `SIMPLE_MODE` | `false` (선택) |
|
|
| `VITE_BRAND_NAME` | 사용자 지정 브랜드 이름 (선택) |
|
|
| `VITE_BRAND_LOGO` | `public/` 기준 로고 경로 (선택) |
|
|
| `VITE_FOOTER_TEXT` | 사용자 지정 푸터/저작권 텍스트 (선택) |
|
|
| `VITE_DEFAULT_LANGUAGE` | 기본 UI 언어, 예: `fr` (선택) |
|
|
|
|
## 설정 파일
|
|
|
|
`public` 폴더에 `_headers`를 만드세요:
|
|
|
|
```
|
|
# Required security headers for SharedArrayBuffer (used by LibreOffice WASM)
|
|
/*
|
|
Cross-Origin-Embedder-Policy: require-corp
|
|
Cross-Origin-Opener-Policy: same-origin
|
|
Cross-Origin-Resource-Policy: cross-origin
|
|
|
|
# Pre-compressed LibreOffice WASM binary
|
|
/libreoffice-wasm/soffice.wasm.gz
|
|
Content-Type: application/wasm
|
|
Content-Encoding: gzip
|
|
Cache-Control: public, max-age=31536000, immutable
|
|
|
|
# Pre-compressed LibreOffice WASM data
|
|
/libreoffice-wasm/soffice.data.gz
|
|
Content-Type: application/octet-stream
|
|
Content-Encoding: gzip
|
|
Cache-Control: public, max-age=31536000, immutable
|
|
|
|
# Cache WASM files aggressively
|
|
/*.wasm
|
|
Cache-Control: public, max-age=31536000, immutable
|
|
Content-Type: application/wasm
|
|
|
|
# Service worker
|
|
/sw.js
|
|
Cache-Control: no-cache
|
|
```
|
|
|
|
::: warning 중요
|
|
Word/ODT/Excel/PowerPoint를 PDF로 변환하려면 `Cross-Origin-Embedder-Policy` 및 `Cross-Origin-Opener-Policy` 헤더가 필요합니다. 이 헤더가 없으면 `SharedArrayBuffer`를 사용할 수 없고 LibreOffice WASM 엔진이 초기화되지 못합니다.
|
|
:::
|
|
|
|
SPA 라우팅을 위해 `_redirects`를 만드세요:
|
|
|
|
```
|
|
/* /index.html 200
|
|
```
|
|
|
|
## 사용자 지정 도메인
|
|
|
|
1. Pages 프로젝트로 이동합니다
|
|
2. "Custom domains"를 클릭합니다
|
|
3. 도메인을 추가합니다
|
|
4. 도메인이 Cloudflare에 있으면 Cloudflare가 DNS를 자동으로 설정합니다
|
|
|
|
## 장점
|
|
|
|
- **무료 무제한 대역폭**
|
|
- 300개 이상의 엣지 로케이션을 갖춘 **글로벌 CDN**
|
|
- **자동 HTTPS**
|
|
- 풀 리퀘스트용 **미리보기 배포**
|
|
- **빠른 빌드**
|
|
|
|
## 문제 해결
|
|
|
|
### 대용량 파일 업로드
|
|
|
|
Cloudflare Pages는 최대 25MB 파일을 지원합니다. WASM 모듈은 문제없겠지만 제한에 걸린다면 다음을 고려하세요:
|
|
|
|
```bash
|
|
# Split large files during build
|
|
npm run build
|
|
```
|
|
|
|
### Worker 크기 제한
|
|
|
|
고급 라우팅에 Cloudflare Workers를 사용하는 경우, 무료 플랜에는 1MB 제한이 있다는 점에 유의하세요.
|
|
|
|
## CORS 프록시 Worker (디지털 서명용)
|
|
|
|
디지털 서명 도구는 인증서 체인을 가져오기 위해 CORS 프록시가 필요합니다. 포함된 worker를 배포하세요:
|
|
|
|
```bash
|
|
cd cloudflare
|
|
npx wrangler login
|
|
npx wrangler deploy
|
|
```
|
|
|
|
### 보안 기능
|
|
|
|
| 기능 | 설명 |
|
|
| ------------------ | ------------------------ |
|
|
| **URL 제한** | 인증서 URL만 허용 |
|
|
| **파일 크기 제한** | 요청당 최대 10MB |
|
|
| **속도 제한** | IP당 분당 60회 (KV 필요) |
|
|
| **사설 IP 차단** | localhost, 내부 IP 차단 |
|
|
|
|
### 속도 제한 활성화
|
|
|
|
```bash
|
|
# Create KV namespace
|
|
npx wrangler kv namespace create "RATE_LIMIT_KV"
|
|
|
|
# Add to wrangler.toml with returned ID:
|
|
# [[kv_namespaces]]
|
|
# binding = "RATE_LIMIT_KV"
|
|
# id = "YOUR_ID"
|
|
|
|
npx wrangler deploy
|
|
```
|
|
|
|
### 프록시 URL로 빌드
|
|
|
|
```bash
|
|
VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build
|
|
```
|
|
|
|
또는 Docker로:
|
|
|
|
```bash
|
|
export VITE_CORS_PROXY_URL="https://your-worker.workers.dev"
|
|
DOCKER_BUILDKIT=1 docker build \
|
|
--secret id=VITE_CORS_PROXY_URL,env=VITE_CORS_PROXY_URL \
|
|
-t your-bentopdf .
|
|
```
|
|
|
|
> **참고:** HMAC 서명 설정은 [README](https://github.com/alam00000/bentopdf#digital-signature-cors-proxy-required)를 참고하세요.
|