Language: pl

Audiobookshelf: jak utworzyć własny serwer audiobooków i podcastów

Rozpocznij słuchanie książki na komputerze, kontynuuj dokładnie w tym samym miejscu na telefonie, pobierz ją przed podróżą i zachowaj postęp po zmianie urządzenia — do żadnej z tych czynności nie potrzebujesz kolejnej płatnej usługi. Audiobookshelf zamienia własną kolekcję audio w uporządkowaną bibliotekę online z okładkami, rozdziałami, aplikacjami i osobnymi profilami dla całej rodziny.

Nie jest to ani sklep, ani źródło darmowych książek. Użytkownicy samodzielnie dodają legalnie pozyskane pliki audio bez niekompatybilnej ochrony DRM. W zamian książki, historia słuchania i ustawienia pozostają na ich własnym serwerze.

Czym jest Audiobookshelf?

Audiobookshelf to bezpłatny, samodzielnie hostowany serwer audiobooków i podcastów o otwartym kodzie źródłowym. Skanuje foldery z plikami multimedialnymi, porządkuje bibliotekę według autorów i serii, pobiera metadane oraz okładki, a następnie pozwala słuchać kolekcji w przeglądarce lub aplikacji mobilnej.

W praktyce jest to osobista usługa streamingowa, której katalog tworzysz samodzielnie. Serwer przechowuje bibliotekę i postęp słuchania, a telefon, tablet lub komputer pełni funkcję klienta. Możesz więc zatrzymać książkę na jednym urządzeniu i kontynuować na innym od zapisanej pozycji.

Audiobookshelf może działać w domu na serwerze NAS lub mini-PC. VPS jest wygodniejszy, gdy potrzebujesz dostępu z dowolnej sieci bez pozostawiania włączonego komputera domowego, konfigurowania przekierowania portów i uzależnienia od domowego łącza internetowego.

Co potrafi Audiobookshelf?

Synchronizowanie postępu między urządzeniami

Każdy użytkownik ma własną zapisaną pozycję, historię i zakładki. Dostępne są interfejs webowy, Progressive Web App oraz oficjalne aplikacje mobilne na Androida i iOS. Możesz wcześniej pobrać książkę na telefon i słuchać bez połączenia z internetem.

Tworzenie osobnych kont

Na jednym serwerze możesz utworzyć kilku użytkowników bez mieszania ich postępu słuchania. Administrator kontroluje dostęp do bibliotek i uprawnienia, a w razie potrzeby może ograniczać treści według tagów. Każdy użytkownik ma własną listę rozpoczętych książek, historię i zakładki.

Porządkowanie biblioteki

Usługa pobiera tytuły, opisy, autorów i okładki ze źródeł zewnętrznych, grupuje książki według autorów i serii, a także pozwala poprawiać rozdziały i śledzić kolejność. Wiele plików MP3 można połączyć w jeden plik M4B, a okładkę i metadane osadzić w pliku. Przed modyfikacją oryginalnych plików najlepiej utworzyć kopię biblioteki.

Automatyczne pobieranie podcastów

Podcast można dodać po tytule, adresie RSS lub pliku OPML, a następnie zaplanować automatyczne pobieranie nowych odcinków. Usługa nie transmituje odcinka bezpośrednio: plik jest najpierw zapisywany na serwerze. Pozwala to archiwizować odcinki, które mogą zniknąć, ale wymaga także odpowiedniej ilości miejsca na dysku.

Przechowywanie ebooka obok audiobooka

W folderze książki możesz umieścić plik EPUB, PDF, CBR, CBZ, AZW3 lub MOBI, aby dźwięk i tekst otwierały się z tego samego wpisu biblioteki. Wbudowany czytnik jest podstawowy i nie zastępuje Calibre-Web ani Kavita.

Dla kogo przeznaczony jest Audiobookshelf?

Usługa jest szczególnie przydatna w kilku sytuacjach:

