Книжная библиотека: Calibre-Web Automated с автоприёмом

ТРЕБОВАНИЕ: онлайн-библиотека с загрузкой/выгрузкой, добавлением и
статистикой, плюс доставать книги из закрытых Telegram-каналов.

СДЕЛАНО (шаг 1): вместо старого calibre-web поставлен
Calibre-Web Automated.
  * загрузка через веб и через папку приёма /opt/books/ingest;
  * автоприём проверен: положил EPUB -> через минуту книга в библиотеке,
    метаданные прочитаны, папка очистилась;
  * выгрузка и чтение онлайн — в интерфейсе;
  * домен books.buryans.ru остаётся за единым входом;
  * старые контейнеры остановлены и переименованы, откат возможен.

ПРО КАТАЛОГ ИЗ JSON: приложенный файл — каталог Полины, 181 книга и 45
серий со статусами чтения. Это не файлы, а учёт чтения; его место —
отдельный слой «каталог и статистика» с профилями читателей. Заведено
задачами К-2 и К-3.

МОИ ОШИБКИ: запустил контейнер с занятым именем и погасил stderr — новый
контейнер не создался, а я не увидел; и не остановил старый контейнер,
державший порт 8083.

ДАЛЬШЕ: сервис каталога и статистики, загрузчик из Telegram (юзербот,
нужен вход по коду), интеграция с Dashy и наблюдением.
This commit is contained in:
root committed 2026-10-18 19:21:15 +03:00
1 parent ff2837a763
commit a28ea95c46
4 files changed
+150 -1

No files matched your search

