☰
05.10.2026

Как развернуть Wiki.js на VPS для внутренней базы знаний

Введение

Внутренняя база знаний — это центральное место, где команда хранит документацию, инструкции, регламенты и рабочие заметки. Когда информация разбросана по чатам, личным дискам и почте, новые сотрудники дольше входят в курс дела, а опытные специалисты тратят время на повторные объяснения. Решение — развернуть собственную вики-платформу на виртуальном сервере.

В этой статье мы рассмотрим развертывание Wiki.js на VPS от ServerSpace. Мы разберем, какие компоненты нужны, как подготовить сервер, настроить базу данных, запустить приложение в контейнерах, подключить домен и защитить соединение сертификатом. Инструкция ориентирована на системных администраторов, DevOps-инженеров и разработчиков, которые хотят получить контролируемую и расширяемую базу знаний без зависимости от внешних сервисов.

Терминология

Wiki.js — современная вики-платформа с открытым исходным кодом, написанная на Node.js. Она поддерживает Markdown, визуальный редактор, разграничение прав, поиск, версионирование страниц и интеграцию с системами аутентификации.

VPS (Virtual Private Server) — виртуальный выделенный сервер. В отличие от shared-хостинга, VPS дает полный root-доступ, изолированные ресурсы и возможность устанавливать любое программное обеспечение. В ServerSpace VPS можно развернуть за несколько минут, выбрав подходящую конфигурацию и операционную систему.

Docker — платформа контейнеризации, которая упаковывает приложение и его зависимости в изолированный образ. Это упрощает установку, обновление и перенос Wiki.js между серверами.

Docker Compose — инструмент для описания многоконтейнерных приложений в одном YAML-файле. Мы будем использовать его, чтобы одновременно запустить Wiki.js и PostgreSQL.

PostgreSQL — объектно-реляционная СУБД. Wiki.js хранит в ней страницы, историю изменений, настройки и учетные записи пользователей. PostgreSQL рекомендуется как основная база данных для Wiki.js.

Nginx — веб-сервер и обратный прокси. Мы настроим его для приема HTTPS-запросов и перенаправления их на Wiki.js, работающий на внутреннем порту.

Let's Encrypt — центр сертификации, выдающий бесплатные SSL/TLS-сертификаты. Certbot автоматизирует получение и продление сертификатов.

Принцип работы

Wiki.js — это приложение, которое принимает HTTP-запросы от браузера, обрабатывает их и возвращает HTML-страницы. Основные данные хранятся в базе данных. Схема взаимодействия компонентов выглядит так:

Браузер → Nginx (HTTPS) → Wiki.js (порт 3000) → PostgreSQL (порт 5432)

Nginx принимает защищенное соединение от пользователя, расшифровывает его и передает запрос контейнеру Wiki.js. Wiki.js обращается к PostgreSQL за содержимым страниц, правами доступа и настройками. Ответ возвращается в обратном порядке.

Такая архитектура дает несколько преимуществ. Во-первых, Wiki.js не публикуется напрямую в интернет — доступ к нему возможен только через Nginx. Во-вторых, база данных изолирована во внутренней Docker-сети и недоступна извне. В-третьих, каждый компонент можно обновлять или заменять независимо.

Wiki.js поддерживает несколько типов баз данных, но для продакшена мы рекомендуем PostgreSQL — она обеспечивает надежность и поддержку транзакций. Для полнотекстового поиска в Wiki.js требуется включенное расширение pg_trgm (в официальном Docker-образе PostgreSQL оно доступно; при необходимости его нужно активировать в базе).

Практическое применение

Wiki.js подходит для решения разных задач внутри организации:

В отличие от облачных решений, собственный VPS дает полный контроль над данными. Информация не покидает инфраструктуру компании, а доступ можно ограничить корпоративной сетью или VPN.

Для развертывания Wiki.js достаточно VPS с 1–2 ядрами CPU и 2 ГБ оперативной памяти. Для комфортной работы и запаса на будущее можно выбрать конфигурацию с 4 ГБ RAM и 50 ГБ SSD. Этого хватит для команды до 50 человек и нескольких тысяч страниц. Если планируется активная работа с вложениями или рост числа пользователей, ресурсы можно увеличить в панели управления ServerSpace без переустановки системы.

Практическая инструкция

Подготовка VPS

Мы предполагаем, что у вас уже есть аккаунт в ServerSpace и создан VPS с Ubuntu 22.04 или 24.04. Подключитесь к серверу по SSH:

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

Обновите систему и установите базовые утилиты:

apt update && apt upgrade -y
apt install -y curl wget git ufw

Установка Docker и Docker Compose

Установим Docker из официального репозитория. Сначала добавим ключ и источник:

install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null

Теперь установим Docker и плагин Compose:

apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Проверим, что Docker работает:

docker --version
docker compose version

Включим автозапуск Docker при загрузке сервера:

systemctl enable docker
systemctl start docker

Создание структуры проекта

Создадим каталог для Wiki.js и подкаталоги для данных:

mkdir -p /opt/wiki
cd /opt/wiki

Настройка Docker Compose

Создадим файл docker-compose.yml:

nano docker-compose.yml

Вставим следующую конфигурацию. Обратите внимание: пароль для PostgreSQL нужно заменить на надежный.

