Issued : quand ton dossier de CBZ devient une bibliothèque web
La semaine dernière, un client m’appelle. Il a 400 Go de comics dans un dossier CBZ, une Freebox, un vieux NAS Synology qui ronronne comme un chat asthmatique, et il veut juste lire comics cbz depuis son canapé sur sa tablette. Pas envie d’installer Calibre, pas envie de Kavita qui bouffe 2 Go de RAM pour afficher trois cases. Il voulait un truc con. Un truc qui scanne et qui sert. J’ai testé Issued pour lui, et franchement, ça mérite qu’on en parle.
Issued, c’est un petit serveur auto-hébergé qui fait une seule chose : il pointe vers ton dossier de comics et il te les balance dans le navigateur. CBZ, CBR, le bazar habituel. Tu lances, tu ouvres une URL, tu lis. Autant dire que ça change des usines à gaz qu’on nous vend partout.
Ce que ça fait, et ce que ça ne fait pas
Le principe est bête comme chou. Tu installes Issued (binaire Go, Docker, ce que tu veux), tu lui donnes un chemin vers ta collection, et il génère un catalogue. Côté navigateur, tu as un lecteur web intégré avec le zoom, le passage de page, la navigation par série. Côté applis de lecture, il expose aussi un flux OPDS, ce qui veut dire que Panels, Chunky, Tachiyomi et compagnie peuvent piocher dedans direct.
Ce qu’il ne fait pas, en revanche : il ne renomme pas tes fichiers, il ne scrape pas les métadonnées ComicVine, il ne te fait pas de belles jaquettes. Tu lui donnes un dossier crade, il te sert un catalogue crade. C’est cohérent, mais il faut le savoir avant de râler.
- Scan direct des dossiers contenant du CBZ et du CBR, sans réorganisation
- Lecteur web intégré accessible depuis n’importe quel navigateur du réseau
- Endpoint OPDS pour les applis mobiles type Panels, Chunky, Librera
- Authentification par mot de passe sur l’interface web uniquement
- Déploiement en binaire unique ou via conteneur Docker
Lire comics CBZ : le piège du mot de passe qui ne protège rien
Bon. Là je vais être cash, parce que c’est le genre de détail qui finit en désastre chez un client. Issued propose un mot de passe. Génial. Sauf que ce mot de passe ne protège que le lecteur web. Le flux OPDS, lui, reste totalement ouvert par défaut. Traduction pour ceux qui suivent pas : n’importe qui sur ton réseau local peut taper l’URL OPDS et se servir dans ta bibliothèque. Sans mot de passe. Sans rien.
Alors oui, sur un LAN domestique bien fermé, on va dire que ça passe. Mais dès que tu exposes ça sur Internet — et je sais très bien que certains vont le faire, parce que j’en vois passer toutes les semaines en support — tu ouvres ta collection à la terre entière. Ce n’est pas une faille de sécurité au sens strict, c’est un choix de design. Mais mine de rien, c’est un choix qui va faire mal à quelques personnes.
Je ne suis pas certain à 100% que les versions futures ne changeront pas la donne, mais en l’état, ma position est simple : si tu veux exposer Issued hors de chez toi, tu passes par un reverse proxy avec authentification (Caddy, Traefik, Nginx + basic auth, peu importe), ou tu montes un VPN type WireGuard. Point. Pas de discussion.
Ma config type pour un client
Quand je déploie ça chez quelqu’un, voilà ce que je fais systématiquement :
- Issued tourne dans un conteneur Docker, réseau interne uniquement
- Reverse proxy Caddy devant, avec auth basique ou mTLS
- Accès distant via WireGuard, jamais en direct
- Sauvegarde du dossier comics en lecture seule pour le conteneur
Comme ça, le flux OPDS reste accessible depuis le téléphone quand le client est sur le VPN, mais personne d’autre ne peut y toucher. C’est trois lignes de config, et ça évite de se réveiller un matin avec 400 Go de comics redistribués sur un tracker quelconque.
Issued vs Kavita vs Komga : mon avis tranché
Je vais me faire des ennemis, mais tant pis. Kavita et Komga sont d’excellents projets, hein, ne me faites pas dire ce que je n’ai pas dit. Sauf que pour quelqu’un qui veut juste lire ses comics CBZ depuis le navigateur, ils sont overkill. Kavita te sort des métadonnées, des statistiques de lecture, des collections intelligentes, une interface qui ressemble à Netflix. C’est joli. C’est aussi 800 Mo de RAM minimum et une base de données à maintenir.
Komga, c’est pareil en un peu plus sobre. Toujours du Java, toujours une base, toujours une couche de complexité. Pour un utilisateur qui a 50 comics, ça va. Pour mon client à 400 Go, c’est du gâchis de ressources.
Issued, c’est le contraire. C’est un binaire de quelques mégaoctets, zéro base de données, zéro index à reconstruire. Tu pointes, tu sers. Du coup, sur un Raspberry Pi ou un NAS modeste, c’est le jour et la nuit. Le seul compromis, c’est que tu perds tout le confort des métadonnées. À toi de voir ce qui compte.
Le cas Windows, évidemment
Ah, Windows. La semaine dernière encore, un client me sort : « J’ai installé Issued, ça marche pas ». Je me connecte, je regarde. Le binaire Go était bien téléchargé. Sauf que Windows Defender avait décidé, dans sa grande sagesse, de le mettre en quarantaine sans prévenir. Classique. On ajoute une exclusion, on relance, ça marche.
Et là deuxième bug : le dossier de comics était sur un partage réseau mappé en Z:. Issued ne voyait rien. Du coup, il a fallu passer par le chemin UNC complet. Autant dire que si tu bricoles sous Windows, prépare-toi à ces deux emmerdes. Ce n’est pas la faute d’Issued, c’est Windows qui fait du Windows.
Le lecteur web : correct, sans plus
Pour être honnête, le lecteur intégré fait le job mais ne casse pas trois pattes à un canard. Tu as le zoom, le passage de page au clic, la navigation par série, le plein écran. Pas de double-page automatique intelligente, pas de mode manga inversé intelligent, pas de gestion fine du sens de lecture. Si tu lis du franco-belge classique, ça passe sans souci. Si tu lis du manga, tu vas pester un peu.
C’est là que le flux OPDS devient intéressant : tu utilises Issued comme backend, et tu lis avec Panels sur iPad ou Chunky sur iPhone. Là tu retrouves tout le confort d’une vraie appli de lecture, avec la légèreté du serveur en dessous. C’est la config que je recommande à tous mes clients qui lisent sur tablette.
- Lecteur web : basique mais fonctionnel pour de la lecture ponctuelle sur PC
- Flux OPDS : la vraie porte d’entrée pour les applis mobiles
- Pas de gestion du sens de lecture manga côté web
- Aucune métadonnée enrichie, aucune jaquette scrapée
Faut-il l’installer ? Ma réponse en atelier
Si tu cherches un media server de comics complet avec métadonnées, notes, statistiques et tout le tintouin, va voir ailleurs. Kavita ou Komga feront mieux, au prix de ressources et d’une complexité que tu devras assumer. Si tu veux juste lire comics cbz depuis ton navigateur ou ton appli mobile sans te prendre la tête, Issued est exactement le bon outil. Léger, prévisible, sans fioritures.
Le seul point de vigilance, c’est cette histoire de mot de passe qui ne protège que le web. Je le répète parce que ça va en surprendre plus d’un : ton catalogue OPDS est ouvert par défaut. Réseau local uniquement, ou reverse proxy avec auth, ou VPN. Pas d’exception. C’est la seule règle non négociable que je donne à mes clients.
Pour le reste, c’est un projet sain, simple, qui fait une chose et qui la fait bien. Ce genre d’outil se fait rare, du coup je préfère le souligner. Si tu veux creuser, la source complète est chez Korben : Issued – Pour lire vos Comics / BDs depuis votre navigateur.
Source : article original