+65
View File
@@ -0,0 +1,65 @@
# Онлайн-библиотека книг (18.10.2026)
## Что требовалось
1. Онлайн-библиотека: **загружать и выгружать** книги, добавлять.
2. **Вести статистику.**
3. **Доставать книги из закрытых Telegram-каналов.**
## Что сделано: библиотека
Вместо старого `calibre-web` поставлен **Calibre-Web Automated (CWA)**.
| Возможность | Как работает |
|---|---|
| Загрузка через веб | кнопка загрузки в интерфейсе |
| Загрузка папкой | папка `/opt/books/ingest` — книга появляется сама |
| Выгрузка | скачивание из карточки книги |
| Добавление | метаданные подтягиваются автоматически |
| Конвертация | встроенная (EPUB и др.) |
| Чтение онлайн | встроенная читалка |
### Как устроено
```
/opt/books/
├── config — настройки и пользователи
├── library — сама библиотека (metadata.db + файлы книг)
├── ingest — папка приёма: положил файл — книга добавилась
└── metadata — служебное
```
### Проверено
* положил EPUB в папку приёма → **через минуту книга в библиотеке**;
* метаданные прочитаны (название, автор);
* папка приёма очистилась сама;
* домен `books.buryans.ru` за единым входом;
* старые контейнеры остановлены и переименованы (`calibre-web-legacy`),
откат возможен.
### Мои ошибки в этом шаге
1. **Запустил контейнер с занятым именем и погасил вывод ошибки** — новый
контейнер не создался, а я этого не увидел. Урок: не скрывать stderr
при создании.
2. **Не остановил старый контейнер, державший порт 8083** — новый не мог
занять порт. Решилось полной остановкой старых.
## Про каталог читателя (JSON Полины)
Приложенный файл — каталог прочитанного: **181 книга, 45 серий** со
статусами (прочитано, ждём перевод, следующая доступна и т.п.).
Это не файлы книг, а **учёт чтения**. Его место — отдельный слой
«каталог и статистика» поверх библиотеки файлов. Запланировано
отдельным сервисом, чтобы:
* у каждого читателя был свой профиль (Полина, вы, другие);
* видеть прогресс по сериям и что искать;
* связывать «хочу прочитать» с поиском в Telegram.
## Дальше
1. Сервис каталога и статистики (импорт JSON, профили читателей).
2. Загрузчик из Telegram (юзербот, безопасная схема).
3. Интеграция: Dashy, наблюдение, реестр обновлений.
+13 -1
View File
@@ -36,9 +36,10 @@
| ЗВОНКИ И МЕДИА | 8 | 4 | 1 | **3** |
| СКВОЗНАЯ СВЯЗНОСТЬ | 14 | 6 | 2 | **6** |
| УЛУЧШЕНИЕ СЛУЖБ | 13 | 9 | 0 | **4** |
| КНИЖНАЯ БИБЛИОТЕКА | 5 | 1 | 0 | **4** |
| VPN (этапы 1–4) | 29 | 21 | 3 | **5** |
| РЕЕСТР НАЙДЕННЫХ ПРОБЛЕМ | 17 | 12 | 1 | **4** |
| **ИТОГО** | **102** | **72** | **7** | **23** |
| **ИТОГО** | **107** | **73** | **7** | **27** |
---
@@ -74,6 +75,7 @@
## 1. ЗАВЕРШИТЬ ОБНОВЛЕНИЯ
@@ -159,6 +161,16 @@
| 5.9 | `openclaw` — обновить до свежей версии (нужна миграция конфигурации) | ⬜ |
| 5.10 | Правила тревог на все службы | ✅ 4 группы, 7 правил, 38 служб в метриках |
## КНИЖНАЯ БИБЛИОТЕКА
| № | Задача | Статус |
|---|---|---|
| К-1 | Calibre-Web Automated вместо старого | ✅ загрузка, выгрузка, автоприём из папки |
| К-2 | Сервис каталога и статистики чтения | ⬜ импорт JSON Полины (181 книга, 45 серий) |
| К-3 | Профили читателей | ⬜ у каждого свой каталог |
| К-4 | Загрузчик из Telegram-каналов | ⬜ юзербот, нужен вход по коду |
| К-5 | Интеграция: Dashy, наблюдение, реестр | ⬜ |
## 6. VPN
Раздел введён 17.10.2026 — по аудиту это задача первоочередная:
+34
View File
@@ -0,0 +1,34 @@
#!/bin/bash
set -uo pipefail
CT=111
echo "=== 1. COMPOSE CALIBRE ==="
pct exec $CT -- bash -c 'ls /opt/ 2>/dev/null' | sed 's/^/ /'
pct exec $CT -- bash -c 'cat /opt/calibre/docker-compose.yml 2>/dev/null | head -50' | sed 's/^/ /'
echo
echo "=== 2. ЧТО В КАТАЛОГАХ ==="
pct exec $CT -- bash -c 'ls -la /opt/calibre/ /opt/calibre-web/ 2>/dev/null | head -25' | sed 's/^/ /'
echo
echo "=== 3. ОБРАЗ И ВЕРСИЯ ==="
pct exec $CT -- docker inspect calibre-web --format ' образ: {{.Config.Image}}
создан: {{.Created}}' 2>/dev/null
pct exec $CT -- docker exec calibre-web sh -c 'cat /app/calibre-web/__init__.py 2>/dev/null | grep -i version | head -3' 2>/dev/null | sed 's/^/ /'
echo
echo "=== 4. МОНТИРОВАНИЯ ==="
pct exec $CT -- docker inspect calibre-web --format '{{range .Mounts}} {{.Source}} -> {{.Destination}}{{println}}{{end}}' 2>/dev/null
echo
echo "=== 5. БАЗА КНИГ ==="
pct exec $CT -- bash -c 'find / -maxdepth 5 -name "metadata.db" 2>/dev/null | head -3' | sed 's/^/ /'
pct exec $CT -- bash -c 'find / -maxdepth 5 -name "app.db" 2>/dev/null | head -3' | sed 's/^/ /'
echo
echo "=== 6. СКОЛЬКО КНИГ ==="
pct exec $CT -- bash -c 'docker exec calibre-web sh -c "ls /calibre-library 2>/dev/null | head -5; ls /calibre-library 2>/dev/null | wc -l" 2>/dev/null' | sed 's/^/ /'
echo
echo "=== 7. МЕСТО ==="
pct exec $CT -- bash -c 'df -h / | tail -1' | sed 's/^/ /'
+38
View File
@@ -0,0 +1,38 @@
#!/bin/bash
set -uo pipefail
CT=111
echo "=== 1. ПОЛНАЯ ОСТАНОВКА СТАРЫХ ==="
pct exec $CT -- docker stop calibre-web-legacy calibre-web-legacy2 2>&1 | sed 's/^/ /'
sleep 3
pct exec $CT -- docker ps -a --format ' {{.Names}} | {{.Status}}' 2>/dev/null | grep -i calibre
echo " --- порт 8083 ---"
pct exec $CT -- bash -c 'ss -tlnp 2>/dev/null | grep 8083 || echo " свободен"'
echo
echo "=== 2. УДАЛЯЮ НЕСОЗДАННЫЙ КОНТЕЙНЕР ==="
pct exec $CT -- docker rm -f calibre-web 2>&1 | sed 's/^/ /'
echo
echo "=== 3. ЗАПУСК: ПОЛНЫЙ ВЫВОД ==="
pct exec $CT -- docker run -d --name calibre-web --restart unless-stopped \
--security-opt apparmor=unconfined -p 8083:8083 \
-e PUID=1000 -e PGID=1000 -e TZ=Europe/Moscow -e TRUSTED_PROXY_COUNT=1 \
-v /opt/books/config:/config \
-v /opt/books/library:/calibre-library \
-v /opt/books/ingest:/cwa-book-ingest \
crocodilestick/calibre-web-automated:latest 2>&1 | sed 's/^/ /'
sleep 55
echo
echo "=== 4. СОСТОЯНИЕ ==="
pct exec $CT -- docker inspect calibre-web --format ' статус: {{.State.Status}}
код: {{.State.ExitCode}}
образ: {{.Config.Image}}' 2>/dev/null
echo " --- журнал ---"
pct exec $CT -- docker logs calibre-web --tail 10 2>&1 | sed 's/^/ /'
echo
echo "=== 5. ПРОВЕРКА ==="
echo " напрямую: $(pct exec $CT -- bash -c 'curl -s -o /dev/null -w "%{http_code}" --max-time 10 http://127.0.0.1:8083/ 2>/dev/null')"
echo " домен: $(curl -s -o /dev/null -w '%{http_code}' --max-time 12 -k https://books.buryans.ru/ 2>/dev/null)"