Hur man installerar Wiki.js på Ubuntu 18.04

Wiki.js är en gratis och öppen källkod, modern wiki-app byggd på Node.js , 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 Ubuntu 18.04 LTS Vultr-instans med Node.js, MongoDB, PM2, Nginx, Git och Acme.sh.

Krav

Krav för att köra Wiki.js och slutföra den här guiden är som följer:

• Node.js version 6.9.0 eller senare
• MongoDB version 3.2 eller senare
• Nginx
• Git version 2.7.4 eller senare
• Minst 768MB RAM
• Domännamn med A/ AAAAposter inställda

Kontrollera Ubuntu-versionen.

lsb_release -ds
# Ubuntu 18.04.4 LTS

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

Se till att ditt system är uppdaterat.

sudo apt update && sudo apt upgrade -y

Installera nödvändiga paket.

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

Installera Git

Git 2.7.4 kommer förinstallerat på Ubuntu server edition, så vi behöver inte installera det. Om du vill installera en nyare version kan du använda tredjeparts PPA:er eller kompilera den senaste versionen av Git från källan.

Du kan verifiera den för närvarande installerade versionen av Git genom att köra:

git --version
# git version 2.7.4

Om du vill installera en nyare version av Git-programvaran kan du använda följande.

# 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

Verifiera Git-versionen.

git --version
# git version 2.17.0

Installera Node.js

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

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

Kontrollera versionerna av Node.js och NPM.

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

Installera MongoDB

Vi kommer att använda de officiella MongoDB-förråden , som hålls uppdaterade med de senaste större och mindre MongoDB-utgåvorna.

Installera MongoDB Community Edition.

sudo apt install -y mongodb

Kontrollera versionen.

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

Installera och konfigurera Nginx

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

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 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 förutom 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 ett Let's Encrypt-certifikat (valfritt)

Att säkra din wiki med HTTPSär inte nödvändigt, men det kommer att säkra din webbplats trafik. Acme.sh är ett rent unix-skalprogramvara för att erhålla SSL-certifikat från Let's Encrypt med noll beroenden.

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

Skaffa RSA- och ECDSA-certifikat för wiki.example.comdomän/värdnamn.

# 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 

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

• För RSA: /etc/letsencrypt/wiki.example.comkatalogen.
• För ECC/ECDSA: /etc/letsencrypt/wiki.example.com_ecckatalogen.

Efter att ha erhållit certifikat från Let's Encrypt måste vi konfigurera Nginx för att använda 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 äganderätten till /var/www/wiki.example.commappen till användaren 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

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

node wiki --version
# 1.0.78

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

Starta konfigurationsguiden.

node wiki configure

Detta kommer att meddela dig att bläddra till för http://localhost:3000att konfigurera Wiki.js. Om du har Nginx framför Wiki.js kan du ö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.

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

Wiki.js körs som en bakgrundsprocess och använder PM2 som processhanterare.