Language: bg

Audiobookshelf: как да създадете собствен сървър за аудиокниги и подкасти

Започнете да слушате книга на компютъра, продължете от същото място на телефона, изтеглете я преди пътуване и запазете напредъка си при смяна на устройството — за всичко това не е нужно да разчитате на поредната платена услуга. Audiobookshelf превръща собствената ви аудиоколекция в подредена онлайн библиотека с корици, глави, приложения и отделни профили за цялото семейство.

Това не е нито магазин, нито източник на безплатни книги. Потребителите сами добавят законно придобити аудиофайлове без несъвместима DRM защита. В замяна книгите, историята на слушане и настройките остават на собствения им сървър.

Какво представлява Audiobookshelf?

Audiobookshelf е безплатен сървър с отворен код и самостоятелно хостване за аудиокниги и подкасти. Той сканира папки с медийни файлове, организира библиотеката по автори и поредици, извлича метаданни и корици, а след това ви позволява да слушате колекцията през браузър или мобилно приложение.

На практика това е лична стрийминг услуга, чийто каталог изграждате сами. Сървърът съхранява библиотеката и напредъка на слушане, а телефонът, таблетът или компютърът ви служи като клиент. Така можете да спрете книга на едно устройство и да продължите на друго от запазената позиция.

Audiobookshelf може да работи у дома на NAS или мини компютър. VPS е по-удобен, когато ви е нужен достъп от всяка мрежа, без да държите домашен компютър включен, да настройвате пренасочване на портове или да зависите от домашната си интернет връзка.

Какво може Audiobookshelf?

Синхронизиране на напредъка между устройствата

Всеки потребител има собствена запазена позиция, история и отметки. Налични са уеб интерфейс, Progressive Web App и официални мобилни клиенти за Android и iOS. Можете предварително да изтеглите книга на телефона си и да я слушате без интернет връзка.

Създаване на отделни акаунти

На един сървър можете да създадете няколко потребители, без да смесвате напредъка им. Администраторът управлява достъпа до библиотеките и разрешенията и при нужда може да ограничава съдържанието по тагове. Всеки потребител запазва собствен списък с започнати книги, история и отметки.

Организиране на библиотеката

Услугата извлича заглавия, описания, автори и корици от външни източници, групира книгите по автори и поредици и ви позволява да коригирате главите и да следите реда им. Няколко MP3 файла могат да бъдат обединени в един M4B файл, а корицата и метаданните могат да бъдат вградени във файла. Преди да променяте оригиналните файлове, е най-добре да направите копие на библиотеката.

Автоматично изтегляне на подкасти

Подкаст може да бъде добавен по заглавие, RSS URL или OPML файл, след което можете да зададете автоматично изтегляне на новите епизоди по график. Услугата не предава епизода директно: файлът първо се записва на сървъра. Това позволява да архивирате епизоди, които може да изчезнат, но изисква и достатъчно дисково пространство.

Съхраняване на електронна книга до аудиокнигата

Можете да поставите EPUB, PDF, CBR, CBZ, AZW3 или MOBI файл в папката на книгата, така че аудиото и текстът да се отварят от един и същ запис в библиотеката. Вграденият четец е базов и не заменя Calibre-Web или Kavita.

За кого е подходящ Audiobookshelf?

Услугата е особено полезна в няколко ситуации:

• вече имате колекция от аудиокниги във формати MP3, M4B, M4A или други разпространени формати;
• слушате на няколко устройства и искате синхронизация;
• няколко членове на семейството използват библиотеката;
• искате да запазите собствен архив от подкасти;
• искате пълен контрол върху файловете, потребителските акаунти и резервните копия;
• обикновена облачна папка е станала неудобна, защото няма корици, глави и история на слушане.

Ако слушате само една или две книги на един телефон, отделен сървър може да не е необходим. Audiobookshelf е най-полезен, когато колекцията расте или се нуждае от постоянен отдалечен достъп.

Какъв сървър е необходим за Audiobookshelf?

Проектът няма единно официално минимално изискване: натоварването зависи от размера на библиотеката, броя потребители, сканирането на файлове и това дали е необходимо транскодиране на аудио. За малка лична колекция можете да използвате следната начална конфигурация като ориентир:

Сценарий	CPU	RAM	Диск
1–2 потребители, малка библиотека	1 vCPU	1 GB	от 30–40 GB
Семейна употреба и няколко едновременни връзки	2 vCPU	2 GB	от 60–100 GB
Голяма библиотека, често сканиране и обработка на файлове	2–4 vCPU	4 GB	според размера на колекцията

Това е практичен ориентир, а не официален минимум. Дисковото пространство е основният ресурс. Десетчасова книга при 64–128 Kbit/s заема приблизително 0,3–0,6 GB, така че сто книги изискват около 30–60 GB, без да броим подкастите и резервните копия. Разумно е да започнете с малък VPS, който по-късно може да бъде надграден.

Как да инсталирате Audiobookshelf с Docker Compose

Docker е препоръчваният от разработчиците метод за инсталиране. Следващите стъпки предполагат, че Docker и Compose плъгинът вече са инсталирани на Ubuntu или Debian.

