Comment installer Wiki.js sur Ubuntu 18.04 LTS

Wiki.js est une application wiki open source, moderne et puissante basée sur Node.js, Git et Markdown. Wiki.js fonctionne sur le moteur extrêmement rapide Node.js et est optimisé pour économiser les ressources du processeur. Certaines des fonctionnalités de Wiki.js qui méritent d'être mentionnées sont :

Édition Markdown, soutenue par Git
Léger, mais extrêmement puissant
Magnifiquement conçu pour le Web moderne
Contrôle d'accès intégré
Gestion intuitive des ressources
Moteur de recherche intégré

Dans ce didacticiel, nous vous guiderons tout au long du processus d'installation de la version 1 de Wiki.js sur un système d'exploitation Ubuntu 18.04 LTS en utilisant NGINX comme serveur proxy inverse, MongoDB comme serveur de base de données, PM2 comme gestionnaire de processus et éventuellement, vous pouvez sécuriser le transport. couche en utilisant acme.sh client et l'autorité de certification Let's Encrypt pour ajouter la prise en charge SSL.

Exigences

Les conditions requises pour exécuter Wiki.js sont les suivantes :

Node.js 6.11.1 vers 10.x est obligatoire.
Version MongoDB 3.2 ou plus tard.
Version Git 2.7.4 ou plus tard.
Logiciels de serveur Web tels que NGINX, Apache, Caddy, H2O...
Un référentiel Git vide (facultatif).
Au moins 512 Mo de RAM. 1 Go de RAM recommandé.
Environ 300 Mo d'espace disque.
Nom de domaine avec enregistrement DNS A/AAAA configurés.

Prérequis

Un système d'exploitation Ubuntu 18.04 LTS.
Un utilisateur non root avec sudo privilèges.

Étapes initiales

Vérifiez votre version d'Ubuntu :

lsb_release -ds
# Ubuntu 18.04.1 LTS

Configurez le fuseau horaire :

sudo dpkg-reconfigure tzdata

Mettez à jour les packages de votre système d'exploitation (logiciels). Il s'agit d'une première étape importante car elle garantit que vous disposez des dernières mises à jour et correctifs de sécurité pour les packages logiciels par défaut de votre système d'exploitation :

sudo apt update && sudo apt upgrade -y

Installez certains packages essentiels nécessaires à l'administration de base du système d'exploitation Ubuntu :

sudo apt install -y curl wget vim git unzip socat bash-completion apt-transport-https build-essential

Étape 1 - Installer Node.js et npm

Wiki.js est basé sur Node.js. Nous allons installer la dernière version recommandée pour Wiki.js qui est la version 10 au moment d'écrire ces lignes. Sous Linux, vous disposez de quelques options d'installation de Node.js :les binaires Linux (x86/x64), le code source ou via les gestionnaires de packages. Nous utiliserons une option de gestion des packages qui facilite l'installation et la mise à jour de Node.js.

Téléchargez et installez la dernière version recommandée de Node.js à partir du référentiel NodeSource :

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt install -y nodejs

REMARQUE : npm est distribué avec Node.js, ce qui signifie que lorsque vous téléchargez Node.js, vous obtenez automatiquement npm installé sur votre système.

Vérifiez les versions de Node.js et npm :

node -v && npm -v
# v10.15.1
# 6.4.1

Npm est un projet distinct de Node.js et a tendance à être mis à jour plus fréquemment. Par conséquent, même si vous venez de télécharger Node.js (et donc npm), vous devrez probablement mettre à jour votre npm. Heureusement, npm sait se mettre à jour ! Pour mettre à jour votre npm, saisissez ceci dans votre terminal :

sudo npm install -g [email protected]

Cette commande mettra à jour npm vers la dernière version stable.

Revérifiez la version npm avec :

npm -v
# 6.8.0

Et il devrait renvoyer le dernier numéro de version.

Étape 2 - Installer la base de données MongoDB

Wiki.js a besoin d'une base de données pour stocker ses données, et la version stable actuelle de Wiki.js ne prend en charge que le moteur de base de données MongoDB. Selon cela, nous devrons installer la base de données MongoDB.

Téléchargez et installez la base de données MongoDB :

