Easy OPDS (EOPDS) поддерживает работу как со встроенной базой данных SQLite, так и с внешней базой PostgreSQL. Для производственного использования рекомендуется использовать PostgreSQL.

Требования

• Docker 24+
• Docker Compose v2+
• Внешний сервер PostgreSQL 14 или новее
• Доступ к каталогу с книгами

Создание базы данных PostgreSQL
Подключитесь к вашему серверу PostgreSQL и выполните:

CREATE USER eopds WITH PASSWORD 'StrongPasswordHere'; 
CREATE DATABASE eopds OWNER eopds; 
GRANT ALL PRIVILEGES ON DATABASE eopds TO eopds;

Параметры подключения:

Параметр: Значение
Хост: 10.16.88.10
Порт: 5432
Имя БД: eopds
Пользователь БД: eopds
Пароль БД: StrongPasswordHere

Создание структуры каталогов
mkdir -p /opt/eopds
mkdir -p /srv/books
mkdir -p /opt/eopds/config
cd /opt/eopds

Каталог /srv/books должен содержать вашу библиотеку книг.

Пример:
/srv/books
├── Фантастика
├── Детективы
├── Научная литература
├── Программирование
└── Техническая документация
Но это не обязательное требование. Все равно книги можно будет отсортировать по названию или автору.

docker-compose.yml

Создайте файл docker-compose.yml:

services:
  eopds:
    image: ghcr.io/iahtoh/eopds:latest
    container_name: eopds
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      TZ: Europe/Moscow
      EOPDS_DB_TYPE: postgres
      EOPDS_DB_HOST: 10.16.88.10
      EOPDS_DB_PORT: 5432
      EOPDS_DB_NAME: eopds
      EOPDS_DB_USER: eopds
      EOPDS_DB_PASSWORD: StrongPasswordHere
    volumes:
      - ./config:/config
      - /srv/books:/books:ro

Запуск контейнера
docker compose pull
docker compose up -d

Проверить состояние контейнера:

docker compose ps

Просмотреть журнал работы:

docker compose logs -f

Открытие веб-интерфейса

После запуска интерфейс будет доступен по адресу:

http://SERVER_IP:8080

Например:

http://10.16.88.10:8080

Обновление
docker compose pull
docker compose up -d

Остановка
docker compose down

Использование через обратный прокси

Для публикации в интернет рекомендуется использовать:

• Nginx
• Nginx Proxy Manager
• nginx-ui
• Traefik
• Caddy

Пример адреса:
https://books.example.com

Дополнительные возможности

Easy OPDS поддерживает:

• OPDS 1.x
• OPDS 2.0
• Web-интерфейс каталога
• Конвертацию книг "на лету"
• PostgreSQL
• SQLite
• Многопользовательский режим
• Интеграцию с внешними ридерами

Поддержка

Если возникли проблемы с установкой:

• создайте тему в разделе Техподдержка
• приложите вывод команды:
  docker compose logs
• укажите используемую версию Easy OPDS и PostgreSQL.

Здравствуйте!

Хочу представить вам Easy OPDS — продолжение развития проекта SOPDS, который многие годы использовался для организации домашних библиотек и OPDS-каталогов электронных книг.

Оригинальный проект был создан автором GitHub-проекта mitshel и распространялся как открытое программное обеспечение. К сожалению, активная разработка SOPDS со временем остановилась, однако сам проект оказался настолько удачным и востребованным, что мне стало жалко позволить ему окончательно уйти в историю.

Так появился Easy OPDS.

Название было изменено специально, чтобы не возникало путаницы между оригинальным SOPDS и его дальнейшим развитием.

Что уже изменилось?
За время работы над проектом была проведена серьёзная модернизация внутренней части системы:

• обновлены зависимости Python и сторонние библиотеки;
• выполнен переход на современные версии Django и сопутствующих компонентов;
• обновлены библиотеки обработки изображений и XML;
• обновлены компоненты работы с базой данных и планировщиком задач;
• улучшена совместимость с современными версиями Linux и PostgreSQL.

Встроенная онлайн-читалка

Одним из самых заметных нововведений стала встроенная онлайн-читалка.
Теперь книги можно открывать и читать непосредственно в браузере без скачивания файлов и установки дополнительных приложений.
Достаточно открыть книгу и начать чтение с любого устройства — компьютера, планшета или смартфона.
В оригинальном SOPDS такой возможности не было.

Новый конвертер книг

Также полностью обновлён механизм конвертации книг.
Вместо прежнего решения используется fb2cng v1.5.3 — современный статический бинарный файл, написанный на Go и не требующий установки дополнительных зависимостей.
Теперь доступны следующие форматы конвертации:

• EPUB 2 (epub2)
• EPUB 3 (epub3)
• Kobo EPUB (kepub)
• Kindle AZW8/KFX (azw8)
• Kindle KFX (kfx)
• PDF (pdf)
• TXT (txt)
• Markdown (md)

Это значительно расширяет возможности использования библиотеки на различных устройствах и ридерах.

Проект открыт для всех

Easy OPDS остаётся полностью открытым проектом.
Исходный код доступен всем желающим, а предложения, исправления ошибок и собственные модификации только приветствуются.
Надеюсь, что проект окажется полезным не только мне, но и другим любителям электронных книг и домашних библиотек.
Добро пожаловать в Easy OPDS!

Здравствуйте!

Многие пользователи знают и используют проект SOPDS, который долгое время оставался одним из наиболее удобных и простых способов организации собственного OPDS-каталога электронных книг.

Проект Easy OPDS появился как продолжение и развитие оригинального проекта SOPDS, созданного автором GitHub-проекта mitshel. Исходный проект распространяется как открытое программное обеспечение и доступен сообществу для изучения и модификации.

К сожалению, активная разработка SOPDS со временем практически остановилась, а сайт продан другому владельцу. Несмотря на это, сам проект оказался очень удачным, востребованным и продолжает использоваться многими владельцами домашних библиотек и серверов электронных книг. Было бы жаль потерять такой полезный инструмент только из-за отсутствия дальнейшей поддержки.

Именно поэтому и появился Easy OPDS.

Основные цели проекта:

• сохранить и продолжить развитие идей оригинального SOPDS;
• исправлять ошибки и устранять накопившиеся проблемы;
• добавлять новые возможности и улучшать удобство использования;
• обеспечить совместимость с современными версиями программного обеспечения и серверных платформ;
• развивать проект совместно с сообществом пользователей.

Название было изменено с SOPDS на Easy OPDS, чтобы избежать путаницы между оригинальным проектом и его дальнейшим развитием.

Easy OPDS остаётся полностью открытым проектом. Исходный код доступен всем желающим, а любые предложения, исправления и модификации приветствуются.

Проект создаётся не только для сообщества, но и вместе с сообществом.

Добро пожаловать в Easy OPDS!