So installieren Sie Wiki.js unter CentOS 7

• Bedarf
• Installieren Sie Git
• Installieren Sie Node.js.
• Installieren Sie MongoDB
• Installieren und konfigurieren Sie Nginx
• Installieren Sie den Acme.sh-Client und erhalten Sie ein Let's Encrypt-Zertifikat (optional).
• Installieren Sie Wiki.js
• Richten Sie PM2 ein

Wiki.js ist eine kostenlose und Open Source moderne Wiki-Anwendung, die auf Node.js, MongoDB, Git und Markdown basiert. Der Quellcode von Wiki.j wird öffentlich auf Github gehostet . Diese Anleitung zeigt Ihnen, wie Sie Wiki.js auf einer neuen CentOS 7 Vultr-Instanz mit Node.js, MongoDB, PM2, Nginx, Git und Acme.sh installieren.

Bedarf

Folgende Voraussetzungen sind erforderlich, um Wiki.js auszuführen:

• Node.js Version 6.9.0 oder höher
• MongoDB Version 3.2 oder höher
• Nginx
• Git Version 2.7.4 oder höher
• Ein Git-kompatibles Repository (öffentlich oder privat) ( optional )
• Mindestens 768 MB RAM
• Domainname mit A/ AAAADatensätzen eingerichtet

Überprüfen Sie die CentOS-Version.

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

Erstellen Sie ein neues non-rootBenutzerkonto mit sudoZugriff und wechseln Sie zu diesem.

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

HINWEIS : Ersetzen Sie johndoedurch Ihren Benutzernamen .

Richten Sie die Zeitzone ein.

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

Stellen Sie sicher, dass Ihr System auf dem neuesten Stand ist.

sudo yum update -y

Installieren Sie die erforderlichen Pakete, um dieses Lernprogramm abzuschließen.

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

Deaktivieren Sie SELinux und Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Aktivieren Sie das EPEL-Repository.

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

Installieren Sie Git

CentOS-Repositorys bieten eine sehr veraltete Version von Git, daher müssen wir Git aus dem Quellcode erstellen.

Installieren Sie Git, indem Sie es aus dem Quellcode erstellen.

# 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

Überprüfen Sie die Version.

git --version
# git version 2.17.1

Installieren Sie Node.js.

Wiki.js erfordert Node.js 6.9.0 oder höher, daher müssen wir zuerst Node.js installieren.

Installieren Sie Node.js mithilfe des NodeSource YUM-Repositorys für Node.js.

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

Überprüfen Sie die Versionen Node.js und NPM.

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

Installieren Sie MongoDB

Wiki.js verwendet MongoDB als Datenbankmodul. Wir werden die offiziellen MongoDB-Repositories verwenden , die die neuesten Haupt- und Nebenversionen von MongoDB enthalten.

Installieren Sie 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

Überprüfe die Version.

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

Aktivieren und starten Sie MongoDB.

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

Installieren und konfigurieren Sie Nginx

Es wird dringend empfohlen, einen Standard-Webserver vor Wiki.js zu platzieren. Dies stellt sicher, dass Sie Funktionen wie SSL, mehrere Websites, Caching und mehr verwenden können.

Installieren Sie 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

Überprüfe die Version.

nginx -v
# nginx version: nginx/1.15.0

Aktivieren und starten Sie Nginx.

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

Konfigurieren Sie Nginx als HTTPoder HTTPSReverse-Proxy für Wiki.js.

Führen Sie es aus sudo vim /etc/nginx/conf.d/wiki.js.confund füllen Sie es mit der folgenden grundlegenden Reverse-Proxy-Konfiguration.

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;
    }

}

Das einzige, was Sie in der obigen Konfiguration ändern müssen, ist die server_nameDirektive und möglicherweise die proxy_passDirektive, wenn Sie sich entscheiden, einen anderen Port als zu konfigurieren 3000. Wiki.js verwendet 3000standardmäßig den Port .

Überprüfen Sie die Konfiguration.

sudo nginx -t

Laden Sie Nginx neu.

sudo systemctl reload nginx.service

