Language: hu

Audiobookshelf: saját hangoskönyv- és podcastkiszolgáló létrehozása

Kezdj el egy könyvet a számítógépeden, folytasd ugyanonnan a telefonodon, töltsd le utazás előtt, és őrizd meg a haladásodat eszközváltás után is — ehhez nem kell még egy fizetős szolgáltatásra hagyatkoznod. Az Audiobookshelf rendezetlen hanggyűjteményedet áttekinthető online könyvtárrá alakítja borítókkal, fejezetekkel, alkalmazásokkal és külön profilokkal az egész család számára.

Ez nem áruház és nem ingyenes könyvek forrása. A felhasználók maguk adnak hozzá jogszerűen beszerzett, inkompatibilis DRM-védelem nélküli hangfájlokat. Cserébe a könyvek, a hallgatási előzmények és a beállítások a saját szerverükön maradnak.

Mi az Audiobookshelf?

Az Audiobookshelf ingyenes, nyílt forráskódú, saját üzemeltetésű szerver hangoskönyvekhez és podcastokhoz. Átvizsgálja a médiafájlokat tartalmazó mappákat, szerzők és sorozatok szerint rendezi a könyvtárat, metaadatokat és borítókat tölt le, majd lehetővé teszi a gyűjtemény hallgatását böngészőből vagy mobilalkalmazásból.

Gyakorlatban személyes streaming szolgáltatás, amelynek katalógusát te építed fel. A szerver tárolja a könyvtárat és a lejátszási pozíciót, a telefon, tablet vagy számítógép pedig kliensként működik. Így az egyik eszközön megállíthatsz egy könyvet, a másikon pedig a mentett helyről folytathatod.

Az Audiobookshelf otthon NAS-on vagy mini PC-n is futhat. A VPS kényelmesebb, ha bármely hálózatról hozzá szeretnél férni a szolgáltatáshoz bekapcsolt otthoni számítógép, porttovábbítás vagy az otthoni internetkapcsolattól való függés nélkül.

Mire képes az Audiobookshelf?

Haladás szinkronizálása az eszközök között

Minden felhasználónak saját mentett pozíciója, előzményei és könyvjelzői vannak. Webes felület, Progressive Web App és hivatalos Android- és iOS-mobilkliensek állnak rendelkezésre. Előre letölthetsz egy könyvet a telefonodra, és internetkapcsolat nélkül hallgathatod.

Külön fiókok létrehozása

Egy szerveren több felhasználót hozhatsz létre anélkül, hogy összekeveredne a hallgatási haladásuk. Az adminisztrátor szabályozza a könyvtárakhoz való hozzáférést és a jogosultságokat, valamint szükség esetén címkék alapján korlátozhatja a tartalmat. Minden felhasználónak saját folyamatban lévő könyvlistája, előzménye és könyvjelzői vannak.

A könyvtár rendszerezése

A szolgáltatás külső forrásokból tölti le a címeket, leírásokat, szerzőket és borítókat, szerzők és sorozatok szerint csoportosítja a könyveket, valamint lehetővé teszi a fejezetek javítását és a sorrend követését. Több MP3-fájl egyetlen M4B-fájllá egyesíthető, a borító és a metaadatok pedig beágyazhatók a fájlba. Az eredeti fájlok módosítása előtt érdemes másolatot készíteni a könyvtárról.

Podcastok automatikus letöltése

Podcastot cím, RSS URL vagy OPML-fájl alapján adhatsz hozzá, ezután ütemezheted az új epizódok automatikus letöltését. A szolgáltatás nem közvetlenül streameli az epizódot: a fájlt először elmenti a szerverre. Így archiválhatod az esetleg eltűnő epizódokat, de ehhez elegendő lemezterületre is szükség van.

E-könyv a hangoskönyv mellett

EPUB, PDF, CBR, CBZ, AZW3 vagy MOBI fájlt helyezhetsz a könyv mappájába, így a hang és a szöveg ugyanabból a könyvtárbejegyzésből nyitható meg. A beépített olvasó alapfunkciós, és nem helyettesíti a Calibre-Webet vagy a Kavitát.

Kinek való az Audiobookshelf?

A szolgáltatás különösen hasznos az alábbi helyzetekben:

