Tutoriais de VPS
Livros no VPS: Kavita, Calibre-Web, OPDS e backups (2026)
Escolha Kavita, Calibre-Web ou Komga, prepare metadados e permissões, proteja instalação e HTTPS, conecte leitores OPDS e confira backups consistentes.

Um servidor de livros reúne a coleção para dispositivos compatíveis e, quando suportado, sincroniza progresso. Complementa as guias de música, vídeo e fotos. Use arquivos legíveis que você pode armazenar; hospedar não remove DRM nem restrições de formato ou aparelho.
Comparamos Calibre-Web, Kavita e Komga e instalamos os dois primeiros, sem presumir idioma, país ou catálogo de metadados.
| Opção | Ponto inicial | Condições |
|---|---|---|
| Calibre-Web | Biblioteca gerenciada pelo Calibre | Exige banco Calibre; conversão, e-mail e Kobo precisam de configuração própria |
| Kavita | Livros/quadrinhos organizados para o scanner | Sem banco Calibre; confira formatos, leitor e metadados atuais |
| Komga | Coleção principalmente de quadrinhos | Confira formatos, integração e recursos JVM |
EPUB, CBZ/CBR, Kobo e conversão dependem da versão: teste arquivos representativos. Calibre oferece conversão ampla (o original descrevia 50+ formatos), sem garantir fidelidade nem remover DRM. RAM ociosa de 80 MB, 150–250 MB e 150 MB+, e estrelas 16.7k/10.1k/6k, eram retratos históricos.
- Já usa Calibre: considere Calibre-Web.
- Livros/quadrinhos avulsos desde zero: considere Kavita.
- Principalmente quadrinhos: considere Komga.
Calibre-Web precisa de metadata.db, não apenas arquivos EPUB.
| Tipo | Tamanho ilustrativo | Orçamento original para 1000 |
|---|---|---|
| EPUB de texto | 1–5 MB | 3–5 GB |
| PDF digitalizado | 20–100 MB | 30–80 GB |
| CBZ | 50–200 MB | 100 GB+ |
Meça sua coleção: são exemplos, sem multiplicação exata garantida. 20 GB podem servir para texto pequeno; quadrinhos/PDF costumam justificar 100 GB ou mais, além de banco, miniaturas e backups. 1 vCPU/2 GB é ponto inicial útil. 1 GB pode atender Kavita leve, mas varreduras e outros serviços exigem margem. Milhares de miniaturas podem consumir CPU/I/O por dezenas de minutos.
books/
├── 刘慈欣/
│ ├── 三体.epub
│ ├── 三体Ⅱ·黑暗森林.epub
│ └── 球状闪电.epub
├── 阿西莫夫/
│ └── 基地.epub
└── 漫画/
└── 进击的巨人/
├── 第01卷.cbz
└── 第02卷.cbz
- Organize subpastas e confira agrupamento por autor/série no scanner.
- Evite amontoar arquivos na raiz sem testar; siga regras do formato e biblioteca.
- Use nomes de autor/série quando úteis, sem presumir que toda pasta seja uma série: metadados EPUB podem determinar isso.
Faça backup dos nomes e teste livros antes de renomear. Unicode/chinês não são universalmente inválidos: preserve títulos e evite colisões.
- Confira parênteses nos exemplos
三体(一).epub,三体_I.epub/三体1.epub. - Teste símbolos
★/【】e emoji no parser real. - Confira numeração
①②/Ⅲantes de alterar.
Para UnauthorizedAccessException, confira UID/GID reais e permissões das pastas. Verifique antes de alterar proprietário: UID 1001 não é universal e mudança recursiva afeta os livros:
sudo chown -R 1001:1001 ~/ebooks/books
Conceda só acesso necessário; monte livros como somente leitura se não precisar de uploads/escrita de metadados.
mkdir -p ~/ebooks/{config,books}
cd ~/ebooks
Crie docker-compose.yml:
services:
kavita:
image: jvmilazz0/kavita:latest
container_name: kavita
restart: unless-stopped
environment:
- TZ=Asia/Shanghai
ports:
- "127.0.0.1:5000:5000"
volumes:
- ./config:/kavita/config
- ./books:/books
Revise e fixe imagem/versão. /kavita/config é o destino de configuração no contêiner; o caminho do host pode mudar pelo volume. Ele guarda SQLite, usuários e ajustes: faça backup.
Vincule a 127.0.0.1. Cadastre primeiro administrador por túnel privado antes de publicar proxy, evitando registro por outro visitante. PUID/PGID são opções específicas da imagem; use chown só após conferir identidade efetiva. Asia/Shanghai no exemplo não é requisito de localização.
docker compose up -d
docker compose logs -f
Acesse http://你的IP:5000 pelo túnel e crie credencial única.
Server Settings → Libraries → Add Library, conforme versão. Book para texto; Manga/Comic oferecem convenções como direção de leitura. Escolha /books, caminho dentro do contêiner.
Separe romances/quadrinhos quando precisarem de ajustes diferentes:
volumes:
- ./config:/kavita/config
- ./novels:/novels
- ./comics:/comics
Espere a varredura, confira agrupamentos e repita após correções. Não presuma classificação recursiva sem conferir a versão.
Comece com metadados EPUB/ComicInfo e edição manual. ComicVine, AniList, MyAnimeList e Google Books do original dependem de integrações, contas ou níveis de serviço; não se garante consulta automática a todos no Kavita básico.
- Confira correspondências por idioma e edição.
- Para obras chinesas, mantenha limites do catálogo e não presuma integração Douban, sem prometer cobertura global.
- Edite título, autor, descrição e capa ou aceite nomes úteis quando faltarem dados.
Organização ajuda mesmo sem enriquecimento automático.
/books deve conter metadata.db e pastas associadas. Pare escritores antes de copiar:
rsync -av ~/Calibre\ 书库/ user@server:~/ebooks/library/
Sem biblioteca, crie uma no Calibre desktop, adicione livro e transfira. calibredb é uma família de comandos para consultar, não um procedimento completo de inicialização sozinho.
Crie docker-compose.yml:
services:
calibre-web:
image: lscr.io/linuxserver/calibre-web:latest
container_name: calibre-web
restart: unless-stopped
environment:
- PUID=1000
- PGID=1000
- TZ=Asia/Shanghai
- DOCKER_MODS=linuxserver/mods:universal-calibre
volumes:
- ./config:/config
- ./library:/books
ports:
- "127.0.0.1:8083:8083"
Ajuste PUID/PGID usando id -u/id -g. Para ambos os produtos, use projetos/configurações separados: exemplos ./config não devem compartilhar estado.
DOCKER_MODS adiciona conversão quando imagem/mod suportarem. Pode levar 2–5 minutos do exemplo ou mais; confira recursos e dependências. Para Kindle, use formatos atuais: conselho de enviar MOBI é antigo; Send to Kindle aceita EPUB conforme seus requisitos.
Faça instalação privada em http://你的IP:8083. Troque admin/admin123 antes de expor e confira credenciais da versão. Em Admin → Basic Configuration, caminho do banco: /books, interno.
Não permita Calibre desktop e Calibre-Web escrevendo simultaneamente metadata.db. Use um escritor e transferências/backups consistentes.
- HTTPS habilita contexto seguro para certos recursos de área de transferência/PWA.
- Protege credenciais em Wi-Fi público e outras redes não confiáveis.
- Caddy automatiza certificados com DNS e desafios corretos.
Configure o proxy:
books.example.com {
encode gzip
reverse_proxy 127.0.0.1:5000
}
Para Calibre-Web, troque porta privada. reverse_proxy atende WebSocket no Caddy. O trecho Nginx pertence a uma configuração completa adequada:
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header X-Forwarded-Proto $scheme;
client_max_body_size 2000m;
Confira esquema X-Forwarded-Proto, Base URL e proxies confiáveis. client_max_body_size altera limite de upload; 2000m é exemplo grande, sem ser obrigatório. Ajuste a disco, proxy e aplicação. Veja Caddy.
- Kavita: endpoint por usuário como
https://books.example.com/api/opds/你的API密钥. - Calibre-Web:
https://books.example.com/opds, conforme permissões.
URL com API key é credencial. Confira OPDS, TLS, autenticação e formatos em KOReader, Moon+ Reader, KyBook ou Panels; aplicativos/dispositivos/versões não oferecem sempre o mesmo. Firmware Kindle/Kobo e navegadores de tinta eletrônica têm limitações próprias.
Kavita web/PWA pode oferecer Add to Home Screen e progresso em dispositivos compatíveis. Calibre-Web:
- Send to Kindle exige SMTP, remetente permitido, ajustes do aparelho e arquivo compatível. App passwords Gmail dependem da conta/segurança; não presuma senha normal.
- Kobo exige firmware e configuração documentados; confira progresso além do download.
Use conta leitora limitada em vez de compartilhar administrador.
Guarde livros, configuração, usuários, metadados e progresso. Pare escritores para SQLite consistente:
cd ~/ebooks
docker compose stop
tar czf ~/ebooks-backup-$(date +%F).tar.gz config books
docker compose start
Para Calibre-Web inclua library: books do exemplo não basta. Confira arquivo e reinício mesmo com falhas. Use rsync em incrementais quando o destino permitir e snapshots consistentes da configuração. Objetos precisam de ferramenta apropriada; montagem rclone sozinha não comprova backup. Confira upload, retenção independente e restauração.
Livros ausentes: confira regras do scanner/agrupamento, chown 1001:1001, volumes e tipo; teste arquivo representativo.
Capas vazias: confira metadados e integração real. Envie manualmente ou use Calibre ebook-meta com backup e outros escritores parados; catálogo chinês pode ser incompleto.
PDF não abre: navegador/celular pode esgotar RAM; baixe por OPDS compatível e leia localmente.
Loop no login Kavita: confira X-Forwarded-Proto, esquema externo, Base URL e proxies adicionais.
DB Location is not valid: /books precisa de metadata.db e biblioteca completa acessível, não EPUB avulso.
Uploads não aparecem: ative Allow Uploads e permissões de usuário/filesystem; Kavita pode precisar de Rescan. Montagem somente leitura não recebe uploads.
Disco cheio: confira du -sh books/*, miniaturas, PDF/quadrinhos e backups. Arquive com intenção e valide remoto antes de apagar única cópia.
Você controla arquivos legíveis e organização, sem garantir propriedade incondicional nem remover DRM. Assinaturas variam por região. Escolha pela biblioteca Calibre existente e teste regras antes de importar a coleção toda.