BookStack

BookStack - внутренняя база знаний компании на своем сервере вместо Confluence и Notion. Материалы разложены по полкам, книгам, главам и страницам, а редактор по умолчанию визуальный: чтобы писать, Markdown знать не нужно.

Бухгалтер, HR и первая линия поддержки пишут регламенты в редакторе, похожем на текстовый процессор, а инженеры получают поиск, историю правок, REST API и вебхуки.

Права доходят до отдельной страницы: видно, кто редактирует, кто только читает, а кто не должен видеть раздел вовсе. Для отдела кадров или финансов это решающая деталь.

Структура жесткая, как в книге: страница живет в главе или в книге, книга - на полке. Свободно раскидать файлы по папкам, как в файловой помойке, здесь не получится, и это осознанное решение автора.

Для читателя жесткая иерархия - плюс: он всегда видит оглавление книги и понимает, где находится. Внутри страницы работает визуальный редактор, а Markdown можно включить режимом, если сотрудник к нему привык.

Главное отличие - в тарифной модели. У BookStack нет платной версии вообще: одна MIT-сборка для всех, платных модулей и облака вендора не существует. Дополнительно можно купить только поддержку мейнтейнера.

Цены Confluence - по странице вендора на 10 октября 2026: Standard стоит $5,42 за пользователя в месяц, отсюда и суммы в таблице (25 × $5,42 и 50 × $5,42). В России его не купить: Atlassian остановил продажи в 2022 году и продление лицензий с 31 октября 2022.

Считайте так: фиксированные 500 ₽/мес заменяют подписку за каждого участника и от размера команды не зависят - платите за сервер, а не за место.

На прошлом разборе стояла 26.05.4. За лето вышли security-патч 26.05.5 и фичерелиз 26.09, сейчас актуален 26.09.1 от 29 сентября. Установка и требования не поменялись.

Главное в 26.09 - настройка интерфейса. В «Моей учетной записи» появился раздел Interface Preferences: язык, темная тема и раскладка. Блоки можно перетаскивать между колонками или убирать в «неиспользуемые».

Два изменения важны технически. Во-первых, APP_KEY теперь обязателен: без него приложение не стартует, а не подставляет значение по умолчанию. Во-вторых, PDF-экспорт перешел на встроенный движок и больше не требует отдельной программы.

BookStack - монолит на Laravel. Рядом MariaDB, а TLS терминирует Caddy. Фоновых воркеров нет: синхронная отправка писем и вебхуков работает из коробки, очередь включается отдельной переменной.

Официального Docker-образа у проекта нет. В документации первым назван образ LinuxServer.io, а compose для него лежит в официальном репозитории проекта, поэтому ставим его: версия закреплена тегом, обновление - сменой тега.

Приложение слушает только 127.0.0.1:6875, база данных наружу не смотрит вовсе. Наружу открыт только Caddy с сертификатом Let's Encrypt.

1. Создайте сервер и поставьте Docker

   Тариф CPU2-RAM4-DISK50, Ubuntu 24.04 LTS. Пропишите A-запись домена на IP сервера и откройте 80 и 443: порт 80 нужен Caddy для выпуска сертификата.

   ssh root@ваш-домен
   sudo apt-get update && sudo apt-get install -y ca-certificates curl
   sudo install -m 0755 -d /etc/apt/keyrings
   sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
   sudo chmod a+r /etc/apt/keyrings/docker.asc
   echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu noble stable" | sudo tee /etc/apt/sources.list.d/docker.list >/dev/null
   sudo apt-get update && sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

2. Сгенерируйте секреты

   В примере апстрима ключ приложения и пароли захардкожены - меняем все три. Ключ генерирует штатный хелпер образа.

   mkdir -p ~/bookstack && cd ~/bookstack
   sudo docker run --rm --entrypoint /bin/bash ghcr.io/linuxserver/bookstack:version-v26.09.1 appkey
   openssl rand -hex 16
   openssl rand -hex 16

   Первая строка с openssl - пароль базы, вторая - пароль root-пользователя MariaDB.

