СЕРВИС КАТАЛОГА: 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). МОИ ОШИБКИ: путь к каталогу не совпал (нули на странице); обновлённый файл не попал в контейнер, а я собрал образ из старого; проверка входа заголовком не проходит — нужна настоящая сессия.
128 lines
5.5 KiB
Markdown
128 lines
5.5 KiB
Markdown
# Библиотека: как всё устроено и как проверить
|
|
|
|
Для администратора (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`).
|