bentopdf/docs/pt/self-hosting/cloudflare.md

Implantação no Cloudflare Pages

O Cloudflare Pages oferece hospedagem estática rápida e global com largura de banda ilimitada.

Implantação Rápida

1. Acesse o Cloudflare 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:

# 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:

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

# 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

VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build

Ou com Docker:

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 para configurar a assinatura HMAC.