Hvordan installere Wiki.js på Ubuntu 18.04

Wiki.js er en gratis og åpen kildekode, moderne wiki-app bygget på Node.js , Git og Markdown . Wiki.js kildekode er offentlig vert på Github . Denne guiden viser deg hvordan du installerer Wiki.js på en fersk Ubuntu 18.04 LTS Vultr-forekomst ved å bruke Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.

Krav

Kravene for å kjøre Wiki.js og fullføre denne veiledningen er som følger:

• Node.js versjon 6.9.0 eller nyere
• MongoDB versjon 3.2 eller nyere
• Nginx
• Git versjon 2.7.4 eller nyere
• Minimum 768 MB RAM
• Domenenavn med A/ AAAAposter satt opp

Sjekk Ubuntu-versjonen.

lsb_release -ds
# Ubuntu 18.04.4 LTS

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

Sørg for at systemet ditt er oppdatert.

sudo apt update && sudo apt upgrade -y

Installer nødvendige pakker.

sudo apt install -y build-essential apt-transport-https

Installer Git

Git 2.7.4 kommer forhåndsinstallert på Ubuntu server edition, så vi trenger ikke å installere den. Hvis du vil installere en nyere versjon, kan du bruke tredjeparts PPAer eller kompilere den siste utgivelsen av Git fra kilden.

Du kan bekrefte den installerte versjonen av Git ved å kjøre:

git --version
# git version 2.7.4

Hvis du vil installere en nyere versjon av Git-programvaren, kan du bruke følgende.

# Remove existing git package
sudo apt remove -y git
sudo apt-get install software-properties-common
sudo add-apt-repository -y ppa:git-core/ppa
sudo apt update && sudo apt upgrade -y
sudo apt install -y git

Bekreft Git-versjonen.

git --version
# git version 2.17.0

Installer Node.js

Installer Node.js ved å bruke NodeSource APT-depotet 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

Vi vil bruke de offisielle MongoDB-repositoriene , som holdes oppdatert med de siste store og mindre MongoDB-utgivelsene.

Installer MongoDB Community Edition.

sudo apt install -y mongodb

Sjekk versjonen.

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

Installer og konfigurer Nginx

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/ubuntu/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/ubuntu/ $(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 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 i tillegg 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-klienten og få et Let's Encrypt-sertifikat (valgfritt)

Å sikre wikien din med HTTPSer ikke nødvendig, men det vil sikre nettstedets trafikk. Acme.sh er en ren unix-skallprogramvare for å få SSL-sertifikater fra Let's Encrypt med null avhengigheter.

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

Skaff RSA- og ECDSA-sertifikater for wiki.example.comdomene/vertsnavn.

# 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 

Etter å ha kjørt kommandoene ovenfor, vil sertifikatene og nøklene dine være i:

• For RSA: /etc/letsencrypt/wiki.example.comkatalogen.
• For ECC/ECDSA: /etc/letsencrypt/wiki.example.com_ecckatalogen.

Etter å ha fått sertifikater fra Let's Encrypt, må vi konfigurere Nginx til å bruke 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/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;
    }

}

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.commappen til brukeren 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

For å se den installerte versjonen av Wiki.js, kan du kjøre følgende kommando.

node wiki --version
# 1.0.78

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

Start konfigurasjonsveiviseren.

node wiki configure

Dette vil varsle deg om å bla til for http://localhost:3000å konfigurere Wiki.js. Hvis du har Nginx foran Wiki.js, kan du å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 innstillinger som ble angitt under konfigurasjonsveiviseren, lagres i config.ymlfilen. Konfigurasjonsveiviseren vil automatisk starte Wiki.js for deg.

Installer 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. 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 kjører som en bakgrunnsprosess, og bruker PM2 som prosessbehandler.