sudo apt install -y mongodb

Vérifiez la version de MongoDB :

mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.3
# db version v3.6.3

Démarrer et activer (configurez-le pour qu'il démarre au redémarrage ) Service MongoDB s'il n'est pas déjà démarré et activé :

sudo systemctl start mongodb.service
sudo systemctl enable mongodb.service

Étape 3 – Installer `acme.sh` client et obtenir le certificat Let's Encrypt (facultatif )

Sécuriser votre site Web avec HTTPS n'est pas nécessaire, mais c'est une bonne pratique pour sécuriser le trafic de votre site. Afin d'obtenir un certificat SSL de Let's Encrypt, nous utiliserons acme.sh client. Acme.sh est un logiciel shell UNIX pur pour obtenir des certificats SSL de Let's Encrypt sans aucune dépendance.

Téléchargez et installez acme.sh :

sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh 
./acme.sh --install --accountemail [email protected]
source ~/.bashrc
cd ~

Vérifiez acme.sh version :

acme.sh --version
# v2.8.1

Obtenir RSA et ECC/ECDSA certificats pour votre domaine/nom d'hôte :

# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256

Si vous voulez de faux certificats pour les tests, vous pouvez ajouter --staging indicateur aux commandes ci-dessus.

Pour répertorier vos certificats émis, vous pouvez exécuter :

acme.sh --list

Créez des dossiers pour stocker vos certificats. Nous utiliserons /etc/letsencrypt mais cela peut être tout ce que vous préférez pour stocker les certificats SSL.

mkdir -p /etc/letsencrypt/example.com
mkdir -p /etc/letsencrypt/example.com_ecc

Installez/copiez les certificats dans le répertoire /etc/letsencrypt.

# RSA
acme.sh --install-cert -d example.com \ 
        --cert-file /etc/letsencrypt/example.com/cert.pem \
        --key-file /etc/letsencrypt/example.com/private.key \
        --fullchain-file /etc/letsencrypt/example.com/fullchain.pem \
        --reloadcmd "sudo systemctl reload nginx.service"

# ECC/ECDSA
acme.sh --install-cert -d example.com --ecc \
        --cert-file /etc/letsencrypt/example.com_ecc/cert.pem \
        --key-file /etc/letsencrypt/example.com_ecc/private.key \
        --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem \
        --reloadcmd "sudo systemctl reload nginx.service"

Après avoir exécuté les commandes ci-dessus, vos certificats et les clés sera dans :

Pour RSA : /etc/letsencrypt/example.com répertoire.
Pour ECC/ECDSA : /etc/letsencrypt/example.com_ecc répertoire.

Tous les certificats seront automatiquement renouvelés tous les 60 jours.

Après avoir obtenu les certificats, quittez l'utilisateur root et revenez à l'utilisateur sudo normal :

exit

Étape 4 - Installer et configurer NGINX

Wiki.js (ou toute application HTTP Node.js) peut s'exécuter sans aucun serveur Web réel (tel que NGINX ou Apache). Cependant, il est fortement recommandé de mettre un serveur web standard devant Wiki.js. Cela garantit que vous pouvez utiliser des fonctionnalités telles que SSL, plusieurs sites Web, la mise en cache, etc. Nous utiliserons NGINX dans ce didacticiel, mais tout autre serveur fera l'affaire, il vous suffit de le configurer correctement.

Téléchargez et installez NGINX à partir du référentiel NGINX officiel en exécutant les commandes suivantes :

wget https://nginx.org/keys/nginx_signing.key
sudo apt-key add nginx_signing.key
rm nginx_signing.key
sudo -s
printf "deb https://nginx.org/packages/mainline/ubuntu/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/ubuntu/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx

Vérifiez la version de NGINX :

sudo nginx -v
# nginx version: nginx/1.15.8

Activer et démarrer le service NGINX :

sudo systemctl enable nginx.service
sudo systemctl start nginx.service

Exécutez sudo vim /etc/nginx/conf.d/wiki.js.conf

sudo vim /etc/nginx/conf.d/wiki.js.conf

et configurez NGINX en tant que proxy inverse HTTPS.

server {
    
    listen [::]:443 ssl http2;
    listen 443 ssl http2;
    listen [::]:80;
    listen 80;
    
    server_name example.com;

    charset utf-8;
    client_max_body_size 50M;

    ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/example.com/private.key;
    ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;
    
    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        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_next_upstream error timeout http_502 http_503 http_504;
    }
    
}