• már rendelkezel MP3, M4B, M4A vagy más elterjedt formátumú hangoskönyvgyűjteménnyel;
• több eszközön hallgatsz, és szinkronizálni szeretnéd a haladást;
• több családtag használja a könyvtárat;
• meg szeretnéd őrizni a saját podcastarchívumodat;
• teljes ellenőrzést szeretnél a fájlok, felhasználói fiókok és biztonsági mentések felett;
• egy szokásos felhőmappa kényelmetlenné vált, mert nem tartalmaz borítókat, fejezeteket és hallgatási előzményeket.

Ha csak egy-két könyvet hallgatsz egyetlen telefonon, külön szerverre valószínűleg nincs szükséged. Az Audiobookshelf akkor a leghasznosabb, amikor a gyűjtemény növekszik, vagy folyamatos távoli hozzáférést igényelsz.

Milyen szerverre van szüksége az Audiobookshelfnek?

A projektnek nincs egységes hivatalos minimuma: a terhelés a könyvtár méretétől, a felhasználók számától, a fájlok átvizsgálásától és a hang átkódolásának szükségességétől függ. Kis személyes gyűjteményhez kiindulási iránymutatásként az alábbi konfiguráció használható:

Forgatókönyv	CPU	RAM	Lemez
1–2 felhasználó, kis könyvtár	1 vCPU	1 GB	30–40 GB-tól
Családi használat és több egyidejű kapcsolat	2 vCPU	2 GB	60–100 GB-tól
Nagy könyvtár, gyakori vizsgálat és fájlfeldolgozás	2–4 vCPU	4 GB	a gyűjtemény mérete szerint

Ez gyakorlati iránymutatás, nem hivatalos minimum. A fő erőforrás a lemezterület. Egy tízórás könyv 64–128 Kbit/s sebességnél körülbelül 0,3–0,6 GB helyet foglal, így száz könyvhöz a podcastok és biztonsági mentések nélkül nagyjából 30–60 GB szükséges. Érdemes kis VPS-sel kezdeni, amely később bővíthető.

Az Audiobookshelf telepítése Docker Compose-szal

A fejlesztők a Dockert ajánlják telepítési módszerként. A következő lépések feltételezik, hogy az Ubuntu vagy Debian rendszeren már telepítve van a Docker és a Compose bővítmény.

Hozd létre a projekt könyvtárát és az adatkönyvtárakat:

mkdir -p /opt/audiobookshelf/{config,metadata,audiobooks,podcasts}
cd /opt/audiobookshelf

Hozd létre a compose.yml fájlt:

services:
  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    container_name: audiobookshelf
    ports:
      - "13378:80"
    volumes:
      - ./config:/config
      - ./metadata:/metadata
      - ./audiobooks:/audiobooks
      - ./podcasts:/podcasts
    environment:
      - TZ=UTC
    restart: unless-stopped

Indítsd el a konténert:

docker compose up -d

Indítás után az irányítópult ideiglenesen ezen a címen lesz elérhető:

http://SERVER_IP:13378

Az első látogatáskor hozd létre a fő adminisztrátori fiókot, majd adj hozzá egy Books típusú könyvtárat, és add meg az /audiobooks könyvtárat. Podcastokhoz hozz létre külön könyvtárat a /podcasts útvonallal.

A hangoskönyv-mappák helyes rendszerezése

Az Audiobookshelfben általában egy könyv felel meg egy mappának. Az áttekinthető struktúra így néz ki:

/audiobooks/
  Author/
    Series/
      01 - Book title/
        01 - Chapter.mp3
        02 - Chapter.mp3
        cover.jpg

Önálló könyvnél a sorozat szintje elhagyható. Egyetlen M4B-fájlt is tárolhatsz a saját könyvmappájában.

A struktúra számít: ha ugyanannak a szerzőnek több könyvét egy közös mappába helyezed, a szkenner egyetlen könyvtárbejegyzésbe olvaszthatja őket. Az első teljes vizsgálat előtt jobb elrendezni a fájlokat. Egy könyv könyvtárak közötti áthelyezése új elem létrehozásának számít, ezért a metaadatok és a haladás nem kerülnek át automatikusan.

A könyvtár biztonságos közzététele az interneten

Nem ajánlott az irányítópultot tartósan a nyitott 13378-as HTTP-porton hagyni. Távoli hozzáféréshez jobb egy domaint, HTTPS-tanúsítványt és Nginxre, Caddyre vagy Traefikre épülő fordított proxyt beállítani.

Az Audiobookshelf WebSocketet használ, ezért ezt támogatni kell a proxynak is. A HTTPS beállítása után a konténer portja csak a helyi interfészhez köthető:

ports:
  - "127.0.0.1:13378:80"

