Sådan installeres Wiki.js på Debian 9

Wiki.js er en gratis og open source, moderne wiki-app bygget på Node.js, MongoDB, Git og Markdown. Wiki.js kildekode er offentligt hostet på GitHub . Denne guide viser dig, hvordan du installerer Wiki.js på en ny Debian 9 Vultr-instans ved at bruge Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.

Krav

• Node.js 6.9.0 eller nyere
• MongoDB 3.2 eller nyere
• Nginx
• Git 2.7.4 eller nyere
• Et Git-kompatibelt lager (offentligt eller privat) ( valgfrit )
• Minimum af 768MB RAM
• Domænenavn med A/ AAAArecords opsat

Tjek Debian-versionen.

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

Sørg for, at dit system er opdateret.

apt update && apt upgrade -y

Installer nødvendige pakker.

apt install -y build-essential apt-transport-https sudo curl wget dirmngr sudo

Opret en ny non-rootbrugerkonto med sudoadgang og skift til den.

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

BEMÆRK : Erstat johndoemed dit brugernavn.

Indstil tidszonen.

sudo dpkg-reconfigure tzdata

Installer Git

Installer Git på Debian.

sudo apt install -y git

Bekræft Git-versionen.

git --version
# git version 2.11.0

Installer Node.js

Installer Node.js ved at bruge NodeSource APT-lager til Node.js.

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

Tjek Node.js- og npm-versionerne.

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

Installer MongoDB

Wiki.js bruger MongoDB som en databasemotor. Ifølge det skal vi installere MongoDB på vores server. Vi vil bruge de officielle MongoDB-depoter til installation.

Installer MongoDB Community Edition.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/3.6 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
sudo apt update
sudo apt install -y mongodb-org

Tjek versionen.

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

Aktiver og start MongoDB.

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

Installer og konfigurer Nginx

Det anbefales stærkt at sætte en standard webserver foran Wiki.js. Dette sikrer, at du kan bruge funktioner som SSL, flere websteder, caching og mere. Vi vil bruge Nginx i denne tutorial, men enhver anden server vil gøre det, du skal bare konfigurere det korrekt.

Installer Nginx.

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/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx

Tjek versionen.

sudo nginx -v
# nginx version: nginx/1.15.0

Aktiver og start Nginx.

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

Konfigurer Nginx som en HTTPeller HTTPS(hvis du bruger SSL) omvendt proxy for Wiki.js-applikationen.

Kør sudo vim /etc/nginx/conf.d/wiki.js.confog udfyld den med den grundlæggende reverse proxy-konfiguration nedenfor.

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

}

De eneste ting, du skal ændre i ovenstående konfiguration, er server_namedirektivet og potentielt proxy_passdirektivet, hvis du beslutter dig for at konfigurere en anden port end 3000. Wiki.js bruger port 3000som standard.

Tjek konfigurationen.

sudo nginx -t

Genindlæs Nginx.

sudo systemctl reload nginx.service

Installer Acme.sh og få et Let's Encrypt-certifikat (valgfrit)

Det HTTPSer ikke nødvendigt at sikre din wiki , men det er en god praksis at sikre trafikken på dit websted. For at få et SSL-certifikat fra Let's Encrypt bruger vi Acme.sh-klienten. Acme.sh er en ren unix shell-software til at opnå SSL-certifikater fra Let's Encrypt med nul afhængigheder. Det gør det meget let i forhold til nogle andre ACME-protokolklienter, der kræver en masse afhængigheder for at køre med succes.

Download og installer 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 ~

Tjek versionen.

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

Få RSA- og ECDSA-certifikater for 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 [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 

BEMÆRK : Glem ikke at erstatte wiki.example.commed dit domænenavn.

Efter at have kørt ovenstående kommandoer, vil dine certifikater og nøgler være i følgende mapper.

• For RSA: /etc/letsencrypt/wiki.example.combibliotek.
• For ECC/ECDSA: /etc/letsencrypt/wiki.example.com_eccbibliotek.

Efter at have fået certifikater fra Let's Encrypt, skal vi konfigurere Nginx til at drage fordel af dem.

Kør sudo vim /etc/nginx/conf.d/wiki.js.configen og konfigurer Nginx som en HTTPSomvendt 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/example.com.key;
    # ECDSA
    ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/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;
    }

}

Tjek konfigurationen.

sudo nginx -t

Genindlæs Nginx.

sudo systemctl reload nginx.service

Installer Wiki.js

Opret en tom dokumentrodmappe, hvor Wiki.js skal installeres.

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

Naviger til dokumentets rodmapp.

cd /var/www/wiki.example.com

Skift ejerskab af /var/www/wiki.example.commappe til bruger johndoe.

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

/var/www/wiki.example.comKør følgende kommando fra mappen for at downloade og installere Wiki.js.

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

Du kan køre følgende kommando for at se den aktuelt installerede version af Wiki.js.

node wiki --version
# 1.0.78

Når installationen er fuldført, bliver du bedt om at køre konfigurationsguiden.

Start konfigurationsguiden ved at køre.

node wiki configure

Dette vil give dig besked om at navigere til for http://localhost:3000at konfigurere Wiki.js. Hvis du har Nginx foran Wiki.js, betyder det, at du kan åbne dit domænenavn (f.eks. http://wiki.example.com) i stedet for at gå til localhost.

Brug din webbrowser til at navigere til http://wiki.example.comog følge instruktionerne på skærmen. Alle de indstillinger, der blev indtastet under konfigurationsguiden, gemmes i config.ymlfilen. Konfigurationsguiden starter automatisk Wiki.js for dig.

Opsætning af PM2

Som standard starter Wiki.js ikke automatisk efter en systemgenstart. For at få det til at starte ved opstart, skal vi konfigurere PM2-procesmanageren. PM2 leveres sammen med Wiki.js som et lokalt NPM-modul, så vi behøver ikke at installere PM2 globalt.

Bed PM2 om at konfigurere sig selv som en opstartstjeneste.

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

Gem endelig den aktuelle PM2-konfiguration.

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

Din Wiki.js-instans kører som en baggrundsproces ved at bruge PM2 som sin procesmanager. Du kan genstarte dit OS med sudo rebootog kontrollere, om Wiki.js starter efter en genstart.