Установка BookStack на свой сервер: термины и чек-лист

Подробности, цифры, термины и чек-лист по теме «Установка BookStack на свой сервер». Страница справочника целиком: Установка BookStack.

Коротко о теме

Установка BookStack на VPS в Docker с образом LinuxServer и MariaDB: порт 6875, APP_URL, роли и права, вход через LDAP и копии базы.

Подробности по разделам

Что такое BookStack и кому подойдёт его структура из книг

Если нужна свободная структура, тонкие права по путям и вход через внешние сервисы, посмотрите Wiki.js. Общую таблицу движков даёт страница self hosted wiki.

Какие требования у BookStack: PHP 8.2 и MySQL или MariaDB

Три ответа, и калькулятор подберёт готовую конфигурацию

Домен, APP_URL и HTTPS для BookStack

Порт 6875 наружу не оставляйте. Поставьте перед контейнером Caddy или Nginx, направьте поддомен на сервер и закройте порт в брандмауэре. Прокси при этом передаёт запросы на 127.0.0.1:6875, а в compose порт пробрасывается как 127.0.0.1:6875:80.

Роли, права и вход сотрудников в BookStack

Для входа сотрудников подключают LDAP, SAML2 или OpenID Connect, в том числе через Keycloak. Приглашения и сброс пароля уходят по почте, поэтому сразу настройте SMTP в переменных окружения: без него новичкам не придёт ссылка. Если регистрация не нужна, отключите её в настройках.

Копии и обновление BookStack без потери книг

Обновление в Docker это docker compose pull и docker compose up -d, миграции база проходит сама. Перед обновлением сделайте дамп: откатить версию приложения легко, откатить базу без дампа нельзя.

Ключевые цифры

Термины на странице

MySQL
MySQL и MariaDB это базы данных, с которыми работают WordPress, Битрикс и другие популярные CMS.
Linux
Linux это семейство операционных систем для серверов: Ubuntu, Debian, AlmaLinux и другие.
PHP
PHP это язык, на котором работают WordPress, Битрикс и другие CMS. Версия PHP влияет на скорость и совместимость сайта.
Nextcloud
Nextcloud это облачное хранилище файлов, которое ставят на свой сервер.
n8n
n8n это программа для автоматизации: связывает сервисы сценариями без программирования.
Nginx
Nginx это веб-сервер и обратный прокси. Его часто ставят перед приложением, чтобы раздавать статику и держать HTTPS.
SMTP
SMTP это протокол отправки писем.
Поддомен
Поддомен это адрес внутри домена, например shop.example.ru.

Что проверить

  1. Храните данные контейнеров в томах.
  2. Закрепляйте версии образов, а не latest.
  3. Ограничьте ресурсы контейнеров, чтобы один не съел весь сервер.
  4. Выберите конфигурацию по памяти и диску под задачу, процессор обычно вторичен.
  5. Проверьте тип виртуализации: KVM даёт свою систему и гарантированные ресурсы.
  6. Уточните, входит ли IPv4 и сколько стоит трафик сверх пакета.

Связанные страницы