☰
31.08.2026

Как сделать корпоративную Wiki

Новый сотрудник приходит в компанию и в первую неделю задаёт один и тот же вопрос по кругу: где взять шаблон отчёта, кто согласовывает договор, как подключиться к тестовому серверу. Коллеги отвечают, отвлекаются от своих задач, а через месяц новичок с похожим вопросом обращается снова, потому что забыл ответ или получил его в личном чате, который никто потом не найдёт.

Корпоративная wiki решает эту проблему. Это внутренний сайт компании, где собраны инструкции, регламенты, описания процессов и ответы на частые вопросы. Сотрудник заходит, находит нужный раздел и получает ответ сам, без обращения к коллегам.

Такая база знаний нужна не только айтишным командам. Она пригодится отделу продаж для хранения скриптов и презентаций, бухгалтерии для регламентов документооборота, HR для процесса адаптации новичков. Порог входа простой: если в компании работает больше десяти человек и информация регулярно теряется в чатах и личных папках, wiki уже окупает время на внедрение.

Почему сейчас: Confluence ушёл, а бизнесу нужна замена

Ещё несколько лет назад разговор о корпоративной wiki для многих компаний сводился к одному имени, Confluence от Atlassian. Платформа была отраслевым стандартом для технической документации и общих баз знаний.

Ситуация изменилась. Atlassian свернул продажи новых лицензий для российских компаний, а обслуживание существующих подписок стало нестабильным из-за проблем с оплатой и курсовых скачков. Часть компаний продолжает пользоваться Confluence через сложные схемы оплаты, но для новых внедрений это уже не рабочий вариант.

В результате бизнес разделился на два лагеря. Одни переходят на российские SaaS сервисы вроде Yandex Wiki, EvaWiki или Teamly. Другие разворачивают собственное решение на сервере и получают полный контроль над данными без ежемесячной платы за каждого пользователя. Дальше в статье разберём именно второй путь.

Готовый сервис или своя wiki на сервере: как выбрать подход

У компании есть два пути создания корпоративной базы знаний.

Первый путь, готовый SaaS сервис. Регистрация занимает пять минут, обновления и техническую поддержку берёт на себя провайдер. Взамен компания платит ежемесячно за каждого пользователя и хранит данные на чужой инфраструктуре.

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

Второй путь подходит компаниям, которые хотят контролировать инфраструктуру, работать с чувствительными данными или сэкономить на подписках при команде от 20 человек и больше. Дальше в статье разберём именно self-hosted вариант шаг за шагом.

Как устроена wiki: из чего состоит и как это работает

Wiki удобно сравнить с папкой файлов на компьютере, только с историей изменений и поиском по содержимому.

Основа любой wiki, страницы с текстом. Страницы объединяются в разделы по темам: онбординг, техническая документация, регламенты отделов. У каждой страницы есть история версий, поэтому видно, кто и когда внёс правку, а при ошибке можно откатиться к прежней версии.

Поиск работает по всему тексту, а не только по названиям страниц, поэтому сотрудник находит нужную информацию, даже если не помнит точное название раздела. Права доступа позволяют ограничить редактирование или просмотр отдельных разделов, что важно для документов с зарплатами или персональными данными.

Какие движки бывают: сравнение популярных wiki-платформ

Выбор движка зависит от размера команды и того, насколько глубоко компания готова разбираться в администрировании сервера.

Простые решения вроде BookStack и DokuWiki подходят командам без выделенного технического специалиста. Более гибкие движки вроде Wiki.js или MediaWiki дают больше возможностей, но требуют внимательнее следить за обновлениями и совместимостью компонентов. Docmost ближе к современным инструментам вроде Notion, но заметно требовательнее к ресурсам сервера.

Сравнение основных характеристик собрали в таблице ниже.

Движок Стек Требования к серверу Кому подходит
Wiki.js Node.js, PostgreSQL 1-2 vCPU, от 1.5 ГБ RAM Технической команде, которая ценит гибкий редактор
BookStack PHP, MySQL/MariaDB 1 vCPU, от 1 ГБ RAM Нетехнической команде, нужна простая структура
Docmost Node.js, PostgreSQL 2 vCPU, 4-8 ГБ RAM Командам, которым важен современный редактор в духе Notion
MediaWiki PHP, MySQL/MariaDB/PostgreSQL 1-2 vCPU, от 1 ГБ RAM Крупным командам со сложной структурой контента
DokuWiki PHP, без базы данных 1 vCPU, от 512 МБ RAM Маленьким командам, которым важна простота бэкапа

