Sådan installeres Wiki.js på Fedora 28

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

Krav

Kravene for at køre Wiki.js er følgende:

• Node.js version 6.9.0 eller nyere
• MongoDB version 3.2 eller nyere
• En webserver såsom Nginx, Apache, IIS, Caddy eller H2O. Denne guide vil bruge Nginx
• Git version 2.7.4 eller nyere
• Et Git-kompatibelt lager (offentligt eller privat) Dette er valgfrit
• Minimum 768 MB RAM
• Domænenavn med A/ AAAArecords opsat

Før du begynder

Tjek OS-versionen.

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

Opret en ny ikke-root brugerkonto med sudo-adgang og skift til den.

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

BEMÆRK: Erstat johndoemed dit brugernavn.

Sørg for, at dit system er opdateret.

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

Indstil tidszonen.

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 nemheds skyld skal du deaktivere SELinux og Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Installer Node.js

Wiki.js kræver Node.js 6.9.0 eller nyere, så vi skal først installere Node.js.

Installer Node.js.

sudo dnf install -y nodejs

Tjek Node.js og npm versioner.

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

Installer MongoDB

Wiki.js bruger MongoDB som en databasemotor. Ifølge det skal vi installere MongoDB på vores server.

Installer MongoDB.

sudo dnf install -y mongodb mongodb-server

Tjek MongoDB-versionen.

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 køre uden nogen egentlig webserver (såsom Nginx eller Apache). Det anbefales dog stærkt at sætte en standard webserver foran Wiki.js. Dette sikrer, at du kan bruge funktioner som SSL, flere websteder, caching og andre. Vi vil bruge Nginx i denne tutorial, men enhver anden server vil gøre det, du skal bare konfigurere det korrekt.

Installer Nginx.

sudo dnf install -y nginx

Tjek versionen.

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

}

Det eneste, 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-klienten 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 opnå et SSL-certifikat fra Let's Encrypt vil vi bruge Acme.sh klient. 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.

Hent 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 acme.shversionen.

/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 

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

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

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

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

}

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 procesmanager. 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 ved at køre:

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

Gem endelig den aktuelle PM2-konfiguration ved at køre kommandoen: /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.