Създайте директорията на проекта и папките за данни:

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

Създайте файл 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

Стартирайте контейнера:

docker compose up -d

След стартирането таблото временно ще бъде достъпно на адрес:

http://SERVER_IP:13378

При първото посещение създайте основния администраторски акаунт, след това добавете библиотека от тип Books и посочете директорията /audiobooks. За подкасти създайте отделна библиотека с път /podcasts.

Как да организирате правилно папките с аудиокниги

В Audiobookshelf една книга обикновено съответства на една папка. Най-ясната структура изглежда така:

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

При самостоятелна книга нивото за поредица може да бъде пропуснато. Един M4B файл също може да се съхранява в собствена папка на книгата.

Структурата има значение: ако няколко книги от един автор са поставени в обща папка, скенерът може да ги обедини в един запис в библиотеката. По-добре е да организирате файловете преди първото пълно сканиране. Преместването на книга между библиотеки се приема като създаване на нов елемент, затова метаданните и напредъкът не се прехвърлят автоматично.

Как безопасно да направите библиотеката достъпна през интернет

Не се препоръчва таблото постоянно да бъде оставено на отворения HTTP порт 13378. За отдалечен достъп е по-добре да свържете домейн, HTTPS сертификат и обратен прокси на базата на Nginx, Caddy или Traefik.

Audiobookshelf използва WebSocket, затова поддръжката му трябва да бъде включена в проксито. След настройване на HTTPS портът на контейнера може да бъде свързан само към локалния интерфейс:

ports:
  - "127.0.0.1:13378:80"

Използвайте уникални пароли, създайте отделен акаунт за всеки слушател, поддържайте контейнера актуален и не давайте администраторски права без необходимост.

Какво трябва да знаете за резервните копия

Вградените резервни копия на Audiobookshelf запазват базата данни и част от метаданните, включително кориците от директорията metadata. Аудиокнигите, подкастите и кориците, съхранявани заедно с медийните файлове, не са включени в това копие.

Затова надеждната стратегия за резервиране има две части:

1. автоматично вградено копие на базата данни и метаданните;
2. отделно копие на директориите audiobooks и podcasts на друг диск или в отдалечено хранилище.

Директорията /config съдържа SQLite базата данни. Разработчиците препоръчват тя да се пази на локален диск на същия сървър, вместо да се монтира през мрежата: мрежовото хранилище може да намали производителността и да причини повреда на базата данни.

Audiobookshelf на VPS от tropic.host

За лична библиотека максималната изчислителна мощ е по-малко важна от постоянната достъпност, достатъчното дисково пространство и стабилната връзка. На VPS Audiobookshelf работи денонощно и остава достъпен от телефон, компютър или таблет независимо от състоянието на домашната ви мрежа.

За малка колекция можете да започнете с базов сървър на tropic.host, да инсталирате Docker, да свържете домейн и HTTPS, а след това да увеличавате ресурсите с разрастването на библиотеката. Когато избирате план, първо преценете размера на аудиофайловете и оставете място за нови книги и подкасти.

Ограничения, които е добре да знаете предварително

Audiobookshelf не предоставя каталог с книги и не премахва DRM защитата. Той работи с файлове, които потребителите добавят сами и имат право да съхраняват.

Мобилните приложения се разработват активно и официално запазват бета статуса си, затова уеб интерфейсът или PWA остава полезен резервен вариант. Поддръжката на електронни книги е базова, а подреденото импортиране на голяма колекция изисква спазване на структурата на папките и понякога ръчно коригиране на метаданните.

За аудиокниги услугата предоставя всичко, което липсва на обикновена облачна папка: глави, поредици, проследяване на напредъка, офлайн изтегляния, профили и поддръжка на подкасти.

Заключение

Audiobookshelf превръща аудиофайловете в лична медийна библиотека за няколко устройства и потребители. Инсталирането с Docker Compose е лесно, но надеждната работа изисква подредена структура на папките, HTTPS и отделни резервни копия на медийните файлове.

FAQ

Audiobookshelf безплатен ли е?

Да. Сървърът и официалните клиенти се разпространяват като софтуер с отворен код. Плащате само за хардуер, VPS, домейн или допълнително хранилище, ако използвате такива.

Audiobookshelf предоставя ли безплатни аудиокниги?

Не. Това е сървър и плейър за собствената ви колекция. Трябва да придобивате аудиофайловете законно и сами да ги добавяте в библиотеката.

Мога ли да слушам книги без интернет връзка?

Да. Мобилното приложение позволява предварително да изтеглите книга на устройството. След изтеглянето връзка със сървъра не е необходима за слушане.

Колко RAM е необходима на Audiobookshelf?

За малка библиотека и един или двама потребители 1 GB RAM е разумно начало. При няколко слушатели, обширно сканиране или обработка на файлове е по-добре да изберете 2–4 GB.

Задължително ли е да инсталирам Audiobookshelf на VPS?

Не. Той може да работи на домашен сървър, NAS или съвместим компютър. VPS е по-удобен, когато ви е нужен денонощен достъп от различни мрежи без настройване на домашен рутер или зависимост от домашната връзка.