Comment installer Wiki.js sur CentOS 7

• Exigences
• Installer Git
• Installez Node.js
• Installer MongoDB
• Installer et configurer Nginx
• Installez le client Acme.sh et obtenez un certificat Let's Encrypt (facultatif)
• Installez Wiki.js
• Configuration PM2

Wiki.js est une application wiki moderne gratuite et open source basée sur Node.js, MongoDB, Git et Markdown. Le code source de Wiki.js est publiquement hébergé sur Github . Ce guide vous montrera comment installer Wiki.js sur une nouvelle instance CentOS 7 Vultr en utilisant Node.js, MongoDB, PM2, Nginx, Git et Acme.sh.

Exigences

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

• Node.js version 6.9.0 ou ultérieure
• MongoDB version 3.2 ou ultérieure
• Nginx
• Git version 2.7.4 ou ultérieure
• Un référentiel compatible Git (public ou privé) ( facultatif )
• 768 Mo de RAM minimum
• Nom de domaine avec A/ AAAAenregistrements configurés

Vérifiez la version CentOS.

cat /etc/centos-release
# CentOS Linux release 7.5.1804 (Core)

Créez un nouveau non-rootcompte utilisateur avec sudoaccès et passez-y.

useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe

REMARQUE : remplacez johndoepar votre nom d'utilisateur .

Configurez le fuseau horaire.

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

Assurez-vous que votre système est à jour.

sudo yum update -y

Installez les packages nécessaires pour terminer ce didacticiel.

sudo yum install -y wget curl vim zip unzip bash-completion

Désactivez SELinux et le pare-feu.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Activez le référentiel EPEL.

sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

Installer Git

Les référentiels CentOS fournissent une version très obsolète de Git, nous devrons donc construire Git à partir des sources.

Installez Git en le construisant à partir du code source.

# Remove existing git package if installed: 
sudo yum remove -y git
sudo yum groupinstall -y "Development Tools"
sudo yum install -y gettext-devel openssl-devel perl-CPAN perl-devel zlib-devel curl-devel
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.17.1.tar.gz && tar zxvf git-2.17.1.tar.gz
rm git-2.17.1.tar.gz
cd git-2.17.1
make configure
./configure
make prefix=/usr/local all
sudo make prefix=/usr/local install
cd ~

# Confirm this command returns /usr/local/bin/git:
which git

Vérifiez la version.

git --version
# git version 2.17.1

Installez Node.js

Wiki.js nécessite Node.js 6.9.0 ou version ultérieure, nous devons donc d'abord installer Node.js.

Installez Node.js en utilisant le référentiel NodeSource YUM pour Node.js.

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
sudo yum install -y nodejs

Vérifiez les versions Node.js et NPM.

node -v && npm -v
# v8.11.2
# 5.6.0

Installer MongoDB

Wiki.js utilise MongoDB comme moteur de base de données. Nous utiliserons les dépôts officiels MongoDB , qui contiennent les versions MongoDB majeures et mineures les plus récentes.

Installez MongoDB Community Edition.

sudo vim /etc/yum.repos.d/mongodb-org-3.6.repo

# Copy/paste this
[mongodb-org-3.6]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.6/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.6.asc

sudo yum install -y mongodb-org

Vérifiez la version.

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

Activez et démarrez MongoDB.

sudo systemctl enable mongod.service
sudo systemctl start mongod.service

Installer et configurer Nginx

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 et plus encore.

Installez Nginx.

sudo vim /etc/yum.repos.d/nginx_mainline.repo

# Copy/paste this
[nginx]
name=nginx repo
baseurl=https://nginx.org/packages/mainline/centos/7/$basearch/
gpgcheck=1
enabled=1

wget https://nginx.org/keys/nginx_signing.key
sudo rpm --import nginx_signing.key
rm nginx_signing.key

sudo yum install -y nginx

Vérifiez la version.

nginx -v
# nginx version: nginx/1.15.0

Activez et démarrez Nginx.

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

Configurer Nginx en tant que proxy inverse HTTPou HTTPSinversé pour Wiki.js.

Exécutez-le sudo vim /etc/nginx/conf.d/wiki.js.confet remplissez-le avec la configuration de base du proxy inverse ci-dessous.

