mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 20:02:47 +01:00
155 lines
4.8 KiB
Markdown
155 lines
4.8 KiB
Markdown
# Implantação no Cloudflare Pages
|
|
|
|
O [Cloudflare Pages](https://pages.cloudflare.com) oferece hospedagem estática rápida e global com largura de banda ilimitada.
|
|
|
|
## Implantação Rápida
|
|
|
|
1. Acesse o [Cloudflare Pages](https://dash.cloudflare.com/?to=/:account/pages)
|
|
2. Clique em "Create a project"
|
|
3. Conecte seu repositório do GitHub
|
|
|
|
## Configuração de Build
|
|
|
|
| Configuração | Valor |
|
|
| ---------------------- | --------------- |
|
|
| Framework preset | Nenhum |
|
|
| Build command | `npm run build` |
|
|
| Build output directory | `dist` |
|
|
| Root directory | `/` |
|
|
|
|
## Variáveis de Ambiente
|
|
|
|
Adicione estas em Settings → Environment variables:
|
|
|
|
| Variável | Valor |
|
|
| ----------------------- | --------------------------------------------------- |
|
|
| `NODE_VERSION` | `18` |
|
|
| `SIMPLE_MODE` | `false` (opcional) |
|
|
| `VITE_BRAND_NAME` | Nome de marca personalizado (opcional) |
|
|
| `VITE_BRAND_LOGO` | Caminho do logotipo relativo a `public/` (opcional) |
|
|
| `VITE_FOOTER_TEXT` | Texto personalizado de rodapé/copyright (opcional) |
|
|
| `VITE_DEFAULT_LANGUAGE` | Idioma padrão da interface, p. ex. `fr` (opcional) |
|
|
|
|
## Arquivo de Configuração
|
|
|
|
Crie `_headers` na sua pasta `public`:
|
|
|
|
```
|
|
# 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 Importante
|
|
Os cabeçalhos `Cross-Origin-Embedder-Policy` e `Cross-Origin-Opener-Policy` são necessários para as conversões de Word/ODT/Excel/PowerPoint para PDF. Sem eles, o `SharedArrayBuffer` fica indisponível e o mecanismo LibreOffice WASM não consegue inicializar.
|
|
:::
|
|
|
|
Crie `_redirects` para o roteamento SPA:
|
|
|
|
```
|
|
/* /index.html 200
|
|
```
|
|
|
|
## Domínio Personalizado
|
|
|
|
1. Acesse seu projeto no Pages
|
|
2. Clique em "Custom domains"
|
|
3. Adicione seu domínio
|
|
4. O Cloudflare configura o DNS automaticamente se o domínio estiver no Cloudflare
|
|
|
|
## Vantagens
|
|
|
|
- **Largura de banda ilimitada e gratuita**
|
|
- **CDN global** com mais de 300 locais de borda
|
|
- **HTTPS automático**
|
|
- **Implantações de pré-visualização** para pull requests
|
|
- **Builds rápidos**
|
|
|
|
## Solução de Problemas
|
|
|
|
### Upload de Arquivos Grandes
|
|
|
|
O Cloudflare Pages aceita arquivos de até 25 MB. Os módulos WASM devem funcionar bem, mas se você atingir os limites, considere:
|
|
|
|
```bash
|
|
# Split large files during build
|
|
npm run build
|
|
```
|
|
|
|
### Limites de Tamanho do Worker
|
|
|
|
Se você usa o Cloudflare Workers para roteamento avançado, observe o limite de 1 MB nos planos gratuitos.
|
|
|
|
## Worker de Proxy CORS (para Assinaturas Digitais)
|
|
|
|
A ferramenta de Assinatura Digital exige um proxy CORS para buscar cadeias de certificados. Implante o worker incluído:
|
|
|
|
```bash
|
|
cd cloudflare
|
|
npx wrangler login
|
|
npx wrangler deploy
|
|
```
|
|
|
|
### Recursos de Segurança
|
|
|
|
| Recurso | Descrição |
|
|
| -------------------------------- | -------------------------------------- |
|
|
| **Restrições de URL** | Apenas URLs de certificados permitidas |
|
|
| **Limite de Tamanho de Arquivo** | Máx. 10MB por requisição |
|
|
| **Limitação de Taxa** | 60 req/IP/min (requer KV) |
|
|
| **Bloqueio de IP Privado** | Bloqueia localhost e IPs internos |
|
|
|
|
### Ativar Limitação de Taxa
|
|
|
|
```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
|
|
```
|
|
|
|
### Compile com a URL do Proxy
|
|
|
|
```bash
|
|
VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build
|
|
```
|
|
|
|
Ou com 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 .
|
|
```
|
|
|
|
> **Observação:** Veja o [README](https://github.com/alam00000/bentopdf#digital-signature-cors-proxy-required) para configurar a assinatura HMAC.
|