Files
buryan-infra/docs/library/INSTALL-ADMIN.md
T
root 60866cd2b6 Каталог книг: сервис со статистикой; поиск расширен (7 источников); инструкции в Matrix
СЕРВИС КАТАЛОГА: https://books.buryans.ru/catalog/ за единым входом.
  * 181 книга, 45 серий, 25 книг к поиску;
  * страницы «Обзор», «Серии», «Книги», «Что искать»;
  * API /api/summary и /health;
  * профили читателей (сейчас Полина);
  * написан на стандартной библиотеке Python — нечему ломаться.

СХЕМА: nginx /catalog/ -> oauth2-proxy-catalog :9990 -> catalog :9200.

ПОИСК РАСШИРЕН ДО 7 ИСТОЧНИКОВ: ЛитРес (цены), Open Library (ISBN),
ФантЛаб, Google Books — напрямую; archive.org, libgen, Флибуста — через
VPN-шлюз, потому что в России заблокированы. ЛитРес через VPN НЕ ходит
(блокирует зарубежные адреса). Результат: находки у 15 из 25 книг,
libgen добавил ещё совпадения.

ИНСТРУКЦИИ ОТПРАВЛЕНЫ В MATRIX в личные чаты: Akadmin — как устроено,
как проверить, где что лежит, как обновить; Полина — как войти, искать,
загружать книги. Matrix требует метод PUT (на POST вернул 405).

МОИ ОШИБКИ: путь к каталогу не совпал (нули на странице); обновлённый
файл не попал в контейнер, а я собрал образ из старого; проверка входа
заголовком не проходит — нужна настоящая сессия.
2026-10-18 20:54:17 +03:00

5.5 KiB

Библиотека: как всё устроено и как проверить

Для администратора (Akadmin). Всё, что нужно, чтобы видеть и проверять.

1. Что построено

Часть Адрес Что делает
Библиотека книг https://books.buryans.ru файлы книг: загрузка, скачивание, чтение
Каталог чтения https://books.buryans.ru/catalog/ 181 книга, 45 серий, прогресс и статистика
Поиск книг скрипт на сервере ищет отсутствующие книги в 7 источниках

Оба адреса — за единым входом Authentik. Отдельных паролей нет.

2. Как проверить, что работает

Быстрая проверка (30 секунд)

Откройте по очереди:

  1. https://books.buryans.ru — должен открыться каталог книг (после входа);
  2. https://books.buryans.ru/catalog/ — должна быть страница «Каталог книг» с числами 181 / 45 / 25.

Проверка командой

pct exec 111 -- docker ps --format '{{.Names}} {{.Status}}' | grep -E 'calibre|catalog'

Должно быть три работающих контейнера: calibre-web, catalog, oauth2-proxy-catalog.

curl -s -o /dev/null -w '%{http_code}\n' http://192.168.1.240:9200/health

Должно вернуть 200.

3. Где что лежит

/opt/books/
├── config      настройки Calibre-Web (пользователи, права)
├── library     сама библиотека: metadata.db + файлы книг
├── ingest      папка приёма: положил файл — книга добавилась
└── metadata    служебное

/opt/catalog/
├── catalog_app.py   приложение каталога
└── data/
    ├── catalog.db             база каталога
    └── polina-library.json    исходный каталог Полины

4. Как обновить каталог

Если у Полины появился новый список прочитанного:

# 1. положить новый JSON
scp новый-каталог.json root@192.168.1.10:/root/polina-library.json
pct push 111 /root/polina-library.json /opt/catalog/data/polina-library.json

# 2. перезапустить каталог (он перечитает файл)
pct exec 111 -- docker restart catalog

5. Как запустить поиск книг

ssh root@192.168.1.10
python3 /root/book_finder.py /root/polina-library.json /root/book-finder-report.md

Результат: /root/book-finder-report.md (для чтения) и .json (для программ). Поиск идёт 10–20 минут: 25 книг × 7 источников.

Важно про маршруты:

Источники Как ходим Почему
ЛитРес, Open Library, ФантЛаб, Google Books напрямую ЛитРес блокирует зарубежные адреса
archive.org, libgen, Флибуста через VPN-шлюз 192.168.1.161:7890 в России заблокированы

6. Из чего состоит поиск

Источник Что даёт Доступность
ЛитРес цена и ссылка на покупку напрямую
Open Library ISBN, год, язык, издатель напрямую
ФантЛаб карточка, серия, отзывы напрямую
Google Books метаданные напрямую (квота)
archive.org архив книг, много старых через VPN
libgen книжный архив через VPN
Флибуста русские переводы через VPN

Плюс всегда даются ссылки на Гутенберг, КулЛиб, ЛитМир, Bookmate, Анну.

7. Что важно знать про ограничения

  • Google Books имеет бесплатную квоту — при исчерпании отдаёт 429. Поиск это переживает, просто пропускает источник.
  • ЛитРес через VPN не работает (блокирует зарубежные адреса) — поэтому он ходит напрямую.
  • Файлы из Telegram без юзербота не скачать: веб-предпросмотр каналов показывает посты, но не даёт файлы.

8. Резервные копии

  • Контейнер CT 111 попадает в общие копии (еженедельно).
  • База каталога — файл catalog.db, копируется вместе с контейнером.
  • Книги лежат в /opt/books/library.

9. Если что-то сломалось

# каталог не открывается
pct exec 111 -- docker logs catalog --tail 30

# библиотека не открывается
pct exec 111 -- docker logs calibre-web --tail 30

# вход не пускает
pct exec 111 -- docker logs oauth2-proxy-catalog --tail 30

Все три контейнера перезапускаются автоматически (restart: unless-stopped).