Guida pratica a OPDS
Ospita la tua libreria e aprila in Lectern
I file restano sul tuo hardware, mentre da Android sfogli lo scaffale e scarichi direttamente in Lectern. Calibre-Web è la via semplice per gli ebook, Storyteller quella per la lettura sincronizzata.
La risposta breve
Scegli Calibre-Web per uno scaffale privato di ebook. Scegli Storyteller per unire ebook e audiolibri senza DRM in EPUB 3 con lettura sincronizzata. Entrambi offrono un catalogo OPDS per Lectern.
Scegliere il server
| Domanda | Calibre-Web | Storyteller |
|---|---|---|
| Ideale per | Gestire e scaricare ebook | Ebook, audio e lettura sincronizzata |
| Libreria | Calibre con metadata.db | Archivio proprio |
| In Lectern | Edizioni EPUB | EPUB o EPUB sincronizzato |
| Carico | Leggero | L'allineamento può essere pesante |
Per la rete domestica parti da Calibre-Web. Leggi il confronto completo se vuoi leggere e ascoltare insieme.
Prima di iniziare
- Computer, NAS o server acceso durante la consultazione.
- Docker Compose e cartelle persistenti.
- EPUB senza DRM. Lectern nasconde le voci solo audio.
- IP locale del server, per esempio
192.168.1.50.
Inizia dal Wi-Fi di casa. Fuori casa usa una VPN privata o un reverse proxy HTTPS configurato bene. Non esporre accessi non cifrati.
Percorso A: Calibre-Web
Sostituisci i percorsi /path/to/... e adatta PUID, PGID e fuso orario. La cartella libri deve contenere una libreria Calibre con metadata.db.
services:
calibre-web:
image: lscr.io/linuxserver/calibre-web:latest
container_name: calibre-web
environment:
- PUID=1000
- PGID=1000
- TZ=Etc/UTC
volumes:
- /path/to/calibre-web/config:/config
- /path/to/calibre/library:/books
ports:
- 8083:8083
restart: unless-stopped- Salva come
compose.yamled eseguidocker compose up -d. - Apri
http://IP-SERVER:8083e imposta/books. - Accedi con
admineadmin123, poi cambia subito la password. - Aggiungi libri con Calibre. Per import automatico usa Calibre-Web Automated.
- Prova
http://IP-SERVER:8083/opds.
Consulta il repository LinuxServer ufficiale per i dati aggiornati.
Percorso B: Storyteller
Crea una chiave con openssl rand -base64 32 e salva solo il valore in STORYTELLER_SECRET_KEY.txt.
services:
web:
image: registry.gitlab.com/storyteller-platform/storyteller:latest
volumes:
- /path/to/storyteller/data:/data:rw
environment:
- STORYTELLER_SECRET_KEY_FILE=/run/secrets/secret_key
ports:
- "8001:8001"
secrets:
- secret_key
restart: unless-stopped
secrets:
secret_key:
file: ./STORYTELLER_SECRET_KEY.txt- Avvia Compose e apri
http://IP-SERVER:8001. - Crea l'amministratore e aggiungi ebook, audiolibro o entrambi.
- Con entrambi i file avvia l'allineamento e attendi.
- Il feed OPDS è attivo per impostazione predefinita: bastano le credenziali. Se è stato disattivato, riattivalo in Impostazioni → OPDS. L'indirizzo termina con
/opds. - In Lectern usa il normale nome utente e la password di Storyteller.
Controlla la guida ufficiale e la documentazione OPDS.
Collegare Lectern
- Apri la libreria. Tocca più, poi Libri gratuiti e self-hosted.
- Scegli Storyteller o Calibre-Web.
- Inserisci l'indirizzo. Per esempio
http://192.168.1.50:8083o il dominio HTTPS. - Aggiungi nome utente e password. Restano cifrati sul dispositivo.
- Connetti. Scarica un EPUB nella normale libreria Lectern.
Con un sottopercorso del reverse proxy inserisci l'URL completo. Per altri server usa Altro feed OPDS.
Risolvere i problemi comuni
Server irraggiungibile
localhost indica il telefono. Usa l'IP LAN e verifica Wi-Fi e firewall.
Nuova richiesta di accesso
Prova le stesse credenziali sul web. Una configurazione solo OAuth può richiedere un utente OPDS locale.
Catalogo vuoto
Il feed deve offrire un EPUB. Lectern nasconde le voci solo audio.
Errore HTTPS
Usa un certificato riconosciuto da Android con la catena completa.
Domande su OPDS self-hosted
Indirizzo server o URL OPDS completo?
L'indirizzo basta per Storyteller e Calibre-Web. Usa l'URL completo per sottopercorsi o altri server.
Posso collegarmi da Internet?
Sì, con HTTPS affidabile o una VPN privata. Non esporre un accesso non cifrato.
Lectern riproduce gli audiolibri di Storyteller?
No. Importa EPUB ed EPUB sincronizzati e nasconde le voci solo audio.
Le credenziali arrivano a Lectern?
No. Restano cifrate sul dispositivo Android e vanno solo al tuo server.
Capire le opzioni
Continua con OPDS
I tuoi libri, il tuo server
Collegati una volta, scarica i libri e poi leggi o ascolta offline.
Disponibile suGoogle Play