Для инструкции в этой статье выбрали BookStack. У движка простая архитектура из двух компонентов, понятная иерархия разделов и низкий порог входа для нетехнической команды.

Что понадобится перед установкой: сервер, домен, немного времени

Прежде чем приступать к установке, соберём короткий список того, что понадобится.

Нужен VPS с 2 виртуальными процессорами, 2-4 ГБ оперативной памяти и 20-40 ГБ дискового пространства на NVMe накопителе. Такой конфигурации достаточно для команды в несколько десятков человек с запасом на рост базы знаний. Понадобится чистая установка Ubuntu, доменное имя для будущей wiki и 15-30 минут свободного времени.

Арендовать VPS сервер с готовым образом Ubuntu можно за несколько минут, дальше сервер готов к установке Docker и самого движка.

Пошаговая инструкция: разворачиваем BookStack на VPS через Docker

Дальше разберём установку BookStack пошагово, от подключения к серверу до рабочей wiki с доменом и HTTPS.

Подключаемся к серверу и устанавливаем Docker

Подключаемся к серверу по SSH:

ssh root@ваш_ip_адрес

Обновляем список пакетов и устанавливаем Docker вместе с Docker Compose:

sudo apt update
sudo apt install docker.io docker-compose-plugin -y

Docker удобен тем, что упаковывает приложение вместе со всеми зависимостями в изолированный контейнер. Обновление или перенос wiki на другой сервер сводится к паре команд, без ручной пересборки окружения.

Проверяем, что Docker установился и работает:

sudo systemctl status docker

Готовим docker-compose.yml для BookStack и MySQL

Создаём папку для проекта и файл конфигурации:

mkdir bookstack && cd bookstack
nano docker-compose.yml

Вставляем конфигурацию с двумя сервисами, самим BookStack и базой данных MySQL:

version: "3"
services:
bookstack:
image: lscr.io/linuxserver/bookstack
container_name: bookstack
environment:
- PUID=1000
- PGID=1000
- APP_URL=http://ваш_домен
- DB_HOST=bookstack_db
- DB_PORT=3306
- DB_USER=bookstack
- DB_PASS=надежный_пароль
- DB_DATABASE=bookstackapp
volumes:
- ./app_data:/config
ports:
- "6875:80"
restart: unless-stopped
depends_on:
- bookstack_db
bookstack_db:
image: lscr.io/linuxserver/mariadb
container_name: bookstack_db
environment:
- PUID=1000
- PGID=1000
- MYSQL_ROOT_PASSWORD=надежный_пароль_root
- MYSQL_DATABASE=bookstackapp
- MYSQL_USER=bookstack
- MYSQL_PASSWORD=надежный_пароль
volumes:
- ./db_data:/config
restart: unless-stopped

Пароли в примере нужно заменить на собственные, оставлять их как есть небезопасно.

Запускаем контейнеры и заходим в BookStack первый раз

Запускаем оба контейнера в фоновом режиме:

docker compose up -d

Проверяем логи, пока идёт первая миграция базы данных, это занимает около минуты:

docker compose logs -f bookstack

Быстрый запуск контейнеров и первой миграции базы напрямую зависит от скорости дисковой подсистемы сервера. На VPS с NVMe дисками, например у Serverspace, пересборка и перезапуск контейнеров занимают секунды, что заметно на каждом обновлении движка.

Открываем в браузере http://ip_адрес_сервера:6875 и попадаем на экран входа. Стандартные данные для первого входа, admin@admin.com и пароль password, их нужно сменить сразу после входа в разделе настроек профиля.

Настраиваем домен и HTTPS

Для рабочей wiki нужны доменное имя вместо IP адреса и HTTPS сертификат. Проще всего поставить перед BookStack reverse proxy, например Nginx или Caddy, и подключить бесплатный сертификат Let’s Encrypt.

