Hvordan installere Wiki.js på Debian 9

Wiki.js er en gratis og åpen kildekode, moderne wiki-app bygget på Node.js, MongoDB, Git og Markdown. Wiki.js kildekode er offentlig vert på GitHub . Denne guiden viser deg hvordan du installerer Wiki.js på en fersk Debian 9 Vultr-instans ved å bruke 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 depot (offentlig eller privat) ( valgfritt )
• Minimum på 768MB RAM
• Domenenavn med A/ AAAAposter satt opp

Sjekk Debian-versjonen.

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

Sørg for at systemet ditt er oppdatert.

apt update && apt upgrade -y

Installer nødvendige pakker.

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

Opprett en ny non-rootbrukerkonto med sudotilgang og bytt til den.

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

MERK : Erstatt johndoemed brukernavnet ditt.

Sett opp tidssonen.

sudo dpkg-reconfigure tzdata

Installer Git

Installer Git på Debian.

sudo apt install -y git

Bekreft Git-versjonen.

git --version
# git version 2.11.0

Installer Node.js

Installer Node.js ved å bruke NodeSource APT-depot for Node.js.

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

Sjekk Node.js- og npm-versjonene.

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

Installer MongoDB

Wiki.js bruker MongoDB som en databasemotor. I følge det må vi installere MongoDB på serveren vår. Vi vil bruke de offisielle MongoDB-depotene for installasjon.

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

Sjekk versjonen.

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 sterkt å sette en standard webserver foran Wiki.js. Dette sikrer at du kan bruke funksjoner som SSL, flere nettsteder, caching og mer. Vi vil bruke Nginx i denne opplæringen, men enhver annen server vil gjøre det, du trenger bare å konfigurere den riktig.

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

Sjekk versjonen.

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 bruker SSL) omvendt proxy for Wiki.js-applikasjonen.

Kjør sudo vim /etc/nginx/conf.d/wiki.js.confog fyll den med den grunnleggende omvendte proxy-konfigurasjonen 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;
    }

}

Det eneste du trenger å endre i konfigurasjonen ovenfor er server_namedirektivet, og potensielt proxy_passdirektivet hvis du bestemmer deg for å konfigurere en annen port enn 3000. Wiki.js bruker port 3000som standard.

Sjekk konfigurasjonen.

sudo nginx -t

Last inn Nginx på nytt.

sudo systemctl reload nginx.service

Installer Acme.sh og få et Let's Encrypt-sertifikat (valgfritt)

Det HTTPSer ikke nødvendig å sikre wikien din med , men det er en god praksis å sikre trafikken til nettstedet ditt. For å få et SSL-sertifikat fra Let's Encrypt vil vi bruke Acme.sh-klienten. Acme.sh er en ren unix-skallprogramvare for å få SSL-sertifikater fra Let's Encrypt med null avhengigheter. Det gjør den veldig lett sammenlignet med noen andre ACME-protokollklienter som krever mange avhengigheter for å kjøre vellykket.

Last ned 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 ~

Sjekk versjonen.

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

Skaff RSA- og ECDSA-sertifikater 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 

MERK : Ikke glem å erstatte wiki.example.commed ditt domenenavn.

Etter å ha kjørt kommandoene ovenfor, vil sertifikatene og nøklene dine være i følgende kataloger.

• For RSA: /etc/letsencrypt/wiki.example.comkatalog.
• For ECC/ECDSA: /etc/letsencrypt/wiki.example.com_ecckatalog.

Etter å ha fått sertifikater fra Let's Encrypt, må vi konfigurere Nginx for å dra nytte av dem.

Kjør sudo vim /etc/nginx/conf.d/wiki.js.configjen 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;
    }

}

Sjekk konfigurasjonen.

sudo nginx -t

Last inn Nginx på nytt.

sudo systemctl reload nginx.service

Installer Wiki.js

Opprett en tom dokumentrotmappe der Wiki.js skal installeres.

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

Naviger til dokumentrotmappen.

cd /var/www/wiki.example.com

Endre eierskap av /var/www/wiki.example.commappe til bruker johndoe.

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

Fra /var/www/wiki.example.commappen, kjør følgende kommando for å laste ned og installere Wiki.js.

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

Du kan kjøre følgende kommando for å se den installerte versjonen av Wiki.js.

node wiki --version
# 1.0.78

Når installasjonen er fullført, vil du bli bedt om å kjøre konfigurasjonsveiviseren.

Start konfigurasjonsveiviseren ved å kjøre.

node wiki configure

Dette vil varsle deg om å navigere til for http://localhost:3000å konfigurere Wiki.js. Hvis du har Nginx foran Wiki.js, betyr det at du kan åpne domenenavnet ditt (f.eks. http://wiki.example.com) i stedet for å gå til localhost.

Bruk nettleseren din, naviger til http://wiki.example.comog følg instruksjonene på skjermen. Alle innstillingene som ble angitt under konfigurasjonsveiviseren, lagres i config.ymlfilen. Konfigurasjonsveiviseren vil automatisk starte Wiki.js for deg.

Sett opp PM2

Som standard vil ikke Wiki.js starte automatisk etter en omstart av systemet. For å få det til å starte ved oppstart, må vi sette opp PM2-prosessbehandleren. PM2 kommer sammen med Wiki.js som en lokal NPM-modul, så vi trenger ikke å installere PM2 globalt.

Be PM2 om å konfigurere seg selv som en oppstartstjeneste.

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

Til slutt lagrer du gjeldende PM2-konfigurasjon.

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

Wiki.js-forekomsten din kjører som en bakgrunnsprosess, og bruker PM2 som prosessbehandler. Du kan starte operativsystemet på nytt med sudo rebootog sjekke om Wiki.js starter etter en omstart.