So installieren Sie Wiki.js unter FreeBSD 11

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

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 FreeBSD 11 Vultr-Instanz mithilfe von Node.js, MongoDB, PM2, Nginx, Git und Acme.sh installieren.

Bedarf

Die Anforderungen zum Ausführen von Wiki.js lauten wie folgt:

• Node.js Version 6.11.1 oder höher
• MongoDB Version 3.2 oder höher
• Git Version 2.7.4 oder höher
• Ein Webserver wie Nginx, Apache, IIS, Caddy oder H2O. In diesem Handbuch wird Nginx verwendet.
• Ein Git-kompatibles Repository (öffentlich oder privat) Dies ist optional
• Mindestens 512 MB RAM. Es wird dringend empfohlen, einen Computer mit mindestens 1 GB RAM zu verwenden.
• Domainname mit A/ AAAADatensätzen eingerichtet. In diesem Handbuch werden wir wiki.example.comals Beispieldomäne verwenden.

Bevor Sie beginnen

Überprüfen Sie die FreeBSD-Version.

uname -ro
# FreeBSD 11.2-RELEASE

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

freebsd-update fetch install
pkg update && pkg upgrade -y

Installieren Sie sudo, vim, unzip, wget, git, bashund socatPakete , wenn sie nicht auf Ihrem System vorhanden sind.

pkg install -y sudo vim unzip wget git bash socat

Erstellen Sie ein neues Benutzerkonto mit Ihrem bevorzugten Benutzernamen (wir werden verwenden johndoe).

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

Führen Sie den visudoBefehl aus und kommentieren Sie die %wheel ALL=(ALL) ALLZeile aus, damit Mitglieder der wheelGruppe einen beliebigen Befehl ausführen können.

# Uncomment by removing the hash (#) sign
%wheel ALL=(ALL) ALL

Wechseln Sie nun zu Ihrem neu erstellten Benutzer.

su - johndoe

HINWEIS: Ersetzen Sie johndoedurch Ihren Benutzernamen.

Richten Sie die Zeitzone ein.

sudo tzsetup

Installieren Sie Node.js.

Für Wiki.js ist Node.js 6.11.1 oder höher erforderlich, daher müssen wir zuerst die entsprechende Version von Node.js installieren.

Installieren Sie Node.js und NPM.

sudo pkg install -y node8 npm-node8

Überprüfen Sie die Versionen.

node -v && npm -v
# v8.12.0
# 6.4.1

Installieren Sie MongoDB

Wiki.js verwendet MongoDB als Datenbankmodul.

Installieren Sie MongoDB.

sudo pkg install -y mongodb36

Überprüfe die Version.

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

Aktivieren und starten Sie MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

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

Das Sichern Ihres Wikis mit HTTPS ist nicht erforderlich, es wird jedoch empfohlen, den Site-Verkehr 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.8.0

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

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --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:

• RSA: /etc/letsencrypt/wiki.example.com
• 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.

Installieren und konfigurieren Sie Nginx

Wiki.js kann ohne tatsächlichen Webserver ausgeführt werden. Es wird jedoch dringend empfohlen, einen Standard-Webserver davor zu stellen. 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 pkg install -y nginx

Überprüfe die Version.

nginx -v
# nginx version: nginx/1.14.0

Aktivieren und starten Sie Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

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

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

server {

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

  server_name wiki.example.com;

  charset utf-8;
  client_max_body_size 50M;

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

}

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 . Speichern Sie die Datei und beenden Sie sie mit :+ W+Q

Jetzt müssen wir die wiki.js.confDatei in die Hauptdatei aufnehmen nginx.conf.

Führen sudo vim /usr/local/etc/nginx/nginx.confSie die folgende Zeile aus und fügen Sie sie dem http {}Block hinzu.

include wiki.js.conf;

Überprüfen Sie die Konfiguration.

sudo nginx -t

Laden Sie Nginx neu.

sudo service nginx reload

Installieren Sie Wiki.js

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

sudo mkdir -p /usr/local/www/wiki.example.com

Navigieren Sie zum Dokumentstammordner.

cd /usr/local/www/wiki.example.com

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

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

/usr/local/www/wiki.example.comFühren Sie im Ordner die folgenden Befehle aus, um Wiki.js herunterzuladen und zu installieren.

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

VERSION=$(curl -L -s -S https://beta.requarks.io/api/version/stable)
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/wiki-js.tar.gz | tar -f - -xz -C .
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/node_modules.tar.gz | tar -f - -xz -C .
cp -n config.sample.yml config.yml

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

node wiki --version
# 1.0.102

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 localhost zu gehen.

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.

Installieren und einrichten Sie den PM2-Prozessmanager

Standardmäßig wird Wiki.js nach einem Systemneustart nicht automatisch gestartet. Damit es beim Booten gestartet werden kann, müssen wir PM2 Process Manager installieren und einrichten.

Installieren Sie PM2 global über npm.

sudo npm install -g pm2

Überprüfe die Version.

pm2 -v
# 3.2.2

Navigieren Sie zu Ihrem Dokumentstammordner, falls Sie noch nicht dort sind, und beenden Sie Wiki.js.

cd /usr/local/www/wiki.example.com
node wiki stop

Starten Sie Wiki.js über PM2.

pm2 start server/index.js --name "Wiki.js"

Listenprozess von PM2 verwaltet.

pm2 list

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

pm2 startup

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

pm2 save

Ihre Wiki.js-Instanz wird jetzt als Hintergrundprozess ausgeführt und verwendet PM2 als Prozessmanager.