Статья 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.
Docker Compose
Заголовок раздела «Docker Compose»mkdir -p /opt/bookstack && cd /opt/bookstackBookStack требует ключ шифрования APP_KEY. Образ умеет его сгенерировать:
docker run --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkeyКоманда выведет строку вида base64:.... Сохраните её и пароль базы в .env:
cat > .env <<EOFAPP_KEY=base64:СТРОКА_ИЗ_КОМАНДЫ_ВЫШЕDB_PASSWORD=$(openssl rand -hex 16)EOFchmod 600 .envdocker-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 -ddocker compose logs -f bookstackПри первом старте BookStack создаёт таблицы в базе. Когда в логе появится [ls.io-init] done., можно открывать сайт.
Nginx и HTTPS
Заголовок раздела «Nginx и HTTPS»Конфиг /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 nginxcertbot --nginx -d wiki.example.comclient_max_body_size ограничивает размер вложений и картинок. Подробнее: Nginx, Let’s Encrypt.
Первый вход и смена логина
Заголовок раздела «Первый вход и смена логина»Откройте https://wiki.example.com. Логин по умолчанию: admin@admin.com, пароль password. Этот пароль знают все, поэтому смените его сразу.

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

После этого выйдите и войдите с новыми данными. Остальных сотрудников добавляйте там же, кнопкой «Добавить пользователя». Роли Admin, Editor и Viewer уже созданы.
Если пароль администратора потерян, создайте нового администратора из консоли:
docker compose exec bookstack php /app/www/artisan bookstack:create-adminПолки, книги и страницы
Заголовок раздела «Полки, книги и страницы»Структура BookStack:
| Уровень | Для чего |
|---|---|
| Полка | группа книг, например отдел или проект |
| Книга | отдельная тема: «Инструкции для команды», «Документация API» |
| Глава | необязательный раздел внутри книги |
| Страница | сам текст |
Порядок работы:
- Откройте «Книги» и создайте новую книгу (прямая ссылка
/create-book). Введите название и нажмите «Сохранить книгу». - В книге, в блоке «Действия» справа, выберите создание страницы. Откроется редактор, черновик сохраняется автоматически. Заголовки страницы попадают в навигацию слева.
- Нажмите «Сохранить страницу».

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

Права можно задать на любом уровне: кнопка «Разрешения» у полки, книги или страницы. Например, книгу с паролями от сервисов стоит закрыть от роли Viewer.
Данные BookStack хранятся в базе и в папке ./config/www: там загруженные картинки, вложения и темы.
cd /opt/bookstackdocker 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.gztar -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/bookstackdocker compose pulldocker compose up -ddocker 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 |