# Библиотека: как всё устроено и как проверить Для администратора (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`).