Hoe Wiki.js op Ubuntu 18.04 te installeren

• Vereisten
• Installeer Git
• Installeer Node.js
• Installeer MongoDB
• Installeer en configureer Nginx
• Installeer de Acme.sh-client en verkrijg een Let's Encrypt-certificaat (optioneel)
• Installeer Wiki.js
• Installeer PM2

Wiki.js is een gratis en open source, moderne wiki-app gebouwd op Node.js , Git en Markdown . De broncode van Wiki.js wordt openbaar gehost op Github . Deze handleiding laat zien hoe je Wiki.js installeert op een nieuwe Ubuntu 18.04 LTS Vultr-instantie met Node.js, MongoDB, PM2, Nginx, Git en Acme.sh.

Vereisten

Vereisten om Wiki.js uit te voeren en deze handleiding te voltooien zijn als volgt:

• Node.js versie 6.9.0 of hoger
• MongoDB versie 3.2 of hoger
• Nginx
• Git versie 2.7.4 of hoger
• Minimaal 768 MB RAM
• Domeinnaam met A/ AAAArecords ingesteld

Controleer de Ubuntu-versie.

lsb_release -ds
# Ubuntu 18.04.4 LTS

Maak een nieuw non-rootgebruikersaccount aan met sudotoegang en schakel ernaar.

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

OPMERKING : vervang johndoedoor uw gebruikersnaam.

Stel de tijdzone in.

sudo dpkg-reconfigure tzdata

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

sudo apt update && sudo apt upgrade -y

Installeer de benodigde pakketten.

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

Installeer Git

Git 2.7.4 is vooraf geïnstalleerd op de Ubuntu-servereditie, dus we hoeven het niet te installeren. Als je een nieuwere versie wilt installeren, kun je PPA's van derden gebruiken of de nieuwste release van Git vanaf de bron compileren.

Je kunt de momenteel geïnstalleerde versie van Git verifiëren door het volgende uit te voeren:

git --version
# git version 2.7.4

Als je een nieuwere versie van Git-software wilt installeren, kun je het volgende gebruiken.

# 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

Controleer de Git-versie.

git --version
# git version 2.17.0

Installeer Node.js

Installeer Node.js met behulp van de NodeSource APT-repository voor Node.js.

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt install -y nodejs

Controleer de versies Node.js en NPM.

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

Installeer MongoDB

We zullen de officiële MongoDB-repositories gebruiken , die up-to-date worden gehouden met de meest recente grote en kleine MongoDB-releases.

Installeer MongoDB Community Edition.

sudo apt install -y mongodb

Controleer de versie.

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

Installeer en configureer Nginx

Installeer 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

Controleer de versie.

sudo nginx -v
# nginx version: nginx/1.15.0

Schakel Nginx in en start het.

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

Configureer Nginx als een 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 bovenstaande configuratie moet wijzigen, is de server_namerichtlijn en mogelijk de proxy_passrichtlijn als u besluit een andere poort 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 een Let's Encrypt-certificaat (optioneel)

Het beveiligen van uw wiki met HTTPSis niet nodig, maar het zal het verkeer van uw site beveiligen. Acme.sh is pure unix shell-software voor het verkrijgen van SSL-certificaten van Let's Encrypt zonder afhankelijkheden.

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 versie.

/etc/letsencrypt/acme.sh --version

Verkrijg RSA- en ECDSA-certificaten voor wiki.example.comdomein / hostnaam.

# 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: de /etc/letsencrypt/wiki.example.comdirectory.
• Voor ECC / ECDSA: de /etc/letsencrypt/wiki.example.com_eccdirectory.

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

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

Om de momenteel geïnstalleerde versie van Wiki.js te bekijken, kunt u de volgende opdracht uitvoeren.

node wiki --version
# 1.0.78

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

Start de configuratiewizard.

node wiki configure

Hierdoor wordt u http://localhost:3000gewaarschuwd om naar te bladeren om Wiki.js. te configureren. Als je Nginx voor Wiki.js hebt staan, kun je je domeinnaam (bijv. http://wiki.example.com) 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.

Installeer PM2

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

Vraag PM2 om zichzelf te configureren als opstartservice.

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

Sla ten slotte de huidige PM2-configuratie op.

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

Wiki.js draait als een achtergrondproces, met PM2 als procesmanager.