server {

    listen [::]:80;
    listen 80;

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

    location /.well-known/acme-challenge/ {
        allow all;
    }

    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 changer dans la configuration ci-dessus est server_namedirective, et potentiellement proxy_passdirective si vous décidez de configurer un autre port que 3000. Wiki.js utilise le port 3000par défaut.

Vérifiez la configuration.

sudo nginx -t

Recharger Nginx.

sudo systemctl reload nginx.service

Installez le client Acme.sh et obtenez un certificat Let's Encrypt (facultatif)

Sécuriser votre wiki avec HTTPSn'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 le client Acme.sh. Acme.sh est un script shell UNIX pur pour obtenir des certificats SSL à partir de Let's Encrypt sans aucune dépendance. Cela le rend très léger par rapport à certains autres clients du protocole Acme qui nécessitent beaucoup de dépendances pour fonctionner correctement.

Téléchargez et installez Acme.sh .

sudo mkdir /etc/letsencrypt
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]
cd ~

Vérifiez la version.

/etc/letsencrypt/acme.sh --version
# v2.7.9

Obtenez des certificats RSA et ECDSA pour votre domaine / nom d'hôte.

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail [email protected] --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail [email protected] --ocsp-must-staple --keylength ec-256 

Après avoir exécuté les commandes ci-dessus, vos certificats et clés seront dans les répertoires suivants:

• Pour RSA: /etc/letsencrypt/wiki.example.com
• Pour ECC / ECDSA: /etc/letsencrypt/wiki.example.com_ecc

REMARQUE : n'oubliez pas de remplacer wiki.example.compar votre nom de domaine.

Après avoir obtenu les certificats de Let's Encrypt, nous devons configurer Nginx pour en tirer parti.

Réexécutez sudo vim /etc/nginx/conf.d/wiki.js.confet configurez Nginx en tant que HTTPSproxy inverse.

server {

    listen [::]:443 ssl http2;
    listen 443 ssl http2;
    listen [::]:80;
    listen 80;

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

    location /.well-known/acme-challenge/ {
        allow all;
    }

    # RSA
    ssl_certificate /etc/letsencrypt/wiki.example.com/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com/wiki.example.com.key;
    # ECDSA
    ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/wiki.example.com.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;
    }

}

Vérifiez la configuration.

sudo nginx -t

Recharger Nginx.

sudo systemctl reload nginx.service

Installez Wiki.js

Créez un dossier racine de document vide dans lequel Wiki.js doit être installé.

sudo mkdir -p /var/www/wiki.example.com

Accédez au dossier racine du document.

cd /var/www/wiki.example.com

Changez la propriété du /var/www/wiki.example.comdossier en utilisateur johndoe.

sudo chown -R johndoe:johndoe /var/www/wiki.example.com

À partir du /var/www/wiki.example.comdossier, exécutez la commande suivante pour télécharger et installer Wiki.js.

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

Vous pouvez exécuter la commande suivante afin d'afficher la version actuellement installée de Wiki.js.

node wiki --version
# 1.0.78

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

Démarrez l'assistant de configuration.

node wiki configure

Cela vous avertira de naviguer http://localhost:3000pour configurer Wiki.js. Si vous avez Nginx devant Wiki.js, vous pouvez ouvrir votre nom de domaine (par exemple http://wiki.example.com) au lieu d'y aller localhost.

À l'aide de votre navigateur Web, accédez aux http://wiki.example.cominstructions à l'écran et suivez-les. Tous les paramètres entrés lors de l'assistant de configuration ont été enregistrés dans le config.ymlfichier. L'assistant de configuration démarrera automatiquement Wiki.js pour vous.

Configuration PM2

Par défaut, Wiki.js ne démarre pas automatiquement après un redémarrage du système. Afin de le faire démarrer au démarrage, nous devons configurer le gestionnaire de processus PM2.

Dites à PM2 de se configurer en tant que service de démarrage.

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup

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

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

Votre instance Wiki.js s'exécute en tant que processus d'arrière-plan, en utilisant PM2 comme gestionnaire de processus. Vous pouvez redémarrer votre système d'exploitation avec sudo rebootet vous assurer que Wiki.js démarre après un redémarrage.