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

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`).