news
Serverspace в «Рейтинге провайдеров IaaS Enterprise 2023» от Market.CNews
VB
3 октября 2022
Обновлено 28 июля 2023

Установка и настройка WikiJS на Ubuntu

Linux Ubuntu

Что такое WikiJS

WikiJS — известный вики-движок. Его популярность сегодня растет благодаря таким преимуществам, как открытый исходный код, поддерживаемый большим сообществом разработчиков, простота установки, небольшие системные требования и хорошо читаемая разметка документов по стандарту Markdown.

Требования к серверу

Для установки WikiJS вам необходимы:

  • Сервер с не менее чем 1Гб оперативной памяти и как минимум 10Гб дискового пространства;
  • Актуальная ОС Linux (в этой статье описан пример на Ubuntu 20.04);
  • Учетная запись с повышенными полномочиями;
  • Доменное имя с А-записями, “указывающими” на IP сервера (опционально).

Процесс установки

Процесс настройки WikiJS очень прост, достаточно просто выполнить пошаговую инструкцию:

  • Авторизуйтесь на сервере, обновите существующее программное обеспечение и перезагрузите компьютер, чтобы изменения вступили в силу;
apt-get update; apt upgrade -y && reboot

Обновление ПО на сервере

  • Установите несколько утилит, позволяющих скачивать другие необходимые инструменты и скрипты;
apt install wget curl -y

Установка утилит

  • Установите nodejs;
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash - && apt -y install nodejs

ВАЖНО: NodeJS v18 несовместим с WikiJS! Именно поэтому устанавливается более старая версия.

Установка NodeJS

  • Добавьте в систему дополнительный репозиторий и установите сервис обслуживания и управления базами данных, например, MariaDB;
apt install -y software-properties-common; curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | /bin/bash; apt-get update; apt install -y mariadb-server mariadb-client

Установка MariaDB

  • Активируйте, запустите MariaDB, затем проверьте статус службы;
systemctl enable mariadb; service mariadb start

systemctl status mariadb

Проверка службы MariaDB

  • Задайте минимум необходимых настроек сервиса БД. Установите желаемый пароль, остальные настройки – на ваше усмотрение, можно и оставить значения по умолчанию;
mysql_secure_installation

Настройка сервера

  • Для более удобного управления службой в будущем, “положите” учетные данные для аутентификации в специальный файл;
nano ~/.my.cnf

[client]
user=root
password=<ваш_пароль>

Сохраняем данные в файл

  • Войдите в консоль MariaDB, создайте базу данных и учетную запись и предоставьте этому аккаунту права для управления базой;
create database <имя_базы_данных>;
create user '<логин_пользователя_бд>'@'localhost' identified by '<пароль_пользователя_бд>';
grant all on <имя_базы_данных>.* to '<логин_пользователя_бд>'@'localhost' with grant option;
flush privileges;
exit

Войдите в консоль MariaDB

  • С точки зрения безопасности лучше всего запускать движок WikiJS от имени отдельной учетной записи. Давайте создадим ее и каталог для нашего проекта:
adduser --home /wikijs --disabled-password wikijs

Создание отдельной учетной записи в MariaDB

  • Авторизуйтесь в системе как только что созданный пользователь, скачайте и распакуйте архив с данными платформы WikiJS;
su wikijs

cd ~; wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz; tar -xf *.tar.gz

Распаковка архива с WikiJS

  • Создайте конфигурационный файл для будущей Вики. Подсказка – можно переименовать предложенный файл шаблона и отредактировать его. Нужно указать тип базы данных и ранее созданные учетные данные к ней;
cp config.sample.yml config.yml; nano config.yml

Конфигурационный файл WikiJS

  • Вернитесь обратно в консоль пользователя root, затем создайте через текстовый редактор конфиг для системного сервиса WikiJS:
exit

nano /etc/systemd/system/wiki.service

Конфиг для системного сервиса WikiJS

  • Вставьте указанный ниже код в создаваемый файл и сохраните его;

[Unit]
Description=Wiki
After=network.target

[Service]
Type=simple
ExecStart=/usr/bin/node server
Restart=always

User=wikijs
Environment=NODE_ENV=production
WorkingDirectory=/wikijs

[Install]
WantedBy=multi-user.target

Сохранение конфига

  • Затем создайте в каталоге WikiJS скрипт start.sh со следующим содержимым:

#/bin/bash

sleep 5
/usr/bin/node /wikijs/server

  • “Перечитайте” конфигурацию системы, разрешите автозапуск и запустите созданный вами сервис. Затем проверьте статус службы;
systemctl daemon-reload; systemctl enable wiki; systemctl start wiki

service wiki status

Проверка статуса службы

Завершение конфигурирования

Теперь, когда WikiJS работает, можно внести завершающие штрихи и завершить установку. Откройте в браузере адрес http://<IP-адрес_сервера>:3000 (или http://<ваш_домен>:3000), заполните все необходимые данные и нажмите кнопку INSTALL;

Настройка в браузере

Система применит настройки. Когда процесс закончится, вы увидите “приветственный” экран WikiJS. Установка завершилась успешно, поздравляем!

Установленная WikiJS

Заключение

После прочтения данной статьи вы знаете, что такое WikiJS, каковы системные требования этой платформы и как установить ее платформу на собственный сервер, управляемый Ubuntu 20.04.

Оценка:
5 из 5
Аverage rating : 5
Оценок: 3
191028 Санкт-Петербург Литейный пр., д. 26, Лит. А
+7 (812) 403-06-99
700 300
ООО «ИТГЛОБАЛКОМ ЛАБС»
700 300

Вам также может быть интересно...