Перейти к содержимому

Статья 131 из 141

Гайды

BookStack на VPS: своя база знаний и вики в Docker с MariaDB

BookStack — открытая платформа для документации и внутренней вики. Знания в ней разложены как в библиотеке: полки, на полках книги, в книгах главы и страницы. Есть визуальный редактор и редактор Markdown, поиск, история версий, роли и права доступа. Подойдёт для инструкций команды, документации проекта или личных заметок. Интерфейс переведён на русский.

Ресурс Минимум Комфортно
vCPU 1 2
RAM 512 МБ 1 ГБ
Диск 5 ГБ 10 ГБ и больше под вложения

BookStack с MariaDB после запуска занял около 190 МБ памяти. Ещё нужны:

  • поддомен, например wiki.example.com, с A-записью на IP сервера (DNS);
  • Docker и Docker Compose;
  • Nginx и certbot.

Официального Docker-образа у BookStack нет. Документация проекта ссылается на два образа сообщества: LinuxServer.io и solidnerd. Ниже используется lscr.io/linuxserver/bookstack: он регулярно обновляется и хорошо документирован. На ноябрь 2026 в нём BookStack v26.09.

Окно терминала
mkdir -p /opt/bookstack && cd /opt/bookstack

BookStack требует ключ шифрования APP_KEY. Образ умеет его сгенерировать:

Окно терминала
docker run --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey

Команда выведет строку вида base64:.... Сохраните её и пароль базы в .env:

Окно терминала
cat > .env <<EOF
APP_KEY=base64:СТРОКА_ИЗ_КОМАНДЫ_ВЫШЕ
DB_PASSWORD=$(openssl rand -hex 16)
EOF
chmod 600 .env

docker-compose.yml:

services:
bookstack:
image: lscr.io/linuxserver/bookstack:latest
restart: unless-stopped
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/Moscow
- APP_URL=https://wiki.example.com
- APP_KEY=${APP_KEY}
- APP_LANG=ru
- DB_HOST=db
- DB_PORT=3306
- DB_USERNAME=bookstack
- DB_PASSWORD=${DB_PASSWORD}
- DB_DATABASE=bookstack
volumes:
- ./config:/config
ports:
- "127.0.0.1:6875:80"
depends_on:
- db
db:
image: mariadb:lts
restart: unless-stopped
environment:
MARIADB_DATABASE: bookstack
MARIADB_USER: bookstack
MARIADB_PASSWORD: ${DB_PASSWORD}
MARIADB_RANDOM_ROOT_PASSWORD: "1"
volumes:
- ./db:/var/lib/mysql

Ключевые переменные:

Переменная Что делает
APP_URL полный адрес вики с https://. По нему строятся все ссылки
APP_KEY ключ шифрования сессий. Не меняйте его после установки
APP_LANG язык интерфейса по умолчанию, ru включает русский
DB_* подключение к MariaDB
PUID, PGID владелец файлов в ./config на хосте

Запуск:

Окно терминала
docker compose up -d
docker compose logs -f bookstack

При первом старте BookStack создаёт таблицы в базе. Когда в логе появится [ls.io-init] done., можно открывать сайт.

Конфиг /etc/nginx/sites-available/bookstack:

server {
listen 80;
server_name wiki.example.com;
client_max_body_size 50M;
location / {
proxy_pass http://127.0.0.1:6875;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Окно терминала
ln -s /etc/nginx/sites-available/bookstack /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d wiki.example.com

client_max_body_size ограничивает размер вложений и картинок. Подробнее: Nginx, Let’s Encrypt.

Откройте https://wiki.example.com. Логин по умолчанию: admin@admin.com, пароль password. Этот пароль знают все, поэтому смените его сразу.

Страница входа BookStack на русском

  1. Откройте «Настройки» → «Пользователи» и выберите пользователя Admin. Прямая ссылка: /settings/users/1.
  2. Задайте своё имя и рабочий email. Email используется как логин.
  3. В блоке «Пароль пользователя» введите новый пароль не короче 8 символов и подтверждение.
  4. Нажмите «Сохранить».

Смена пароля администратора в BookStack

После этого выйдите и войдите с новыми данными. Остальных сотрудников добавляйте там же, кнопкой «Добавить пользователя». Роли Admin, Editor и Viewer уже созданы.

Если пароль администратора потерян, создайте нового администратора из консоли:

Окно терминала
docker compose exec bookstack php /app/www/artisan bookstack:create-admin

Структура BookStack:

Уровень Для чего
Полка группа книг, например отдел или проект
Книга отдельная тема: «Инструкции для команды», «Документация API»
Глава необязательный раздел внутри книги
Страница сам текст

Порядок работы:

  1. Откройте «Книги» и создайте новую книгу (прямая ссылка /create-book). Введите название и нажмите «Сохранить книгу».
  2. В книге, в блоке «Действия» справа, выберите создание страницы. Откроется редактор, черновик сохраняется автоматически. Заголовки страницы попадают в навигацию слева.
  3. Нажмите «Сохранить страницу».

Страница BookStack с навигацией по заголовкам и книге

  1. «Полки» → «Новая полка». Введите название, в списке справа нажмите «Добавить» у нужных книг и сохраните полку.

Полка BookStack с книгой внутри

Права можно задать на любом уровне: кнопка «Разрешения» у полки, книги или страницы. Например, книгу с паролями от сервисов стоит закрыть от роли Viewer.

Данные BookStack хранятся в базе и в папке ./config/www: там загруженные картинки, вложения и темы.

Окно терминала
cd /opt/bookstack
docker compose exec -T db mariadb-dump -u bookstack -p"$(grep DB_PASSWORD .env | cut -d= -f2)" --single-transaction bookstack | gzip > /root/bookstack-db-$(date +%F).sql.gz
tar -czf /root/bookstack-files-$(date +%F).tar.gz -C /opt/bookstack config/www docker-compose.yml .env

Обязательно сохраните .env: восстанавливайте вики с тем же APP_KEY, которым она шифровала данные. Копии храните вне сервера: бэкапы.

Восстановление базы:

Окно терминала
gunzip -c /root/bookstack-db-2026-11-18.sql.gz | docker compose exec -T db sh -c 'mariadb -u bookstack -p"$MARIADB_PASSWORD" bookstack'

Если вики переезжает на другой адрес, поменяйте APP_URL в docker-compose.yml, выполните docker compose up -d и замените старые ссылки в базе:

Окно терминала
docker compose exec bookstack php /app/www/artisan bookstack:update-url https://old.example.com https://wiki.example.com
Окно терминала
cd /opt/bookstack
docker compose pull
docker compose up -d
docker compose logs -f bookstack

Миграции базы образ выполняет сам при старте, в логе они видны как строки ... DONE. Перед обновлением сделайте бэкап.

Симптом Причина и решение
Стили не грузятся, ссылки ведут на http:// или чужой адрес Неверный APP_URL. Исправьте и выполните bookstack:update-url
Ошибка 500 сразу после установки Проверьте, что APP_KEY задан и начинается с base64:. Сгенерируйте его командой appkey
SQLSTATE[HY000] [2002] при старте MariaDB ещё запускается или неверный DB_HOST. Подождите и проверьте docker compose logs db
413 Request Entity Too Large при загрузке картинки Увеличьте client_max_body_size в Nginx
Интерфейс на английском Не задан APP_LANG=ru, или у пользователя выбран другой язык в профиле, поле «Предпочитаемый язык»
Письма о сбросе пароля не приходят Не настроена почта. Задайте переменные MAIL_* по документации BookStack