Hur man installerar Wiki.js på Debian 9

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 Debian 9 Vultr-instans genom att använda Node.js, MongoDB, PM2, Nginx, Git och Acme.sh.

Krav

• Node.js 6.9.0 eller senare
• MongoDB 3.2 eller senare
• Nginx
• Git 2.7.4 eller senare
• Ett Git-kompatibelt arkiv (offentligt eller privat) ( valfritt )
• Minst 768MB RAM
• Domännamn med A/ AAAAposter inställda

Kontrollera Debian-versionen.

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

Se till att ditt system är uppdaterat.

apt update && apt upgrade -y

Installera nödvändiga paket.

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

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

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

OBS : Ersätt johndoemed ditt användarnamn.

Ställ in tidszonen.

sudo dpkg-reconfigure tzdata

Installera Git

Installera Git på Debian.

sudo apt install -y git

Verifiera Git-versionen.

git --version
# git version 2.11.0

Installera Node.js

Installera Node.js genom att använda NodeSource APT-arkivet för Node.js.

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

Kontrollera versionerna Node.js och npm.

node -v && npm -v
# v8.11.2
# 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. Vi kommer att använda de officiella MongoDB-förråden för installation.

Installera 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

Kontrollera versionen.

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

Aktivera och starta MongoDB.

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

Installera och konfigurera Nginx

Det rekommenderas 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 mer. 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.

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

Kontrollera versionen.

sudo nginx -v
# nginx version: nginx/1.15.0

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 och skaffa ett 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 [email protected]
cd ~

Kontrollera versionen.

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

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

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

• För RSA: /etc/letsencrypt/wiki.example.comkatalog.
• För ECC/ECDSA: /etc/letsencrypt/wiki.example.com_ecckatalog.

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

}

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 konfigurera PM2 processhanteraren. 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.

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

Slutligen, spara den aktuella PM2-konfigurationen.

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

Din Wiki.js-instans körs som en bakgrundsprocess med PM2 som processhanterare. Du kan starta om ditt operativsystem med sudo rebootoch kontrollera om Wiki.js startar efter en omstart.