1
mkdir booklore
2
cd booklore
3

4
---
5

6
## Установка BookLore через Docker
7

8
Самый простой способ развернуть BookLore — использовать Docker.
9

10
Нам понадобятся два файла.
11

12
docker-compose.yml
13

14
```yaml
15
services:                               # Секция описания сервисов (контейнеров)
16
  booklore:                             # Имя сервиса BookLore
17
    image: booklore/booklore:latest     # Docker-образ BookLore из Docker Hub (тег latest)
18
    # image: ghcr.io/booklore-app/booklore:latest
19
    # Альтернативный образ из GitHub Container Registry (закомментирован)
20
    container_name: booklore            # Явное имя контейнера в Docker
21
    environment:                        # Переменные окружения контейнера
22
      - USER_ID=${APP_USER_ID}          # UID пользователя для работы контейнера (права на файлы)
23
      - GROUP_ID=${APP_GROUP_ID}        # GID группы для файлов и каталогов
24
      - TZ=${TZ}                        # Часовой пояс контейнера
25
      - DATABASE_URL=${DATABASE_URL}    # URL подключения к базе данных MariaDB
26
      - DATABASE_USERNAME=${DB_USER}    # Имя пользователя базы данных
27
      - DATABASE_PASSWORD=${DB_PASSWORD} # Пароль пользователя базы данных
28
      - BOOKLORE_PORT=${BOOKLORE_PORT}  # Внутренний порт BookLore
29
    depends_on:                         # Зависимости сервиса
30
      mariadb:                          # Зависимость от сервиса mariadb
31
        condition: service_healthy      # Запуск только после успешного healthcheck БД
32
    ports:
33
      - "${BOOKLORE_PORT}:${BOOKLORE_PORT}"   # Проброс порта: host → container (обычно не нужен при использовании Traefik)
34
    volumes:
35
      - ./data:/app/data                # Данные приложения BookLore
36
      - ./books:/books                  # Каталог с библиотекой книг
37
      - ./bookdrop:/bookdrop            # Папка для автоматического импорта книг
38
    healthcheck:                        # Проверка работоспособности контейнера
39
      test: wget -q -O - http://localhost:${BOOKLORE_PORT}/api/v1/healthcheck
40
      # HTTP-запрос к встроенному healthcheck API BookLore
41
      interval: 60s                     # Интервал между проверками
42
      retries: 5                        # Количество попыток до признания контейнера unhealthy
43
      start_period: 60s                 # Время ожидания перед началом проверок
44
      timeout: 10s                      # Таймаут одной проверки
45
    restart: unless-stopped             # Автоперезапуск контейнера (кроме ручной остановки)
46
    networks:
47
      proxy:                            # Подключение к внешней сети proxy (Traefik)
48
    labels:                             # Метки Docker для интеграции с Traefik
49
      - "traefik.enable=true"           # Включаем обработку контейнера Traefik
50
      - "traefik.http.routers.booklore.entrypoints=web" # HTTP-вход (порт 80)
51
      - "traefik.http.routers.booklore.rule=Host(`booklore.stilicho.ru`)" # Направляем трафик с домена booklore.stilicho.ru в этот контейнер
52
      - "traefik.http.middlewares.booklore-https-redirect.redirectscheme.scheme=https" # Middleware для редиректа HTTP → HTTPS
53
      - "traefik.http.routers.booklore.middlewares=booklore-https-redirect" # Применяем middleware редиректа к HTTP-маршруту
54
      - "traefik.http.routers.booklore-secure.entrypoints=websecure" # HTTPS-вход (порт 443)
55
      - "traefik.http.routers.booklore-secure.rule=Host(`booklore.stilicho.ru`)" # HTTPS-маршрут для того же домена
56
      - "traefik.http.routers.booklore-secure.tls=true" # Включаем TLS (HTTPS)
57
      - "traefik.http.routers.booklore-secure.service=booklore"  # Привязываем HTTPS-роутер к сервису booklore
58
      - "traefik.http.services.booklore.loadbalancer.server.port=6060" # Внутренний порт BookLore внутри контейнера
59
      - "traefik.docker.network=proxy" # Указываем Traefik, в какой Docker-сети искать контейнер
60

61
  mariadb:                              # Сервис базы данных MariaDB
62
    image: lscr.io/linuxserver/mariadb:11.4.5
63
    # Образ MariaDB от LinuxServer.io (стабильный и удобный)
64
    container_name: mariadb             # Явное имя контейнера
65
    environment:                        # Переменные окружения MariaDB
66
      - PUID=${DB_USER_ID}              # UID владельца файлов БД
67
      - PGID=${DB_GROUP_ID}             # GID владельца файлов БД
68
      - TZ=${TZ}                        # Часовой пояс
69
      - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}       # Пароль root-пользователя БД
70
      - MYSQL_DATABASE=${MYSQL_DATABASE}       # Имя базы данных, создаваемой при первом запуске
71
      - MYSQL_USER=${DB_USER}       # Пользователь БД
72
      - MYSQL_PASSWORD=${DB_PASSWORD}    # Пароль пользователя БД
73
    volumes:
74
      - ./mariadb/config:/config        # Каталог с данными и конфигурацией MariaDB
75
    restart: unless-stopped             # Автоперезапуск контейнера
76
    healthcheck:                        # Проверка доступности БД
77
      test: [ "CMD", "mariadb-admin", "ping", "-h", "localhost" ]
78
      interval: 5s                      # Интервал проверки
79
      timeout: 5s                       # Таймаут проверки
80
      retries: 10                       # Количество попыток
81
    networks:
82
      proxy:                            # Подключение к сети proxy (Traefik)
83

84
networks:
85
  proxy:                                # Определение сети proxy
86
    external: true                      # Сеть уже существует и не создаётся Compose