• masz już kolekcję audiobooków w MP3, M4B, M4A lub innych popularnych formatach;
• słuchasz na kilku urządzeniach i chcesz synchronizacji;
• z biblioteki korzysta kilku członków rodziny;
• chcesz zachować własne archiwum podcastów;
• potrzebujesz pełnej kontroli nad plikami, kontami użytkowników i kopiami zapasowymi;
• zwykły folder w chmurze stał się niewygodny, ponieważ nie ma okładek, rozdziałów i historii słuchania.

Jeśli słuchasz tylko jednej lub dwóch książek na jednym telefonie, osobny serwer może być zbędny. Audiobookshelf jest najbardziej przydatny, gdy kolekcja rośnie lub wymaga stałego zdalnego dostępu.

Jakiego serwera potrzebuje Audiobookshelf?

Projekt nie ma uniwersalnego oficjalnego minimum: obciążenie zależy od rozmiaru biblioteki, liczby użytkowników, skanowania plików i tego, czy potrzebne jest transkodowanie audio. Dla małej osobistej kolekcji możesz przyjąć następującą konfigurację początkową:

Scenariusz	CPU	RAM	Dysk
1–2 użytkowników, mała biblioteka	1 vCPU	1 GB	od 30–40 GB
Użytek rodzinny i kilka jednoczesnych połączeń	2 vCPU	2 GB	od 60–100 GB
Duża biblioteka, częste skanowanie i przetwarzanie plików	2–4 vCPU	4 GB	zależnie od rozmiaru kolekcji

To praktyczna wskazówka, a nie oficjalne minimum. Głównym zasobem jest przestrzeń dyskowa. Dziesięciogodzinna książka przy przepływności 64–128 Kbit/s zajmuje około 0,3–0,6 GB, więc sto książek wymaga około 30–60 GB, bez podcastów i kopii zapasowych. Rozsądnie jest zacząć od małego VPS, który można później rozbudować.

Jak zainstalować Audiobookshelf z Docker Compose

Docker jest metodą instalacji zalecaną przez twórców. Poniższe kroki zakładają, że Docker i wtyczka Compose są już zainstalowane na Ubuntu lub Debianie.

Utwórz katalog projektu i foldery danych:

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

Utwórz plik compose.yml:

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

Uruchom kontener:

docker compose up -d

Po uruchomieniu panel będzie tymczasowo dostępny pod adresem:

http://SERVER_IP:13378

Przy pierwszej wizycie utwórz konto administratora root, a następnie dodaj bibliotekę typu Books i wskaż katalog /audiobooks. Dla podcastów utwórz osobną bibliotekę ze ścieżką /podcasts.

Jak prawidłowo organizować foldery audiobooków

W Audiobookshelf jedna książka zwykle odpowiada jednemu folderowi. Najczytelniejsza struktura wygląda tak:

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

W przypadku samodzielnej książki poziom serii można pominąć. Pojedynczy plik M4B również można przechowywać w osobnym folderze książki.

Struktura ma znaczenie: jeśli kilka książek tego samego autora trafi do jednego wspólnego folderu, skaner może połączyć je w jeden wpis biblioteki. Lepiej uporządkować pliki przed pierwszym pełnym skanowaniem. Przeniesienie książki między bibliotekami jest traktowane jak utworzenie nowego elementu, dlatego jej metadane i postęp nie są automatycznie przenoszone.

Jak bezpiecznie udostępnić bibliotekę w internecie

Pozostawienie panelu na otwartym porcie HTTP 13378 nie jest zalecane do stałego użytku. Przy zdalnym dostępie lepiej podłączyć domenę, certyfikat HTTPS i reverse proxy oparte na Nginx, Caddy lub Traefik.

Audiobookshelf korzysta z WebSocket, więc proxy musi go obsługiwać. Po skonfigurowaniu HTTPS port kontenera można przypisać wyłącznie do interfejsu lokalnego:

ports:
  - "127.0.0.1:13378:80"

Używaj unikalnych haseł, utwórz osobne konto dla każdej osoby słuchającej, aktualizuj kontener i nie przyznawaj uprawnień administratora bez potrzeby.