3. Опишите стек

   Создайте ~/bookstack/compose.yml. Теги закреплены на конкретные версии, APP_URL - сразу реальный внешний адрес с https: ссылки хранятся абсолютными, и с localhost за прокси ломаются редиректы.

   services:
     bookstack:
       image: ghcr.io/linuxserver/bookstack:version-v26.09.1
       container_name: bookstack
       environment:
         APP_URL: https://ваш-домен
         APP_KEY: "base64:вывод_команды_appkey"
         APP_LANG: ru
         DB_HOST: db
         DB_DATABASE: bookstackapp
         DB_USERNAME: bookstack
         DB_PASSWORD: "первый_openssl_rand"
       volumes: [ ./app_data:/config ]
       ports: [ "127.0.0.1:6875:80" ]
       depends_on: [ db ]
       restart: unless-stopped
     db:
       image: ghcr.io/linuxserver/mariadb:version-11.4.12-r0
       container_name: bookstack_db
       environment:
         MYSQL_ROOT_PASSWORD: "второй_openssl_rand"
         MYSQL_DATABASE: bookstackapp
         MYSQL_USER: bookstack
         MYSQL_PASSWORD: "первый_openssl_rand"
       volumes: [ ./db_data:/config ]
       restart: unless-stopped
     caddy:
       image: caddy:2
       container_name: bookstack_caddy
       ports: [ "80:80", "443:443" ]
       volumes:
         - ./Caddyfile:/etc/caddy/Caddyfile
         - ./caddy_data:/data
         - ./caddy_config:/config
       depends_on: [ bookstack ]
       restart: unless-stopped

4. Настройте TLS

   Caddy сам получит сертификат Let's Encrypt, если домен уже указывает на сервер.

   cat > ~/bookstack/Caddyfile <<'EOF'
   ваш-домен {
     reverse_proxy bookstack:80
   }
   EOF

5. Поднимите стек

   Образы примерно 1,2 ГБ. Сразу после запуска Caddy отдает 502: MariaDB готовит базу, а BookStack прогоняет около 140 миграций. До страницы входа проходит около двух минут.

   cd ~/bookstack && sudo docker compose up -d
   sudo docker compose ps

6. Смените пароль администратора

   Первая миграция создает учетку admin@admin.com с паролем password. Docker-путь сам пароль не меняет, поэтому смените его сразу - до того, как откроете сайт наружу.

   sudo docker exec bookstack php /app/www/artisan tinker --execute="\$u = \BookStack\Users\Models\User::where('email','admin@admin.com')->first(); \$u->forceFill(['password' => \Illuminate\Support\Facades\Hash::make('ваш-пароль')])->save();"

7. Проверьте вход

   Страница входа должна ответить 200, а логин с новым паролем - пустить в вики.

   curl -s -o /dev/null -w '%{http_code}\n' https://ваш-домен/login

Проверил и рост. Добавил книгу, 60 страниц с текстом и 5 картинок: база выросла с 2,1 до 5,2 МБ, том с файлами - с 0,5 до 5,1 МБ. Память почти не изменилась, так что запас тарифа не съедается страницами.

Проверено на версии v26.09.1, октябрь 2026. На новых версиях результаты могут отличаться.

В 26.05.5 закрыли критичную уязвимость в социальном входе, а 26.09.1 усилил проверку размера при импорте архивов. Обновляйтесь только на свежую версию: старые релизы апстрим не патчит.

Обновление - смена тега образа и перезапуск. Перед ним сделайте копии, а после проверьте вход.

sed -i 's/bookstack:version-v26.09.1/bookstack:version-v26.09.2/' ~/bookstack/compose.yml
cd ~/bookstack && sudo docker compose pull && sudo docker compose up -d

Бэкапить нужно два места: базу данных и том приложения с загруженными файлами.

cd ~/bookstack
DB_PASSWORD=$(sudo grep -oP 'DB_PASSWORD: "\K[^"]+' compose.yml | head -1)
sudo docker exec bookstack_db mariadb-dump -ubookstack -p"$DB_PASSWORD" --single-transaction --routines bookstackapp > db-backup.sql
tar czf app-data-backup.tar.gz -C ~/bookstack app_data
tar czf db-data-backup.tar.gz -C ~/bookstack db_data

Перед продом закройте четыре пункта: TLS выпущен, пароль администратора сменен, SMTP настроен, бэкапы куда-то уезжают. Порт 6875 наружу не открывайте - его закрывает Caddy.

• Вход через компанию - OIDC, SAML2 и LDAP включаются в бесплатной сборке; MFA можно сделать обязательной по роли.
• Почта - SMTP для приглашений и сброса пароля. Проверено: письмо о сбросе приходит за секунды.
• Внешние системы - REST API и вебхуки; готовых интеграций в ядре не будет.
• Бэкапы и мониторинг - два тома в архив, метрики хоста снимаются любым агентом.