Новый сотрудник приходит в компанию и в первую неделю задаёт один и тот же вопрос по кругу: где взять шаблон отчёта, кто согласовывает договор, как подключиться к тестовому серверу. Коллеги отвечают, отвлекаются от своих задач, а через месяц новичок с похожим вопросом обращается снова, потому что забыл ответ или получил его в личном чате, который никто потом не найдёт.
Корпоративная 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:
Обновляем список пакетов и устанавливаем Docker вместе с Docker Compose:
sudo apt install docker.io docker-compose-plugin -y
Docker удобен тем, что упаковывает приложение вместе со всеми зависимостями в изолированный контейнер. Обновление или перенос wiki на другой сервер сводится к паре команд, без ручной пересборки окружения.
Проверяем, что Docker установился и работает:
Готовим docker-compose.yml для BookStack и MySQL
Создаём папку для проекта и файл конфигурации:
nano docker-compose.yml
Вставляем конфигурацию с двумя сервисами, самим BookStack и базой данных MySQL:
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 первый раз
Запускаем оба контейнера в фоновом режиме:
Проверяем логи, пока идёт первая миграция базы данных, это занимает около минуты:
Быстрый запуск контейнеров и первой миграции базы напрямую зависит от скорости дисковой подсистемы сервера. На VPS с NVMe дисками, например у Serverspace, пересборка и перезапуск контейнеров занимают секунды, что заметно на каждом обновлении движка.
Открываем в браузере http://ip_адрес_сервера:6875 и попадаем на экран входа. Стандартные данные для первого входа, admin@admin.com и пароль password, их нужно сменить сразу после входа в разделе настроек профиля.
Настраиваем домен и HTTPS
Для рабочей wiki нужны доменное имя вместо IP адреса и HTTPS сертификат. Проще всего поставить перед BookStack reverse proxy, например Nginx или Caddy, и подключить бесплатный сертификат Let’s Encrypt.
Пример базовой конфигурации Nginx для проксирования запросов на контейнер BookStack:
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
Разберём сильные и слабые стороны подхода, который описан в статье.
К плюсам можно отнести:
- Полный контроль над данными и инфраструктурой.
- Отсутствие ежемесячной платы за каждого пользователя, только стоимость сервера.
- Более простое соответствие требованиям 152-ФЗ при выборе российского дата-центра.
- Гибкость настройки под конкретные процессы компании.
Среди минусов стоит выделить:
- Ответственность за сервер, обновления и резервные копии ложится на компанию.
- Нужен минимальный технический навык для установки и поддержки.
- Обновления движка и зависимостей приходится отслеживать вручную.
- При росте нагрузки может понадобиться увеличение ресурсов сервера.
Практические сценарии применения корпоративной wiki
Разберём пять типовых ситуаций, где корпоративная wiki показывает себя лучше всего.
Онбординг новых сотрудников. Раздел с ответами на частые вопросы новичка сокращает время адаптации и снимает нагрузку с коллег, которые иначе объясняют одно и то же каждому новому человеку.
Техническая документация для разработчиков. Инструкции по доступам, описания архитектуры и порядок действий при инцидентах хранятся в одном месте вместо разрозненных заметок в личных чатах.
Регламенты для отделов без ИТ бэкграунда. Бухгалтерия, HR и отдел продаж фиксируют в wiki порядок согласования документов, шаблоны и внутренние процессы, которые иначе передаются устно от человека к человеку.
Внутренняя база поддержки. Служба поддержки и клиентский сервис хранят готовые ответы на типовые обращения, что ускоряет работу новых сотрудников службы.
Сохранение экспертизы уходящих сотрудников. Когда специалист покидает компанию, его опыт остаётся в текстовом виде вместо того чтобы исчезнуть вместе с человеком, что особенно важно для узкоспециализированных ролей.
Частые ошибки при внедрении wiki и как их избежать
Несколько ошибок повторяются в большинстве компаний, которые внедряют корпоративную wiki впервые.
Выбор движка без оценки ресурсов сервера. Команда выбирает мощный инструмент вроде Docmost, не проверив, что для него нужно 4-8 ГБ оперативной памяти, и потом сталкивается с нехваткой ресурсов. Решение простое: сверяться с требованиями движка перед арендой сервера.
Отсутствие ответственного за раздел. Wiki без владельца быстро наполняется устаревшей информацией, а сотрудники перестают ей доверять. Решение: назначить куратора для каждого крупного раздела.
Слишком глубокая вложенность разделов. Если до нужной страницы нужно кликнуть пять раз, никто не будет её искать. Решение: ограничивать вложенность двумя или тремя уровнями.
Отсутствие резервных копий базы данных. При сбое сервера теряется вся накопленная база знаний. Решение: настроить автоматический бэкап базы данных и файлового хранилища хотя бы раз в сутки.
Хранение персональных данных без учёта 152-ФЗ. Компания добавляет в wiki контакты и данные сотрудников, не проверив локацию сервера. Решение: размещать такие данные только на сервере в российском дата-центре.
Отсутствие разграничения прав доступа. Все сотрудники видят зарплатные вилки и кадровые документы, потому что права доступа так и не настроили. Решение: разграничивать доступ на старте, а не после первого инцидента.
Слишком сложный язык в статьях. Регламенты пишут канцелярским языком, который сложно читать. Решение: писать простыми словами и короткими абзацами, будто объясняешь коллеге лично.
Заключение: с чего начать и как не бросить проект
Корпоративная wiki работает, если её не пытаются сделать идеальной с первого дня. Выбрать движок под размер команды, арендовать сервер под нагрузку, поднять BookStack за полчаса и начать с десяти самых частых вопросов новичков: вот рабочий маршрут, который описан в статье.
Дальше база растёт органично: сотрудники сами предлагают темы, ответственные за разделы следят за актуальностью, а вопросы вроде “куда обратиться за шаблоном договора” перестают отнимать время у коллег.