Co trzeba wiedzieć o kopiach zapasowych

Wbudowane kopie Audiobookshelf zapisują bazę danych i część metadanych, w tym okładki z katalogu metadata. Audiobooki, podcasty i okładki przechowywane obok plików multimedialnych nie są objęte tą kopią.

Dlatego niezawodna strategia kopii zapasowych ma dwie części:

1. automatyczna wbudowana kopia bazy danych i metadanych;
2. osobna kopia katalogów audiobooks i podcasts na innym dysku lub w zdalnej pamięci.

Katalog /config zawiera bazę SQLite. Twórcy zalecają przechowywanie go na lokalnym dysku tego samego serwera zamiast montowania przez sieć: pamięć sieciowa może obniżyć wydajność i doprowadzić do uszkodzenia bazy.

Audiobookshelf na VPS od tropic.host

W przypadku osobistej biblioteki maksymalna moc obliczeniowa jest mniej ważna niż stała dostępność, odpowiednia ilość miejsca na dysku i stabilne połączenie. Na VPS Audiobookshelf działa przez całą dobę i pozostaje dostępny z telefonu, komputera lub tabletu niezależnie od stanu domowej sieci.

Przy małej kolekcji możesz zacząć od podstawowego serwera tropic.host, zainstalować Dockera, podłączyć domenę i HTTPS, a następnie zwiększać zasoby wraz z rozrostem biblioteki. Przy wyborze planu najpierw oszacuj rozmiar plików audio i zostaw zapas na nowe książki oraz podcasty.

Ograniczenia, które warto znać wcześniej

Audiobookshelf nie udostępnia katalogu książek i nie usuwa ochrony DRM. Działa z plikami, które użytkownicy dodają samodzielnie i do których przechowywania mają prawo.

Aplikacje mobilne są aktywnie rozwijane i oficjalnie nadal mają status beta, dlatego interfejs webowy lub PWA pozostaje przydatnym rozwiązaniem awaryjnym. Obsługa ebooków jest podstawowa, a uporządkowany import dużej kolekcji wymaga zachowania struktury folderów i czasem ręcznej korekty metadanych.

W przypadku audiobooków usługa zapewnia wszystko, czego brakuje zwykłemu folderowi w chmurze: rozdziały, serie, śledzenie postępu, pobieranie offline, profile i obsługę podcastów.

Podsumowanie

Audiobookshelf zamienia pliki audio w osobistą bibliotekę multimediów dla wielu urządzeń i użytkowników. Instalacja z Docker Compose jest prosta, ale niezawodne działanie wymaga uporządkowanej struktury folderów, HTTPS oraz osobnych kopii zapasowych plików multimedialnych.

FAQ

Czy Audiobookshelf jest bezpłatny?

Tak. Serwer i oficjalne klienty są rozpowszechniane jako oprogramowanie open source. Płacisz tylko za sprzęt, VPS, domenę lub dodatkową pamięć, jeśli z nich korzystasz.

Czy Audiobookshelf udostępnia darmowe audiobooki?

Nie. To serwer i odtwarzacz własnej kolekcji. Pliki audio musisz pozyskać legalnie i samodzielnie dodać je do biblioteki.

Czy mogę słuchać książek bez połączenia z internetem?

Tak. Aplikacja mobilna pozwala wcześniej pobrać książkę na urządzenie. Po pobraniu połączenie z serwerem nie jest potrzebne do słuchania.

Ile pamięci RAM potrzebuje Audiobookshelf?

Dla małej biblioteki i jednego lub dwóch użytkowników rozsądnym początkiem jest 1 GB RAM. Przy kilku słuchaczach, intensywnym skanowaniu lub przetwarzaniu plików lepiej wybrać 2–4 GB.

Czy muszę instalować Audiobookshelf na VPS?

Nie. Może działać na serwerze domowym, NAS-ie lub zgodnym komputerze. VPS jest wygodniejszy, gdy potrzebujesz całodobowego dostępu z różnych sieci bez konfigurowania domowego routera i uzależnienia od domowego łącza.