services:
db:
image: postgres:16-alpine
container_name: wikijs-db
restart: unless-stopped
environment:
POSTGRES_DB: wikijs
POSTGRES_USER: wikijs
POSTGRES_PASSWORD: "ЗАМЕНИТЕ_НА_СЛОЖНЫЙ_ПАРОЛЬ"
volumes:
- ./postgres-data:/var/lib/postgresql/data
networks:
- wiki-net
healthcheck:
test: ["CMD-SHELL", "pg_isready -U wikijs -d wikijs"]
interval: 5s
timeout: 5s
retries: 5
wiki:
image: ghcr.io/requarks/wiki:2
container_name: wikijs-app
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
DB_TYPE: postgres
DB_HOST: db
DB_PORT: 5432
DB_USER: wikijs
DB_PASS: "ЗАМЕНИТЕ_НА_СЛОЖНЫЙ_ПАРОЛЬ"
DB_NAME: wikijs
ports:
- "127.0.0.1:3000:3000"
volumes:
- ./wiki-data:/wiki/data
networks:
- wiki-net
networks:
wiki-net:
driver: bridge

В этой конфигурации Wiki.js доступен только на localhost порту 3000. Это сделано намеренно — внешний доступ будет осуществляться через Nginx. База данных PostgreSQL доступна только внутри Docker-сети wiki-net. Отдельный том ./wiki-data используется для загруженных файлов и других локальных данных Wiki.js.

Запустим контейнеры:

docker compose up -d

Проверим статус:

docker compose ps

Через несколько секунд оба контейнера должны быть в состоянии running. Контейнер Wiki.js может запуститься с небольшой задержкой, пока PostgreSQL не пройдет проверку healthcheck.

Установка и настройка Nginx

Установим Nginx и Certbot:

apt install -y nginx certbot python3-certbot-nginx

Создадим конфигурацию виртуального хоста. Предположим, что домен wiki.example.com уже указывает на IP вашего сервера.

nano /etc/nginx/sites-available/wiki.example.com

Содержимое файла:

server {
listen 80;
server_name wiki.example.com;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
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;
proxy_cache_bypass $http_upgrade;
}
}

Активируем сайт и проверим конфигурацию:

ln -s /etc/nginx/sites-available/wiki.example.com /etc/nginx/sites-enabled/
nginx -t

Перезагрузим Nginx:

systemctl reload nginx

Получение SSL-сертификата

Запустим Certbot для автоматического получения сертификата Let's Encrypt:

certbot --nginx -d wiki.example.com

Certbot задаст несколько вопросов: адрес электронной почты для уведомлений и согласие с условиями. После завершения он настроит HTTPS и добавит автоматическое перенаправление с HTTP на HTTPS.

Проверим, что автопродление сертификата работает:

certbot renew --dry-run

Первичная настройка Wiki.js

Откроем браузер и перейдем по адресу https://wiki.example.com. При первом открытии Wiki.js проверит подключение к базе данных. Если параметры верны, откроется мастер первичной настройки.

Шаг 1. Создадим учетную запись администратора: укажем email, пароль и URL сайта.

Шаг 2. После создания администратора мы попадем в панель управления. Здесь можно настроить название вики, логотип, язык интерфейса и параметры аутентификации.

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

Резервное копирование

Основные данные Wiki.js (страницы, история изменений, настройки, учетные записи) хранятся в PostgreSQL. Загруженные файлы по умолчанию сохраняются в томе wiki-data. Поэтому для полного резервного копирования нужно сохранять и дамп базы данных, и каталог с файлами.

Создадим скрипт:

nano /opt/wiki/backup.sh

Содержимое:

#!/bin/bash
BACKUP_DIR="/opt/wiki/backups"
DATE=$(date +%Y-%m-%d_%H-%M-%S)
mkdir -p "$BACKUP_DIR"
# Дамп базы данных
docker exec wikijs-db pg_dump -U wikijs -F c wikijs > "$BACKUP_DIR/wikijs_$DATE.dump"
# Архив загруженных файлов и локальных данных Wiki.js
tar -czf "$BACKUP_DIR/wiki-data_$DATE.tar.gz" -C /opt/wiki wiki-data
# Удаление резервных копий старше 30 дней
find "$BACKUP_DIR" -type f -mtime +30 -delete

Сделаем скрипт исполняемым и добавим задание в cron для ежедневного запуска в 3 часа ночи:

chmod +x /opt/wiki/backup.sh
(crontab -l 2>/dev/null; echo "0 3 * * * /opt/wiki/backup.sh") | crontab -

Для восстановления из дампа используем команду:

docker exec -i wikijs-db pg_restore -U wikijs -d wikijs --clean < /opt/wiki/backups/wikijs_2026-01-01_03-00-00.dump

Для восстановления каталога с файлами:

tar -xzf /opt/wiki/backups/wiki-data_2026-01-01_03-00-00.tar.gz -C /opt/wiki

Перед восстановлением рекомендуется остановить контейнеры, а после завершения — запустить их снова.

Настройка firewall

Включим UFW и разрешим только необходимые порты:

ufw allow OpenSSH
ufw allow 'Nginx Full'
ufw enable

Порт 3000 не открываем — он доступен только внутри сервера.

Заключение

Мы развернули Wiki.js на VPS от ServerSpace с использованием Docker Compose, PostgreSQL и Nginx. Получилась полноценная внутренняя база знаний с поддержкой HTTPS, автоматическим резервным копированием и изоляцией компонентов.

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

Для дальнейшего развития базы знаний рекомендуем настроить Git-синхронизацию — это даст дополнительную защиту от потери данных и позволит вести документацию в привычном редакторе кода. Также стоит рассмотреть подключение внешнего поискового движка, если количество страниц превысит несколько тысяч.

Развертывание на VPS ServerSpace занимает меньше часа, а полученная система остается управляемой и прозрачной на всех уровнях.