Installieren Sie den Acme.sh-Client und erhalten Sie ein Let's Encrypt-Zertifikat (optional).

Das Sichern Ihres Wikis mit HTTPSist nicht erforderlich, es wird jedoch empfohlen, den Datenverkehr auf Ihrer Website zu sichern. Um ein SSL-Zertifikat von Let's Encrypt zu erhalten, verwenden wir den Acme.sh-Client. Acme.sh ist ein reines UNIX-Shell-Skript zum Abrufen von SSL-Zertifikaten von Let's Encrypt ohne Abhängigkeiten. Dies macht es im Vergleich zu einigen anderen Acme-Protokoll-Clients, die viele Abhängigkeiten erfordern, um erfolgreich ausgeführt zu werden, sehr leicht.

Laden Sie Acme.sh herunter und installieren Sie es .

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 ~

Überprüfe die Version.

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

Beziehen Sie RSA- und ECDSA-Zertifikate für Ihre Domain / Ihren Hostnamen.

# 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 

Nachdem Sie die obigen Befehle ausgeführt haben, befinden sich Ihre Zertifikate und Schlüssel in den folgenden Verzeichnissen:

• Für RSA: /etc/letsencrypt/wiki.example.com
• Für ECC / ECDSA: /etc/letsencrypt/wiki.example.com_ecc

HINWEIS : Vergessen Sie nicht, durch wiki.example.comIhren Domainnamen zu ersetzen .

Nachdem wir Zertifikate von Let's Encrypt erhalten haben, müssen wir Nginx konfigurieren, um sie nutzen zu können.

Führen Sie es sudo vim /etc/nginx/conf.d/wiki.js.conferneut aus und konfigurieren Sie Nginx als HTTPSReverse-Proxy.

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;
    }

}

Überprüfen Sie die Konfiguration.

sudo nginx -t

Laden Sie Nginx neu.

sudo systemctl reload nginx.service

Installieren Sie Wiki.js

Erstellen Sie einen leeren Dokumentstammordner, in dem Wiki.js installiert werden soll.

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

Navigieren Sie zum Dokumentstammordner.

cd /var/www/wiki.example.com

Ändern Sie den Besitz des /var/www/wiki.example.comOrdners in Benutzer johndoe.

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

/var/www/wiki.example.comFühren Sie im Ordner den folgenden Befehl aus, um Wiki.js herunterzuladen und zu installieren.

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

Sie können den folgenden Befehl ausführen, um die aktuell installierte Version von Wiki.js anzuzeigen.

node wiki --version
# 1.0.78

Nach Abschluss der Installation werden Sie aufgefordert, den Konfigurationsassistenten auszuführen.

Starten Sie den Konfigurationsassistenten.

node wiki configure

Dadurch werden Sie benachrichtigt, zu navigieren, http://localhost:3000um Wiki.js zu konfigurieren. Wenn Sie Nginx vor Wiki.js haben, können Sie Ihren Domain-Namen (z. B. http://wiki.example.com) öffnen, anstatt zu gehen localhost.

Navigieren Sie mit Ihrem Webbrowser zu http://wiki.example.comden Anweisungen auf dem Bildschirm und befolgen Sie diese. Alle Einstellungen, die während des Konfigurationsassistenten eingegeben wurden, wurden in der config.ymlDatei gespeichert. Der Konfigurationsassistent startet automatisch Wiki.js für Sie.

Richten Sie PM2 ein

Standardmäßig wird Wiki.js nach einem Systemneustart nicht automatisch gestartet. Damit es beim Booten gestartet werden kann, müssen wir den PM2-Prozessmanager einrichten.

Weisen Sie PM2 an, sich selbst als Startdienst zu konfigurieren.

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

Speichern Sie abschließend die aktuelle PM2-Konfiguration, indem Sie den Befehl ausführen.

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

Ihre Wiki.js-Instanz wird als Hintergrundprozess ausgeführt und verwendet PM2 als Prozessmanager. Sie können Ihr Betriebssystem mit sudo rebootneu starten und sicherstellen, dass Wiki.js nach einem Neustart gestartet wird.