Como configurar um servidor OPDS no iPhone e no iPad (guia 2026)

Resposta rápida: para configurar um servidor OPDS no iPhone ou iPad, instale um aplicativo de leitura compatível com OPDS, abra a seção Biblioteca ou Catálogos, adicione um novo catálogo, cole a URL OPDS completa do servidor (por exemplo http://192.168.1.10:8080/opds para um Calibre Content Server, e não apenas o endereço IP), dê um nome a ele e informe usuário e senha somente se o servidor pedir. Salve, e o aplicativo lista todos os livros daquele servidor, prontos para baixar e ler sem conexão. O erro mais comum de todos é esquecer o caminho /opds ou o número da porta.

OPDS parece algo que exige experiência com servidores domésticos, mas leva cerca de dois minutos assim que você conhece as duas coisas que derrubam todo mundo: o caminho exato que cada servidor espera e como cada um trata o login. Este guia percorre a adição do seu primeiro catálogo do começo ao fim, os passos precisos dentro do aplicativo, os padrões de URL de todos os servidores comuns, uma lista curta de catálogos públicos cujas URLs verifiquei à mão enquanto escrevia, e uma lista real de verificação para o momento em que nada aparece.

Uma observação minha: sou Petr Jahoda e faço o justRead. Configurei pessoalmente cada uma das conexões OPDS descritas aqui, em servidores reais e em um iPhone real, em vez de parafrasear uma especificação. As pegadinhas abaixo são as que eu realmente encontrei.

Este guia foi totalmente reescrito e ampliado em julho de 2026, com todas as URLs de catálogos públicos testadas novamente no dia da publicação, para que você não seja enviado a um feed morto.

O que é OPDS, de fato

OPDS, sigla de Open Publication Distribution System, é um padrão simples que permite a um aplicativo de leitura navegar e baixar livros de um servidor. A forma mais limpa de imaginar: OPDS é o RSS dos livros. Um leitor de RSS aponta para um endereço de feed e mostra todos os artigos novos daquela fonte. Um leitor OPDS aponta para uma URL de catálogo e mostra todos os livros que um servidor oferece, com capas, autores, descrições e links de download. Você toca em um livro, ele é baixado para o aparelho e você lê sem conexão.

Por ser um padrão aberto, e não o aplicativo de uma única empresa, o mesmo leitor consegue se conectar a fontes muito diferentes pelo mesmo mecanismo: uma biblioteca de domínio público como o Project Gutenberg, um servidor de mídia doméstico e a sua própria coleção do Calibre falam todos a mesma língua. Nada fica preso a uma loja ou a uma conta.

Existem duas versões que você vai encontrar:

• OPDS 1.2 é a versão que praticamente tudo fala hoje. Ela é construída sobre Atom, o formato XML de feeds, então um catálogo é essencialmente um documento XML que lista livros e subseções. Quando alguém lhe passa uma URL OPDS em 2026, quase sempre é 1.2.
• OPDS 2.0 é uma reescrita mais recente da mesma ideia, baseada em JSON. É mais limpa para quem desenvolve e começa a aparecer (o Komga, por exemplo, serve as duas), mas a adoção ainda é inicial. Você não precisa escolher. Um bom leitor negocia a versão por você, e 1.2 é o que você vai usar na prática.

O que você precisa antes de começar

Conectar-se a qualquer catálogo OPDS exige apenas duas informações, e muitas vezes só a primeira:

1. A URL do catálogo. Este é o endpoint OPDS, e normalmente termina em /opds ou em um caminho parecido. Para um catálogo público, o próprio projeto publica a URL no site. Para o seu servidor, é o endereço dele mais o caminho OPDS que aquele software específico usa (é aqui que a maioria das configurações falha, e há uma seção inteira sobre isso abaixo).
2. Usuário e senha, somente se o servidor exigir. Catálogos públicos costumam ser abertos. Servidores privados, como o seu Calibre ou Komga, podem pedir login. Se for o caso, você informa uma vez e o aplicativo guarda.

É essa a lista inteira. Sem conta de terceiros, sem serviço de sincronização no meio, sem transferir arquivos à mão por cabo.

Passo 1: instale um leitor OPDS

O iOS e o iPadOS não navegam em catálogos OPDS sozinhos, então você precisa de um aplicativo de leitura compatível com o padrão. O justRead é um leitor de EPUB e PDF para iPhone e iPad com OPDS embutido: já vem com o Project Gutenberg e o Internet Archive como catálogos internos, permite adicionar seus próprios servidores e cuida da busca no servidor, da paginação e da navegação por categoria, de modo que mesmo catálogos enormes continuam utilizáveis. Qualquer que seja o aplicativo escolhido, o recurso a procurar é uma seção OPDS ou Catálogos dentro da biblioteca ou das configurações. Se quiser a visão completa dos recursos antes de decidir, a visão geral do leitor OPDS cobre o que o aplicativo suporta.

Um limite honesto que vale dizer desde já: o justRead lê arquivos EPUB e PDF. Catálogos OPDS que oferecem apenas outros formatos (arquivos de quadrinhos, MOBI e assim por diante) ainda podem ser navegados, mas você só conseguirá baixar as edições em EPUB e PDF.

Passo 2: adicione seu primeiro catálogo, passo a passo

A forma mais rápida de ver o OPDS funcionando é um catálogo público gratuito, e no justRead a mais rápida de todas não exige digitar nada.

O caminho sem digitação (embutido). O justRead já vem com o Project Gutenberg e o Internet Archive como catálogos internos. Abra a Biblioteca, abra a área de catálogos e eles já estão lá. Toque em Project Gutenberg e você está navegando imediatamente por mais de 70 mil livros de domínio público, sem nenhuma URL para colar. Este é o recurso real da versão 3.x e é o caminho mais curto possível até um livro baixado. Use-o uma vez apenas para confirmar que todo o fluxo funciona antes de adicionar qualquer coisa própria.

O caminho manual (qualquer catálogo). Para adicionar um catálogo por URL, o fluxo é o mesmo na maioria dos leitores, e no justRead especificamente:

1. Abra a Biblioteca.
2. Escolha adicionar catálogo OPDS (a opção de adicionar um novo servidor ou catálogo).
3. Cole a URL do catálogo no campo de endereço. Cole, não digite de novo, para não introduzir um erro no caminho ou na porta.
4. Dê um nome que você reconheça depois, como "Calibre de casa" ou "Gutenberg".
5. Se o servidor exigir login, informe usuário e senha. Deixe em branco se não exigir.
6. Salve.

O catálogo agora aparece na sua lista. Toque nele para navegar. Catálogos maiores abrem em seções que você percorre, então dá para navegar por categoria (por assunto, autor, mais populares, adicionados recentemente e assim por diante) em vez de rolar uma lista gigante. Use a busca no servidor para consultar um título ou autor diretamente, em vez de baixar tudo antes, e a paginação mantém resultados longos carregando em blocos administráveis. Toque em qualquer livro para baixá-lo; ele vai para a sua biblioteca e fica disponível para leitura sem conexão.

Esse fluxo de seis passos é toda a habilidade necessária. Todo o resto deste guia trata de acertar um valor específico: a URL do passo 3.

A pegadinha do caminho /opds, em detalhe

Se você levar apenas uma coisa daqui, leve esta: a URL OPDS quase nunca é só o endereço do servidor. O IP ou nome de host puro aponta para a página web do servidor feita para pessoas, não para o feed OPDS legível por máquina. Aponte um leitor para http://192.168.1.10:8080 e você terá um erro ou um catálogo vazio; aponte para http://192.168.1.10:8080/opds e a sua biblioteca aparece. Dois detalhes causam o estrago, o caminho e a porta, e cada servidor os trata de um jeito.

• Calibre Content Server serve OPDS em /opds na porta 8080 por padrão: http://<ip>:8080/opds. Sem o :8080, a conexão morre antes de começar. Sem o /opds, você cai no leitor web em vez do feed.
• Komga serve o feed OPDS 1.2 em um caminho mais profundo: http://<host>:25600/opds/v1.2/catalog. A porta padrão é 25600, e o catálogo fica vários segmentos adiante, não em um /opds simples.
• Kavita faz algo diferente de novo: em vez de usuário e senha, ele coloca uma chave de API dentro da própria URL: http://<host>:5000/api/opds/<sua-chave-de-api>. Não há senha separada para digitar, porque a chave na URL é a credencial. Copie a URL inteira já pronta nas configurações do Kavita e deixe os campos de login em branco.

O padrão é: acerte a porta, acerte o caminho e verifique se a credencial vive na URL ou nos campos de login. Quando uma conexão falha, é uma dessas três em nove de cada dez casos.

Passo 3: conecte um Calibre Content Server

O catálogo privado mais popular é a sua própria biblioteca do Calibre. O Calibre, o gerenciador gratuito de ebooks para computador, consegue publicar toda a sua coleção por OPDS com alguns cliques:

1. No computador, abra o Calibre e clique em Conectar/compartilhar na barra de ferramentas.
2. Escolha Iniciar servidor de conteúdo.
3. Descubra o endereço IP local do computador (algo como 192.168.1.10). O endpoint OPDS então é http://192.168.1.10:8080/opds, onde 8080 é a porta padrão do Calibre.

No iPhone ou iPad, adicione essa URL como um novo catálogo OPDS com os seis passos acima. Duas coisas tornam isso mais fácil especificamente no justRead: ele consegue encontrar um Calibre Content Server na mesma rede Wi-Fi automaticamente, então talvez você nem precise descobrir e digitar o IP, e ele suporta autenticação HTTP Digest, que é o esquema de login usado pelo Calibre quando você ativa a opção "Exigir usuário e senha".

Algumas realidades do servidor de conteúdo que vale conhecer: o Calibre precisa continuar aberto e em execução no computador para o catálogo funcionar, os dois aparelhos precisam estar na mesma rede a menos que você configure acesso remoto, e se o endereço IP do computador mudar (o que roteadores domésticos fazem por conta própria), a URL do catálogo muda junto. Reservar um IP fixo no roteador, ou usar o nome de host .local do computador, evita o problema do "funcionava ontem, quebrou hoje".

Esse caminho por OPDS é a maneira mais rápida de simplesmente ler seus livros do Calibre no iOS. Se você quiser que a leitura e as avaliações voltem para o computador em vez de apenas navegar em mão única, o fluxo de sincronização com o Calibre acrescenta sincronização nos dois sentidos por cima disso, além de cobrir o lado do servidor feito direito: porta liberada, login adicionado, acesso de fora de casa e várias bibliotecas.

Padrões de URL para servidores próprios

Se você mantém um servidor em casa, o mesmo fluxo de seis passos se aplica, com o endpoint OPDS de cada projeto. Estes são os padrões nos quais encaixar seu host e sua porta:

Observações sobre a tabela: as portas mostradas são os padrões comuns de cada projeto, mas qualquer uma pode ser alterada na instalação, então confirme a sua nas configurações do próprio servidor se a conexão falhar. O padrão do calibre-web costuma ser 8083, mas depende inteiramente de como você o instalou (um proxy reverso pode eliminar a porta e deixar só o nome de host). O COPS mudou seu ponto de entrada entre versões, então se feed.php não resolver, procure o link OPDS exato na página de administração do COPS em vez de adivinhar. O Komga também oferece um feed OPDS 2.0 em /opds/v2, mas o caminho 1.2 acima é o compatível para começar.

O justRead suporta servidores OPDS personalizados, incluindo Calibre OPDS, calibre-web, Kavita, Komga e COPS, com filtragem por servidor e paginação para que catálogos grandes continuem administráveis. Adicione o servidor como um novo catálogo, informe as credenciais se ele as usar (lembrando da exceção da chave na URL do Kavita), e suas estantes aparecem no iPhone.

Uma lista inicial de catálogos OPDS públicos

Você não precisa de um servidor próprio para usar OPDS. Abaixo estão catálogos públicos que testei novamente no dia em que este guia foi publicado. Listei apenas URLs que de fato devolveram um feed OPDS vivo, e fui explícito sobre o que está restrito, em vez de mandar você para um link que falha em silêncio.

• Project Gutenberg (verificado, sem login): https://www.gutenberg.org/ebooks.opds/. Mais de 70 mil livros de domínio público, totalmente aberto e legal para baixar. É o primeiro catálogo padrão-ouro. No justRead ele já vem embutido, então você nem precisa colar esta URL; ela está aqui para outros aplicativos e como referência.
• Unglue.it (verificado, sem login): https://unglue.it/api/opds/. Um catálogo de ebooks com licença Creative Commons e de obras "libertadas" que o site tornou gratuitas para todos. Menor e mais eclético que o Gutenberg, e completamente aberto.
• Standard Ebooks (feed real, porém restrito): o projeto produz ebooks de domínio público com composição tipográfica belíssima, e realmente publica um feed OPDS em https://standardebooks.org/feeds/opds. Na data desta reescrita, o feed completo não está aberto ao público: é reservado a membros do Patrons Circle (uma pequena doação), a colaboradores dos ebooks e a patrocinadores, e ele bloqueia temporariamente o IP de qualquer coisa que o raspe. Se você apoia o projeto, os patronos se autenticam informando o e-mail da conta e deixando o campo de senha em branco. Se não, trate o Standard Ebooks como uma fonte para navegar e baixar pelo site, e não como uma URL OPDS pronta, e verifique os termos de acesso atuais no site antes de adicioná-lo.

Mantive esta lista curta de propósito e apenas com catálogos que consegui confirmar. Vários catálogos que aparecem em listas antigas (o Feedbooks, que encerrou em 2024, e alguns outros) estão mortos ou hoje bloqueiam acesso automatizado, então ficaram de fora. Para um panorama mais amplo e continuamente revisado, incluindo fontes acadêmicas e de empréstimo e os feeds mortos a evitar, veja os melhores catálogos OPDS gratuitos de 2026. Aquele texto trata da pergunta "para onde apontar"; este trata de "como apontar".

HTTP, HTTPS, certificados e logins

Servidores domésticos locais normalmente rodam em HTTP puro dentro da sua rede, o que é aceitável porque o tráfego nunca sai de casa. Você vai digitar http:// (e não https://) para um Calibre Content Server no seu Wi-Fi, e isso é esperado.

No momento em que você quiser alcançar um catálogo de fora de casa, o HTTPS passa a importar, e o iOS é rigoroso quanto a isso:

• O iOS rejeita certificados não confiáveis. Se o seu servidor usa um certificado autoassinado, o iOS recusa a conexão em vez de mostrar um botão de "continuar mesmo assim" dentro de um leitor. A solução confiável é um certificado de verdade: coloque o servidor atrás de um nome de domínio e emita um certificado gratuito (por exemplo com o Let's Encrypt), normalmente por meio de um proxy reverso. Aí o iOS confia nele como em qualquer site normal. Instalar e confiar manualmente em um certificado autoassinado nas Configurações do iOS é possível, mas trabalhoso, e um certificado adequado dá menos dor de cabeça a longo prazo.
• Autenticação Basic versus Digest. Servidores OPDS se protegem com um de dois esquemas de login HTTP. O Basic envia usuário e senha a cada requisição (seguro sobre HTTPS, exposto sobre HTTP puro), enquanto o Digest é um esquema de desafio e resposta que nunca envia a senha bruta. O servidor de conteúdo do Calibre usa Digest, suportado pelo justRead. Para qualquer servidor, use exatamente o usuário e a senha definidos do lado do servidor; um único caractere errado chega ao aplicativo como "acesso negado", não como "senha incorreta", e é por isso que erros de digitação no login se disfarçam de falha de conexão.

Nada apareceu? Lista completa de verificação

Quando um catálogo não carrega, percorra esta lista na ordem. Cada item é uma causa real que eu já encontrei:

1. Caminho errado. Você usou o endereço puro em vez do caminho OPDS completo. Acrescente /opds (Calibre), /opds/v1.2/catalog (Komga) ou o que o seu servidor documentar. Esta é a causa número um.
2. Porta faltando. Você deixou de fora o :8080 (Calibre), :25600 (Komga), :5000 (Kavita) ou :8083 (calibre-web). Sem a porta, a requisição não vai a lugar nenhum.
3. Mesma rede? Para um servidor doméstico, celular e servidor precisam estar no mesmo Wi-Fi. Celulares adoram voltar para os dados móveis; se você está no 5G e o servidor tem um endereço 192.168.x.x restrito à rede local, ele é simplesmente inalcançável. Confirme que o Wi-Fi está ligado e conectado à rede certa.
4. IP de rede local acessado de fora. Um endereço 192.168.x.x ou 10.x.x.x só funciona dentro de casa. Ele nunca vai resolver de uma cafeteria. Alcançá-lo remotamente exige uma VPN de volta para casa, ou um domínio próprio com proxy reverso.
5. Firewall bloqueando a porta. A falha mais comum do Calibre: o servidor está rodando, a URL está certa, mas o firewall do computador bloqueia em silêncio as conexões de entrada na 8080. Libere a porta (ou o aplicativo Calibre) no firewall da máquina que roda o servidor.
6. Servidor não está realmente rodando. O Calibre precisa continuar aberto com o servidor de conteúdo iniciado; um contêiner auto-hospedado precisa estar no ar. Se o Calibre estiver fechado ou o contêiner parado, o catálogo desaparece. Carregue a mesma URL em um navegador de computador na mesma rede: se o navegador também não alcançar, o problema é o servidor, não o aplicativo.
7. Erro de digitação nas credenciais. Usuário ou senha errados aparecem como falha de conexão. Digite as credenciais de novo com cuidado, atento à letra maiúscula automática na primeira letra e a um espaço extra vindo da colagem.
8. Certificado HTTPS rejeitado. Um servidor remoto com certificado autoassinado é recusado pelo iOS. Migre para um certificado confiável, como descrito acima.
9. O endereço mudou. Funcionava ontem e não hoje porque o roteador entregou um novo IP ao computador. Reserve um IP fixo ou use o nome de host .local.

O diagnóstico mais rápido de todos é o teste de navegador do passo 6: abra a URL OPDS exata no Safari ou em um navegador de computador na mesma rede. Se você vir XML puro, o servidor e a URL estão bons e o problema está no aplicativo ou nas credenciais. Se o navegador também falhar, o problema é o servidor, a porta ou a rede, e você acabou de cortar a busca pela metade.

Onde o OPDS se encaixa na sua rotina de leitura

O OPDS transforma um iPhone ou iPad na porta de entrada para qualquer biblioteca à qual você consiga apontá-lo, pública ou privada, sem copiar arquivos à mão. Uma vez configurado o catálogo, adicionar um livro novo são dois toques. A maioria das pessoas acaba com uma mistura pequena: um catálogo público embutido para os clássicos e o próprio Calibre ou servidor caseiro para tudo o que realmente coleciona.

• Nunca leu ebooks no iOS? Comece por como ler EPUB no iPhone e no iPad.
• Quer o quadro completo do que um leitor OPDS faz? Veja a visão geral do leitor OPDS.
• Decidindo quais catálogos públicos adicionar? Use os melhores catálogos OPDS gratuitos de 2026.
• Tem seu próprio Calibre? A sincronização com o Calibre cobre o lado do servidor e acrescenta sincronização de progresso e avaliações nos dois sentidos.

O justRead inclui um teste gratuito de 14 dias, então você pode configurar seu primeiro catálogo e confirmar que todo o fluxo funciona antes de decidir. Baixe o justRead na App Store e adicione seu primeiro catálogo OPDS hoje.

Perguntas frequentes

O que é um catálogo OPDS?
Um catálogo OPDS é um feed que permite a um aplicativo de leitura navegar e baixar livros de um servidor, muito parecido com um leitor de RSS assinando um feed de notícias. Você aponta o aplicativo para a URL do catálogo e ele lista todos os livros que o servidor oferece, com capas e descrições, prontos para baixar e ler sem conexão.

Qual é a URL OPDS correta para um Calibre Content Server?
É o IP local do seu computador, mais a porta do Calibre, mais o caminho /opds: http://192.168.1.10:8080/opds. Os dois erros que quebram isso são usar o IP puro sem /opds e esquecer a porta :8080.

Preciso do Calibre para usar OPDS no iPhone?
Não. Você pode se conectar a catálogos públicos como o Project Gutenberg sem nenhum servidor próprio, e no justRead o Gutenberg e o Internet Archive já vêm embutidos, sem nada a digitar. O servidor de conteúdo do Calibre é apenas uma fonte OPDS popular, útil se você já mantém sua biblioteca no Calibre em um computador.

Por que meu servidor OPDS não conecta no iOS?
As causas habituais, em ordem, são: caminho errado (falta o /opds), número de porta ausente, celular e servidor em redes diferentes, firewall bloqueando a porta, erro de digitação no login, ou um certificado HTTPS autoassinado em que o iOS se recusa a confiar. Carregue a URL exata em um navegador de computador na mesma rede para saber se o problema é o servidor ou o aplicativo.

Por que o Kavita não pede usuário e senha?
O Kavita coloca uma chave de API diretamente na URL OPDS (http://<host>:5000/api/opds/<sua-chave-de-api>), então a chave é a credencial. Copie a URL completa das configurações do Kavita, cole como endereço do catálogo e deixe os campos de usuário e senha em branco.

Qual é a diferença entre OPDS 1.2 e OPDS 2.0?
O OPDS 1.2 é a versão mais antiga, baseada em XML e construída sobre Atom, e é o que quase todo servidor e leitor fala hoje. O OPDS 2.0 é uma versão mais nova baseada em JSON, mais limpa para quem desenvolve e começando a aparecer (o Komga serve as duas), mas a adoção é inicial. Um bom leitor lida com o que o servidor oferecer, então você raramente escolhe.

O OPDS funciona por HTTPS e com certificados autoassinados no iPhone?
Funciona por HTTPS com um certificado confiável. O iOS rejeita de imediato certificados autoassinados ou não confiáveis, então, para acesso remoto, coloque o servidor atrás de um domínio real com um certificado gratuito (por exemplo Let's Encrypt) em vez de um autoassinado. HTTP puro é adequado para um servidor no seu próprio Wi-Fi.

Consigo alcançar meu servidor OPDS doméstico de fora de casa?
Não com um endereço de rede local 192.168.x.x, que só resolve dentro de casa. Para alcançá-lo remotamente, conecte-se de volta por uma VPN ou exponha o servidor por um nome de domínio e um proxy reverso com certificado confiável.

Quantos livros o OPDS aguenta em um celular?
Bibliotecas muito grandes funcionam bem, porque o OPDS é feito para navegar primeiro: o aplicativo só baixa um livro quando você toca nele, não o catálogo inteiro. O justRead usa busca no servidor e paginação para que um catálogo com dezenas de milhares de títulos carregue em blocos e permaneça responsivo, e você pode navegar por categoria em vez de rolar tudo.

Quais servidores o justRead suporta por OPDS?
O justRead se conecta a servidores OPDS padrão, incluindo o servidor de conteúdo do Calibre, calibre-web, Komga, Kavita e COPS, com filtragem por servidor, busca no servidor, paginação e navegação por categoria. Ele também encontra um Calibre Content Server na mesma rede Wi-Fi automaticamente e suporta o login HTTP Digest do Calibre. Os downloads são EPUB e PDF.

O que dá para baixar por OPDS no justRead?
Arquivos EPUB e PDF, além de quadrinhos CBZ e CBR. Você pode navegar em catálogos que também listam outros formatos, mas o justRead vai baixar e abrir as edições em EPUB, PDF e quadrinhos.

Para onde apontar depois que funcionar: os catálogos OPDS gratuitos que ainda estavam servindo livros neste mês, ou a biblioteca de ebooks do aplicativo se um servidor for mais configuração do que você queria. Komga e Kavita, dois dos servidores que as pessoas mais conectam desta forma, são principalmente servidores de quadrinhos e mangá, então vale saber o que acontece com um CBZ ou CBR depois do download antes de adicionar um deles.