Как установить Wiki.js на AlmaLinux

Wiki.js — это современная и мощная вики-платформа с открытым исходным кодом, построенная на Node.js. Она предлагает удобный интерфейс для создания, редактирования и организации контента, что делает ее отличным выбором для создания документации и совместной работы. В этой статье представлено полное пошаговое руководство по установке Wiki.js на AlmaLinux 9, благодаря чему у вас будет все необходимое для начала работы с собственной вики.

Необходимые условия

Прежде чем начать процесс установки, убедитесь, что у вас есть следующие необходимые условия:

Сервер AlmaLinux 9 с правами root или sudo.
Стабильное интернет-соединение.
Базовые знания об операциях в командной строке.
Программные пакеты: Docker, Node.js, PostgreSQL.

Шаг 1: Обновление системы

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

sudo dnf update -y

Шаг 2: Установите Docker

Docker — это платформа, позволяющая разработчикам автоматизировать развертывание приложений внутри легких контейнеров. Она упрощает установку и управление такими приложениями, как Wiki.js.

Чтобы установить Docker на AlmaLinux 9, выполните следующие команды:

sudo dnf install -y dnf-utils
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io
sudo systemctl start docker
sudo systemctl enable docker

Проверьте, правильно ли установлен Docker, выполнив команду:

docker --version

Шаг 3: Установите Node.js

Node.js необходим для работы Wiki.js, поскольку он обеспечивает среду выполнения JavaScript. Для оптимальной производительности рекомендуется последняя версия LTS.

curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo dnf install -y nodejs

Проверьте установку, проверив версию Node.js:

node --version

Шаг 4: Установите PostgreSQL

Для хранения содержимого Wiki.js требуется база данных. PostgreSQL — надежный и прочный выбор для этой цели.

sudo dnf install -y postgresql-server postgresql-contrib
sudo postgresql-setup --initdb
sudo systemctl start postgresql
sudo systemctl enable postgresql

Создайте новую базу данных и пользователя для Wiki.js:

sudo -u postgres psql
CREATE DATABASE wikijs;
CREATE USER wikiuser WITH ENCRYPTED PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE wikijs TO wikiuser;
q

Шаг 5: Загрузка и настройка Wiki.js

Вы можете загрузить последнюю версию Wiki.js с GitHub:

wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz
mkdir -p /var/www/wikijs
tar -xzf wiki-js.tar.gz -C /var/www/wikijs --strip-components=1

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

cd /var/www/wikijs
cp config.sample.yml config.yml
nano config.yml

Шаг 6: Создание службы Systemd для Wiki.js

Создайте файл службы для управления Wiki.js в качестве фоновой службы:

sudo nano /etc/systemd/system/wikijs.service

Добавьте конфигурацию службы:

 [Unit]
Description=Wiki.js
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/node /var/www/wikijs/server
Restart=always
User=your_user_name
Environment=NODE_ENV=production
WorkingDirectory=/var/www/wikijs
[Install]
WantedBy=multi-user.target

Сохраните изменения и выйдите

Включите и запустите службу

sudo systemctl daemon-reload
sudo systemctl enable wikijs
sudo systemctl start wikijs

Шаг 7: Настройте параметры брандмауэра

Если у вас включен брандмауэр, разрешите трафик HTTP и HTTPS:

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload

Шаг 8: Доступ к мастеру настройки Wiki.js

Теперь вы можете получить доступ к мастеру настройки Wiki.js через веб-браузер. Перейдите на:

http://your-server-ip:3000

Устранение общих проблем

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

journalctl -u wikijs

Если подключение к PostgreSQL не удается, проверьте правильность учетных данных базы данных в файле `config.yml`.
Если Docker не запускается, проверьте, запущен ли он с помощью:

systemctl status docker

Если у вас возникнут какие-либо другие проблемы, обратитесь за помощью к официальной документации Wiki.js или на форумы сообщества.

Поздравляем! Вы успешно установили Wiki.js. Для получения дополнительной помощи или полезной информации мы рекомендуем вам посетить официальный сайт Wiki.js.