Пример базовой конфигурации Nginx для проксирования запросов на контейнер BookStack:

server {
listen 80;
server_name wiki.вашдомен.ру;
location / {
proxy_pass http://127.0.0.1:6875;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}

После настройки прокси выпускаем сертификат через certbot и включаем автоматический редирект с HTTP на HTTPS.

Как организовать структуру: разделы, права доступа, ответственные

BookStack выстраивает контент в понятную иерархию: полки объединяют книги по темам, книги делятся на главы, а главы на отдельные страницы. Такая структура интуитивна даже для сотрудников без опыта работы с wiki системами.

Перед наполнением стоит определить несколько крупных полок: онбординг, техническая документация, регламенты отделов. У каждого раздела должен быть ответственный сотрудник, который следит за актуальностью информации. Без владельца раздел быстро зарастает устаревшими данными, а команда перестаёт ему доверять.

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

Начинать стоит с десяти самых частых вопросов новичков, а не с идеальной структуры на сто разделов. Раздел растёт органично, по мере того как сотрудники сами предлагают темы для новых страниц.

Что учесть по 152-ФЗ, если в wiki есть данные сотрудников

Если корпоративная wiki хранит не только инструкции, но и данные о сотрудниках, ФИО, телефоны, структуру подразделений, формально это уже персональные данные, и на компанию распространяется 152-ФЗ.

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

При выборе площадки для self-hosted wiki стоит сразу смотреть на локацию дата-центра провайдера. VPS в российском дата-центре закрывает этот вопрос без дополнительных согласований, если в базе знаний хранятся личные данные сотрудников.

Плюсы и минусы self-hosted wiki

Разберём сильные и слабые стороны подхода, который описан в статье.

К плюсам можно отнести:

Среди минусов стоит выделить:

Практические сценарии применения корпоративной wiki

Разберём пять типовых ситуаций, где корпоративная wiki показывает себя лучше всего.

Онбординг новых сотрудников. Раздел с ответами на частые вопросы новичка сокращает время адаптации и снимает нагрузку с коллег, которые иначе объясняют одно и то же каждому новому человеку.

Техническая документация для разработчиков. Инструкции по доступам, описания архитектуры и порядок действий при инцидентах хранятся в одном месте вместо разрозненных заметок в личных чатах.

Регламенты для отделов без ИТ бэкграунда. Бухгалтерия, HR и отдел продаж фиксируют в wiki порядок согласования документов, шаблоны и внутренние процессы, которые иначе передаются устно от человека к человеку.

Внутренняя база поддержки. Служба поддержки и клиентский сервис хранят готовые ответы на типовые обращения, что ускоряет работу новых сотрудников службы.

Сохранение экспертизы уходящих сотрудников. Когда специалист покидает компанию, его опыт остаётся в текстовом виде вместо того чтобы исчезнуть вместе с человеком, что особенно важно для узкоспециализированных ролей.

Частые ошибки при внедрении wiki и как их избежать

Несколько ошибок повторяются в большинстве компаний, которые внедряют корпоративную wiki впервые.

Выбор движка без оценки ресурсов сервера. Команда выбирает мощный инструмент вроде Docmost, не проверив, что для него нужно 4-8 ГБ оперативной памяти, и потом сталкивается с нехваткой ресурсов. Решение простое: сверяться с требованиями движка перед арендой сервера.

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

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

Отсутствие резервных копий базы данных. При сбое сервера теряется вся накопленная база знаний. Решение: настроить автоматический бэкап базы данных и файлового хранилища хотя бы раз в сутки.

Хранение персональных данных без учёта 152-ФЗ. Компания добавляет в wiki контакты и данные сотрудников, не проверив локацию сервера. Решение: размещать такие данные только на сервере в российском дата-центре.

Отсутствие разграничения прав доступа. Все сотрудники видят зарплатные вилки и кадровые документы, потому что права доступа так и не настроили. Решение: разграничивать доступ на старте, а не после первого инцидента.

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

Заключение: с чего начать и как не бросить проект

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

Дальше база растёт органично: сотрудники сами предлагают темы, ответственные за разделы следят за актуальностью, а вопросы вроде “куда обратиться за шаблоном договора” перестают отнимать время у коллег.