Hur man installerar Wiki.js på Fedora 28

Krav

Innan du börjar

Installera Node.js

Installera MongoDB

Installera och konfigurera Nginx

Installera Acme.sh-klienten och skaffa Let's Encrypt-certifikat (valfritt)

Installera Wiki.js

Ställ in PM2

Wiki.js är en gratis och öppen källkod, modern wiki-app byggd på Node.js, MongoDB, Git och Markdown. Wiki.js källkod är offentligt värd på Github . Den här guiden visar dig hur du installerar Wiki.js på en ny Fedora 28 Vultr-instans genom att använda Node.js, MongoDB, PM2, Nginx, Git och Acme.sh.

Krav

Krav för att köra Wiki.js är följande:

• Node.js version 6.9.0 eller senare
• MongoDB version 3.2 eller senare
• En webbserver som Nginx, Apache, IIS, Caddy eller H2O. Den här guiden kommer att använda Nginx
• Git version 2.7.4 eller senare
• Ett Git-kompatibelt arkiv (offentligt eller privat) Detta är valfritt
• Minst 768 MB RAM
• Domännamn med A/ AAAAposter inställda

Innan du börjar

Kontrollera OS-versionen.

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

Skapa ett nytt icke-rootanvändarkonto med sudo-åtkomst och byt till det.

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

OBS: Ersätt johndoemed ditt användarnamn.

Se till att ditt system är uppdaterat.

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

Ställ in tidszonen.

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

Installera nödvändiga och användbara paket.

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

För enkelhets skull, inaktivera SELinux och brandvägg.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Installera Node.js

Wiki.js kräver Node.js 6.9.0 eller senare, så vi måste först installera Node.js.

Installera Node.js.

sudo dnf install -y nodejs

Kontrollera versionerna av Node.js och npm.

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

Installera MongoDB

Wiki.js använder MongoDB som en databasmotor. Enligt det kommer vi att behöva installera MongoDB på vår server.

Installera MongoDB.

sudo dnf install -y mongodb mongodb-server

Kontrollera MongoDB-versionen.

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

Aktivera och starta MongoDB.

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

Installera och konfigurera Nginx

Wiki.js kan köras utan någon egentlig webbserver (som Nginx eller Apache). Det rekommenderas dock starkt att sätta en standard webbserver framför Wiki.js. Detta säkerställer att du kan använda funktioner som SSL, flera webbplatser, cachning och andra. Vi kommer att använda Nginx i den här handledningen, men vilken annan server som helst, du behöver bara konfigurera den ordentligt.

Installera Nginx.

sudo dnf install -y nginx

Kontrollera versionen.

nginx -v
# nginx version: nginx/1.12.1

Aktivera och starta Nginx.

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

Konfigurera Nginx som en HTTPeller HTTPS(om du använder SSL) omvänd proxy för Wiki.js-applikationen.

Kör sudo vim /etc/nginx/conf.d/wiki.js.confoch fyll i den med den grundläggande omvända proxykonfigurationen nedan.

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 enda du behöver ändra i ovanstående konfiguration är server_namedirektivet, och eventuellt proxy_passdirektivet om du bestämmer dig för att konfigurera någon annan port än 3000. Wiki.js använder port som 3000standard.

Kontrollera konfigurationen.

sudo nginx -t

Ladda om Nginx.

sudo systemctl reload nginx.service

Installera Acme.sh-klienten och skaffa Let's Encrypt-certifikat (valfritt)

Att säkra din wiki med HTTPSär inte nödvändigt, men det är en god praxis att säkra din webbplatstrafik. För att få ett SSL-certifikat från Let's Encrypt kommer vi att använda Acme.sh-klienten. Acme.sh är ett rent unix-skalprogramvara för att erhålla SSL-certifikat från Let's Encrypt med noll beroenden. Det gör den väldigt lätt i jämförelse med vissa andra ACME-protokollklienter som kräver många beroenden för att fungera framgångsrikt.

Ladda ner och installera 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 your_email@example.com
cd ~

Kontrollera acme.shversionen.

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

Skaffa RSA- och ECDSA-certifikat för 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 your_email@example.com --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 your_email@example.com --ocsp-must-staple --keylength ec-256 

När du har kört ovanstående kommandon kommer dina certifikat och nycklar att finnas i:

• För RSA: /etc/letsencrypt/wiki.example.com
• För ECC/ECDSA: /etc/letsencrypt/wiki.example.com_ecc

OBS : Glöm inte att ersätta wiki.example.commed ditt domännamn.

Efter att ha erhållit certifikat från Let's Encrypt måste vi konfigurera Nginx för att dra fördel av dem.

Kör sudo vim /etc/nginx/conf.d/wiki.js.configen och konfigurera Nginx som en HTTPSomvänd 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;
    }

}

Kontrollera konfigurationen.

sudo nginx -t

Ladda om Nginx.

sudo systemctl reload nginx.service

Installera Wiki.js

Skapa en tom dokumentrotmapp där Wiki.js ska installeras.

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

Navigera till dokumentets rotmapp.

cd /var/www/wiki.example.com

Ändra ägande av /var/www/wiki.example.commapp till användare johndoe.

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

/var/www/wiki.example.comKör följande kommando från mappen för att ladda ner och installera Wiki.js.

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

Du kan köra följande kommando för att se den för närvarande installerade versionen av Wiki.js.

node wiki --version
# 1.0.78

När installationen är klar kommer du att bli ombedd att köra konfigurationsguiden.

Starta konfigurationsguiden genom att köra.

node wiki configure

Detta kommer att meddela dig att navigera till för http://localhost:3000att konfigurera Wiki.js. Om du har Nginx framför Wiki.js betyder det att du kan öppna ditt domännamn (t.ex. http://wiki.example.com) istället för att gå till localhost.

Använd din webbläsare, navigera till http://wiki.example.comoch följ instruktionerna på skärmen. Alla inställningar som angetts under konfigurationsguiden sparas i config.ymlfilen. Konfigurationsguiden startar automatiskt Wiki.js åt dig.

Ställ in PM2

Som standard startar inte Wiki.js automatiskt efter en omstart av systemet. För att få det att starta vid uppstart måste vi ställa in PM2 process manager. PM2 levereras med Wiki.js som en lokal NPM-modul, så vi behöver inte installera PM2 globalt.

Be PM2 att konfigurera sig själv som en starttjänst genom att köra:

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

Slutligen, spara den aktuella PM2-konfigurationen genom att köra kommandot: /var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

Din Wiki.js-instans körs som en bakgrundsprocess med PM2 som processhanterare.