Hvordan installere Wiki.js på Fedora 28

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 Fedora 28 Vultr-instans ved å bruke Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.

Krav

Kravene for å kjøre Wiki.js er følgende:

• Node.js versjon 6.9.0 eller nyere
• MongoDB versjon 3.2 eller nyere
• En webserver som Nginx, Apache, IIS, Caddy eller H2O. Denne veiledningen vil bruke Nginx
• Git versjon 2.7.4 eller nyere
• Et Git-kompatibelt depot (offentlig eller privat) Dette er valgfritt
• Minst 768 MB RAM
• Domenenavn med A/ AAAAposter satt opp

Før du begynner

Sjekk OS-versjonen.

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

Opprett en ny ikke-rootbrukerkonto med sudo-tilgang og bytt til den.

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

MERK: Erstatt johndoemed brukernavnet ditt.

Sørg for at systemet ditt er oppdatert.

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

Sett opp tidssonen.

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

Installer nødvendige og nyttige pakker.

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

For enkelhets skyld, deaktiver SELinux og brannmur.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Installer Node.js

Wiki.js krever Node.js 6.9.0 eller nyere, så vi må først installere Node.js.

Installer Node.js.

sudo dnf install -y nodejs

Sjekk Node.js og npm versjoner.

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

Installer MongoDB

Wiki.js bruker MongoDB som en databasemotor. I følge det må vi installere MongoDB på serveren vår.

Installer MongoDB.

sudo dnf install -y mongodb mongodb-server

Sjekk MongoDB-versjonen.

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

Aktiver og start MongoDB.

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

Installer og konfigurer Nginx

Wiki.js kan kjøre uten noen faktisk webserver (som Nginx eller Apache). Det anbefales imidlertid sterkt å sette en standard webserver foran Wiki.js. Dette sikrer at du kan bruke funksjoner som SSL, flere nettsteder, caching og andre. Vi vil bruke Nginx i denne opplæringen, men enhver annen server vil gjøre det, du trenger bare å konfigurere den riktig.

Installer Nginx.

sudo dnf install -y nginx

Sjekk versjonen.

nginx -v
# nginx version: nginx/1.12.1

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-klienten og få 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 bruker vi 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 acme.shversjonen.

/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 

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

• For RSA: /etc/letsencrypt/wiki.example.com
• For ECC/ECDSA: /etc/letsencrypt/wiki.example.com_ecc

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

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/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.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-prosessbehandler. 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 ved å kjøre:

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

Til slutt lagrer du gjeldende PM2-konfigurasjon ved å kjøre kommandoen: /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.