La seule chose que vous devez modifier dans la configuration ci-dessus est server_name directive, le nom de domaine dans les chemins d'accès aux fichiers ssl et éventuellement proxy_pass directive si vous décidez d'en configurer une autre que 3000 Port. Wiki.js utilise le port 3000 par défaut.

Vérifiez la configuration NGINX :

sudo nginx -t

Enfin, pour que les modifications prennent effet, nous devons recharger NGINX :

sudo systemctl reload nginx.service

Étape 5 :Installer et configurer Wiki.js

Créez un répertoire racine de document dans lequel Wiki.js doit résider :

sudo mkdir -p /var/www/wiki.js

Accédez au répertoire racine du document :

cd /var/www/wiki.js

Créer un utilisateur pour wikijs

sudo useradd -d /var/www/wiki.js wikijs

Modifier le propriétaire du /var/www/wiki.js répertoire vers l'utilisateur wikijs :

sudo chown -R wikijs:wikijs /var/www/wiki.js

Depuis /var/www/wiki.js répertoire, exécutez la commande suivante pour récupérer et installer la dernière application Wiki.js :

cd /var/www/wiki.js
sudo su wikijs

curl -sSo- https://wiki.js.org/install.sh | bash

Une fois l'installation terminée, vous pouvez exécuter la commande suivante afin d'afficher la version actuellement installée de Wiki.js :

node wiki --version
# 1.0.117

Une fois l'installation terminée, vous serez invité à lancer l'assistant de configuration.

Alors, démarrez l'assistant de configuration en exécutant :

node wiki configure

À l'aide de votre navigateur Web, accédez à http://example.com et suivez les instructions à l'écran. Tous les paramètres saisis lors de l'assistant de configuration sont enregistrés dans le config.yml dossier. L'assistant de configuration démarrera automatiquement Wiki.js pour vous.

Tout d'abord, vous verrez un message de bienvenue. Cliquez sur "Démarrer bouton " :

La prochaine page "Vérification du système" apparaîtra. Si toutes les conditions sont remplies, cliquez sur "Continuer bouton ".

Entrez les informations générales sur votre wiki et cliquez sur "Continuer bouton " :

Lisez l'avis "Considération importante" et cliquez sur "Continuer " pour l'étape suivante :

Ensuite, connectez-vous à la base de données et continuez :

Vous devriez voir un message indiquant que Wiki.js a été connecté avec succès à la base de données. Cliquez sur "Continuer bouton " :

Définissez les chemins et continuez :

Configurez le référentiel Git distant si vous le souhaitez ou ignorez cette étape. Cette étape est facultative mais fortement recommandée :

Ensuite, cliquez sur le bouton "Continuer" :

Créez un compte administrateur et cliquez sur "Continuer bouton " :

Et enfin, démarrez le Wiki.js :

Attendez environ 30 secondes et vous devriez être redirigé vers la page d'accueil de Wiki.js :

L'installation est terminée. Vous devriez wiki page d'accueil :

Étape 6 - Configurer le gestionnaire de processus PM2

Par défaut, Wiki.js ne démarre pas automatiquement après un redémarrage du système. Pour le faire démarrer au démarrage, nous devons configurer le gestionnaire de processus PM2. PM2 est fourni avec Wiki.js en tant que module npm local, nous n'avons donc pas besoin d'installer PM2 globalement.

Dites à PM2 de se configurer en tant que service de démarrage en exécutant :

/var/www/wiki.js/node_modules/pm2/bin/pm2 startup

Enfin, enregistrez la configuration PM2 actuelle en exécutant la commande :

/var/www/wiki.js/node_modules/pm2/bin/pm2 save

Votre Wiki.js s'exécute maintenant en tant que processus d'arrière-plan, en utilisant PM2 comme gestionnaire de processus.

Liens

https://wiki.js.org/
https://github.com/Requarks/wiki-v1
https://github.com/Requarks/wiki