Hoe Wiki.js op Fedora 28 te installeren

• Vereisten
• Voordat je begint
• Installeer Node.js
• Installeer MongoDB
• Installeer en configureer Nginx
• Installeer de Acme.sh-client en verkrijg het Let's Encrypt-certificaat (optioneel)
• Installeer Wiki.js
• PM2 instellen

Wiki.js is een gratis en open source, moderne wiki-app gebouwd op Node.js, MongoDB, Git en Markdown. De broncode van Wiki.js wordt openbaar gehost op Github . Deze gids zal je laten zien hoe je Wiki.js installeert op een nieuwe Fedora 28 Vultr instantie met behulp van Node.js, MongoDB, PM2, Nginx, Git en Acme.sh.

Vereisten

Vereisten om Wiki.js uit te voeren zijn de volgende:

• Node.js versie 6.9.0 of hoger
• MongoDB versie 3.2 of hoger
• Een webserver zoals Nginx, Apache, IIS, Caddy of H2O. Deze gids zal Nginx gebruiken
• Git versie 2.7.4 of hoger
• Een Git-compatibele repository (openbaar of privé) Dit is optioneel
• Minimaal 768 MB RAM
• Domeinnaam met A/ AAAArecords ingesteld

Voordat je begint

Controleer de OS-versie.

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

Maak een nieuw niet-root gebruikersaccount met sudo-toegang en schakel ernaar.

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

OPMERKING: vervang johndoedoor uw gebruikersnaam.

Zorg ervoor dat uw systeem up-to-date is.

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

Stel de tijdzone in.

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

Installeer vereiste en nuttige pakketten.

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

Schakel voor de eenvoud SELinux en Firewall uit.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Installeer Node.js

Wiki.js vereist Node.js 6.9.0 of hoger, dus we zullen eerst Node.js. moeten installeren

Installeer Node.js.

sudo dnf install -y nodejs

Controleer Node.js en npm-versies.

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

Installeer MongoDB

Wiki.js gebruikt MongoDB als database-engine. Volgens dat moeten we MongoDB op onze server installeren.

Installeer MongoDB.

sudo dnf install -y mongodb mongodb-server

Controleer de MongoDB-versie.

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

Schakel MongoDB in en start het.

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

Installeer en configureer Nginx

Wiki.js kan worden uitgevoerd zonder een echte webserver (zoals Nginx of Apache). Het wordt echter ten zeerste aanbevolen om een ​​standaard webserver voor Wiki.js. te plaatsen. Dit zorgt ervoor dat u functies zoals SSL, meerdere websites, caching en andere kunt gebruiken. We zullen Nginx gebruiken in deze tutorial, maar elke andere server zal het doen, je hoeft het alleen maar goed te configureren.

Installeer Nginx.

sudo dnf install -y nginx

Controleer de versie.

nginx -v
# nginx version: nginx/1.12.1

Schakel Nginx in en start het.

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

Configureer Nginx als HTTPof HTTPS(als je SSL gebruikt) reverse proxy voor de Wiki.js applicatie.

Voer het uit sudo vim /etc/nginx/conf.d/wiki.js.confen vul het in met de basis omgekeerde proxyconfiguratie hieronder.

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

}

Het enige dat u in de bovenstaande configuratie moet wijzigen, is de server_namerichtlijn en mogelijk de proxy_passrichtlijn als u besluit een andere poort dan te configureren 3000. Wiki.js gebruikt 3000standaard poort .

Controleer de configuratie.

sudo nginx -t

Herlaad Nginx.

sudo systemctl reload nginx.service

Installeer de Acme.sh-client en verkrijg het Let's Encrypt-certificaat (optioneel)

Het beveiligen van uw wiki met HTTPSis niet nodig, maar het is een goede gewoonte om uw siteverkeer te beveiligen. Om een ​​SSL-certificaat van Let's Encrypt te verkrijgen, gebruiken we de Acme.sh-client. Acme.sh is pure unix shell-software voor het verkrijgen van SSL-certificaten van Let's Encrypt zonder afhankelijkheden. Dat maakt het zeer licht in vergelijking met sommige andere ACME-protocolclients die veel afhankelijkheden vereisen om succesvol te kunnen werken.

Download en installeer 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 ~

Controleer de acme.shversie.

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

Verkrijgen van RSA- en ECDSA-certificaten voor 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 

Na het uitvoeren van de bovenstaande opdrachten, bevinden uw certificaten en sleutels zich in:

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

OPMERKING : vergeet niet te vervangen wiki.example.comdoor uw domeinnaam.

Na het verkrijgen van certificaten van Let's Encrypt, moeten we Nginx configureren om hiervan te profiteren.

Voer sudo vim /etc/nginx/conf.d/wiki.js.confopnieuw uit en configureer Nginx als een HTTPSreverse 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;
    }

}

Controleer de configuratie.

sudo nginx -t

Herlaad Nginx.

sudo systemctl reload nginx.service

Installeer Wiki.js

Maak een lege documenthoofdmap, waar Wiki.js moet worden geïnstalleerd.

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

Navigeer naar de hoofdmap van het document.

cd /var/www/wiki.example.com

Verander het eigendom van de /var/www/wiki.example.commap in de gebruiker johndoe.

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

/var/www/wiki.example.comVoer vanuit de map de volgende opdracht uit om Wiki.js. te downloaden en te installeren

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

U kunt de volgende opdracht uitvoeren om de momenteel geïnstalleerde versie van Wiki.js. te bekijken.

node wiki --version
# 1.0.78

Zodra de installatie is voltooid, wordt u gevraagd de configuratiewizard uit te voeren.

Start de configuratiewizard door te draaien.

node wiki configure

Dit zal je informeren om naar te navigeren om http://localhost:3000Wiki.js. te configureren Als je Nginx voor Wiki.js hebt staan, betekent dit dat je je domeinnaam (bijv. http://wiki.example.com) Kunt openen in plaats van naar te gaan localhost.

Navigeer met uw webbrowser naar http://wiki.example.comen volg de instructies op het scherm. Alle instellingen die tijdens de configuratiewizard zijn ingevoerd, worden in het config.ymlbestand opgeslagen . De configuratiewizard start automatisch Wiki.js voor u.

PM2 instellen

Standaard zal Wiki.js niet automatisch starten nadat het systeem opnieuw is opgestart. Om het bij het opstarten te laten starten, moeten we PM2-procesmanager instellen. PM2 wordt geleverd met Wiki.js als een lokale NPM-module, dus we hoeven PM2 niet wereldwijd te installeren.

Laat PM2 zichzelf configureren als opstartservice door het volgende uit te voeren:

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

Sla ten slotte de huidige PM2-configuratie op door de opdracht uit te voeren: /var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

Uw Wiki.js-exemplaar wordt uitgevoerd als een achtergrondproces, met PM2 als procesmanager.