Files
bentopdf/docs/pt/getting-started.md
T

3.6 KiB

Primeiros Passos

Bem-vindo ao BentoPDF! Este guia vai ajudar você a começar rapidamente.

O que é o BentoPDF?

O BentoPDF é um kit de ferramentas PDF gratuito, de código aberto e focado em privacidade, que funciona inteiramente no seu navegador. Seus arquivos nunca saem do seu dispositivo: todo o processamento acontece localmente com a tecnologia WebAssembly (WASM).

Início Rápido

Opção 1: Use a Versão Hospedada

Acesse bentopdf.com para usar o BentoPDF na hora, sem instalação.

Opção 2: Hospede por Conta Própria com Docker

Important

A conversão de arquivos do Office requer SharedArrayBuffer, que exige ambos:

  • Cross-Origin-Opener-Policy: same-origin
  • Cross-Origin-Embedder-Policy: require-corp
  • um contexto seguro

http://localhost funciona para testes locais porque os navegadores tratam o loopback como confiável. http://192.168.x.x ou outros IPs de rede local normalmente não funcionam, então as conversões de Word/Excel/PowerPoint exigirão HTTPS quando acessadas de outros dispositivos da sua rede.

# 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

O BentoPDF vem em duas versões: a versão Self-Hosted (bentopdf-simple, usada acima) para implantações internas, de equipes e organizações, e a versão Comercial (bentopdf:latest), usada pelo próprio bentopdf.com e por titulares de licença comercial que mantêm implantações públicas. Ambas incluem as mesmas ferramentas de PDF: a versão Comercial adiciona o hero, o FAQ, os depoimentos e o rodapé do bentopdf.com. Em caso de dúvida, use a versão Self-Hosted.

Depois, abra http://localhost:3000 no seu navegador.

Note

Se você está preparando uma implantação de OCR isolada da internet (air-gapped), é preciso hospedar internamente as fontes da camada de texto do OCR, além do worker do Tesseract, do runtime principal e dos arquivos traineddata. A configuração completa está documentada em Self-Hosting, incluindo VITE_OCR_FONT_BASE_URL e o diretório ocr-fonts/ incluído.

Opção 3: Compile a Partir do Código-Fonte

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

# Install dependencies
npm install

# Start development server
npm run dev

Recursos em Resumo

Categoria Ferramentas
Converter para PDF Word, Excel, PowerPoint, Imagens, Markdown, EPUB, MOBI e mais
Converter de PDF JPG, PNG, Texto, Excel, SVG e mais
Editar e Anotar Assinar, Destacar, Redigir, Preencher Formulários, Adicionar Carimbos
Organizar Mesclar, Dividir, Girar, Excluir Páginas, Reordenar
Otimizar Comprimir, Reparar, Nivelar, OCR
Segurança Criptografar, Descriptografar, Remover Restrições

Suporte a Navegadores

O BentoPDF funciona melhor em navegadores modernos:

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

Próximos Passos