СЕРВИС КАТАЛОГА: 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). МОИ ОШИБКИ: путь к каталогу не совпал (нули на странице); обновлённый файл не попал в контейнер, а я собрал образ из старого; проверка входа заголовком не проходит — нужна настоящая сессия.
5.5 KiB
5.5 KiB
Библиотека: как всё устроено и как проверить
Для администратора (Akadmin). Всё, что нужно, чтобы видеть и проверять.
1. Что построено
| Часть | Адрес | Что делает |
|---|---|---|
| Библиотека книг | https://books.buryans.ru | файлы книг: загрузка, скачивание, чтение |
| Каталог чтения | https://books.buryans.ru/catalog/ | 181 книга, 45 серий, прогресс и статистика |
| Поиск книг | скрипт на сервере | ищет отсутствующие книги в 7 источниках |
Оба адреса — за единым входом Authentik. Отдельных паролей нет.
2. Как проверить, что работает
Быстрая проверка (30 секунд)
Откройте по очереди:
- https://books.buryans.ru — должен открыться каталог книг (после входа);
- 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).