Hoe Wiki.js op Debian 9 te installeren

• Vereisten
• Installeer Git
• Installeer Node.js
• Installeer MongoDB
• Installeer en configureer Nginx
• Installeer Acme.sh en verkrijg een 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 laat zien hoe je Wiki.js installeert op een nieuwe Debian 9 Vultr-instantie met behulp van Node.js, MongoDB, PM2, Nginx, Git en Acme.sh.

Vereisten

• Node.js 6.9.0 of hoger
• MongoDB 3.2 of hoger
• Nginx
• Git 2.7.4 of hoger
• Een Git-compatibele repository (openbaar of privé) ( optioneel )
• Minimaal 768MB RAM
• Domeinnaam met A/ AAAArecords ingesteld

Controleer de Debian-versie.

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

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

apt update && apt upgrade -y

Installeer de benodigde pakketten.

apt install -y build-essential apt-transport-https sudo curl wget dirmngr sudo

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

Installeer Git

Installeer Git op Debian.

sudo apt install -y git

Controleer de Git-versie.

git --version
# git version 2.11.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

Wiki.js gebruikt MongoDB als database-engine. Volgens dat moeten we MongoDB op onze server installeren. We zullen de officiële MongoDB-opslagplaatsen gebruiken voor installatie.

Installeer MongoDB Community Edition.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/3.6 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
sudo apt update
sudo apt install -y mongodb-org

Controleer de versie.

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

Schakel MongoDB in en start het.

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

Installeer en configureer Nginx

Het wordt sterk aanbevolen om een ​​standaard webserver voor Wiki.js. te plaatsen. Dit zorgt ervoor dat u functies zoals SSL, meerdere websites, caching en meer 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.

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/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(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 HTTPof HTTPS(als je SSL gebruikt) reverse proxy voor 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 Acme.sh en verkrijg een 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 your_email@example.com
cd ~

Controleer de versie.

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

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

Na het uitvoeren van de bovenstaande opdrachten, bevinden uw certificaten en sleutels zich in de volgende mappen.

• Voor RSA: /etc/letsencrypt/wiki.example.comdirectory.
• Voor ECC / ECDSA: /etc/letsencrypt/wiki.example.com_eccdirectory.

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/example.com.key;
    # ECDSA
    ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/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 de PM2-procesmanager 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

Uw Wiki.js-exemplaar wordt uitgevoerd als een achtergrondproces, met PM2 als procesmanager. U kunt uw besturingssysteem opnieuw opstarten met sudo rebooten controleren of Wiki.js start na een herstart.