So installieren Sie Wiki.js auf Fedora 28

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

Wiki.js ist eine kostenlose und Open Source moderne Wiki-App, 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 Fedora 28 Vultr-Instanz mithilfe von 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
• Ein Webserver wie Nginx, Apache, IIS, Caddy oder H2O. In diesem Handbuch wird Nginx verwendet
• Git Version 2.7.4 oder höher
• Ein Git-kompatibles Repository (öffentlich oder privat) Dies ist optional
• Mindestens 768 MB RAM
• Domainname mit A/ AAAADatensätzen eingerichtet

Bevor Sie beginnen

Überprüfen Sie die Betriebssystemversion.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

Erstellen Sie ein neues Nicht-Root-Benutzerkonto mit Sudo-Zugriff und wechseln Sie zu diesem.

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

HINWEIS: Ersetzen Sie johndoedurch Ihren Benutzernamen.

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

sudo dnf check-upgrade || sudo dnf upgrade -y

Richten Sie die Zeitzone ein.

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

Installieren Sie die erforderlichen und nützlichen Pakete.

sudo dnf install -y wget vim unzip bash-completion git

Deaktivieren Sie der Einfachheit halber SELinux und Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

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.

sudo dnf install -y nodejs

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

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

Installieren Sie MongoDB

Wiki.js verwendet MongoDB als Datenbankmodul. Demnach müssen wir MongoDB auf unserem Server installieren.

Installieren Sie MongoDB.

sudo dnf install -y mongodb mongodb-server

Überprüfen Sie die MongoDB-Version.

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

Aktivieren und starten Sie MongoDB.

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

Installieren und konfigurieren Sie Nginx

Wiki.js kann ohne tatsächlichen Webserver (wie Nginx oder Apache) ausgeführt werden. Es wird jedoch dringend empfohlen, einen Standard-Webserver vor Wiki.js zu platzieren. Dies stellt sicher, dass Sie Funktionen wie SSL, mehrere Websites, Caching und andere verwenden können. Wir werden Nginx in diesem Tutorial verwenden, aber jeder andere Server wird es tun, Sie müssen es nur richtig konfigurieren.

Installieren Sie Nginx.

sudo dnf install -y nginx

Überprüfe die Version.

nginx -v
# nginx version: nginx/1.12.1

Aktivieren und starten Sie Nginx.

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

Konfigurieren Sie Nginx als HTTPoder HTTPS(wenn Sie SSL verwenden) Reverse-Proxy für die Wiki.js-Anwendung.

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 das 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 eine reine Unix-Shell-Software 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 your_email@example.com
cd ~

Überprüfen Sie die acme.shVersion.

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

Erhalten Sie RSA- und ECDSA-Zertifikate für wiki.example.com.

# 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 your_email@example.com --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 your_email@example.com --ocsp-must-staple --keylength ec-256 

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

• 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 durch Ausführen.

node wiki configure

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

Navigieren Sie mit Ihrem Webbrowser zu http://wiki.example.comden Anweisungen auf dem Bildschirm und befolgen Sie diese. Alle während des Konfigurationsassistenten eingegebenen Einstellungen werden 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. PM2 wird mit Wiki.js als lokales NPM-Modul geliefert, sodass wir PM2 nicht global installieren müssen.

Weisen Sie PM2 an, sich selbst als Startdienst zu konfigurieren, indem Sie Folgendes ausführen:

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

Speichern Sie abschließend die aktuelle PM2-Konfiguration, indem Sie den folgenden 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.