Használj egyedi jelszavakat, hozz létre külön fiókot minden hallgatónak, tartsd frissen a konténert, és ne adj szükségtelenül adminisztrátori jogosultságot.

Amit a biztonsági mentésekről tudni kell

Az Audiobookshelf beépített mentései elmentik az adatbázist és bizonyos metaadatokat, köztük a metadata könyvtárból származó borítókat. A médiafájlok mellett tárolt hangoskönyvek, podcastok és borítók nem részei ennek a mentésnek.

Ezért a megbízható mentési stratégia két részből áll:

1. az adatbázis és a metaadatok automatikus beépített mentése;
2. az audiobooks és podcasts könyvtár külön másolata egy másik lemezen vagy távoli tárhelyen.

Az /config könyvtár tartalmazza az SQLite-adatbázist. A fejlesztők azt javasolják, hogy ugyanazon szerver helyi lemezén tartsd, ne hálózaton csatold: a hálózati tárhely ronthatja a teljesítményt és adatbázis-sérülést okozhat.

Audiobookshelf a tropic.host VPS-én

Személyes könyvtárnál a maximális számítási teljesítménynél fontosabb a folyamatos elérhetőség, a megfelelő lemezterület és a stabil kapcsolat. VPS-en az Audiobookshelf éjjel-nappal fut, és a telefonról, számítógépről vagy tabletről elérhető marad az otthoni hálózat állapotától függetlenül.

Kis gyűjteménynél indulhatsz egy alap tropic.host szerverrel, telepítheted a Dockert, csatlakoztathatsz domaint és HTTPS-t, majd a könyvtár növekedésével bővítheted az erőforrásokat. A csomag kiválasztásakor először becsüld meg a hangfájlok méretét, és hagyj helyet az új könyveknek és podcastoknak.

Előre ismert korlátozások

Az Audiobookshelf nem biztosít könyvkatalógust, és nem távolítja el a DRM-védelmet. Olyan fájlokkal dolgozik, amelyeket a felhasználók maguk adnak hozzá, és amelyek tárolására jogosultak.

A mobilalkalmazások aktív fejlesztés alatt állnak, és hivatalosan továbbra is béta állapotúak, ezért a webes felület vagy a PWA hasznos tartalék marad. Az e-könyv-támogatás alapvető, és egy nagy gyűjtemény rendezett importálásához követni kell a mappastruktúrát, valamint időnként kézzel javítani a metaadatokat.

Hangoskönyvekhez a szolgáltatás mindent megad, ami egy szokásos felhőmappából hiányzik: fejezeteket, sorozatokat, haladáskövetést, offline letöltést, profilokat és podcasttámogatást.

Összegzés

Az Audiobookshelf a hangfájlokat több eszköz és felhasználó számára elérhető személyes médiakönyvtárrá alakítja. A Docker Compose-os telepítés egyszerű, a megbízható működéshez azonban rendezett mappastruktúra, HTTPS és a médiafájlok külön mentése szükséges.

FAQ

Ingyenes az Audiobookshelf?

Igen. A szerver és a hivatalos kliensek nyílt forráskódú szoftverként érhetők el. Csak a hardverért, VPS-ért, domainért vagy további tárhelyért kell fizetned, ha ezeket használod.

Az Audiobookshelf ingyenes hangoskönyveket biztosít?

Nem. Ez a saját gyűjteményedhez használható szerver és lejátszó. A hangfájlokat jogszerűen kell beszerezned, és magadnak kell hozzáadnod őket a könyvtárhoz.

Hallgathatok könyveket internet nélkül?

Igen. A mobilalkalmazás lehetővé teszi, hogy előre letölts egy könyvet az eszközre. Letöltés után a hallgatáshoz nincs szükség a szerver kapcsolatára.

Mennyi RAM-ra van szüksége az Audiobookshelfnek?

Kis könyvtárhoz és egy-két felhasználóhoz az 1 GB RAM ésszerű kiindulópont. Több hallgatóhoz, kiterjedt vizsgálathoz vagy fájlfeldolgozáshoz jobb 2–4 GB-ot választani.

Kötelező az Audiobookshelf-et VPS-re telepíteni?

Nem. Otthoni szerveren, NAS-on vagy kompatibilis számítógépen is futhat. A VPS akkor kényelmesebb, ha különböző hálózatokból szeretnél folyamatos hozzáférést az otthoni router beállítása és az otthoni kapcsolat korlátai nélkül.