Kako namestiti Wiki.js na Ubuntu 18.04

Wiki.js je brezplačna in odprtokodna, sodobna wiki aplikacija, zgrajena na Node.js , Git in Markdown . Izvorna koda Wiki.js je javno gostovana na Githubu . Ta priročnik vam bo pokazal, kako namestiti Wiki.js na nov primerek Ubuntu 18.04 LTS Vultr z uporabo Node.js, MongoDB, PM2, Nginx, Git in Acme.sh.

Zahteve

Zahteve za zagon Wiki.js in dokončanje tega vodnika so naslednje:

• Node.js različice 6.9.0 ali novejše
• MongoDB različica 3.2 ali novejša
• Nginx
• Git različica 2.7.4 ali novejša
• Najmanj 768 MB RAM-a
• Ime domene z A/ AAAAnastavljenimi zapisi

Preverite različico Ubuntuja.

lsb_release -ds
# Ubuntu 18.04.4 LTS

Ustvarite nov non-rootuporabniški račun z sudodostopom in preklopite nanj.

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

OPOMBA : Zamenjajte johndoes svojim uporabniškim imenom.

Nastavite časovni pas.

sudo dpkg-reconfigure tzdata

Prepričajte se, da je vaš sistem posodobljen.

sudo apt update && sudo apt upgrade -y

Namestite potrebne pakete.

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

Namesti Git

Git 2.7.4 je vnaprej nameščen v izdaji strežnika Ubuntu, zato nam ga ni treba namestiti. Če želite namestiti novejšo različico, lahko uporabite PPA tretjih oseb ali prevedete najnovejšo izdajo Gita iz vira.

Trenutno nameščeno različico Gita lahko preverite tako, da zaženete:

git --version
# git version 2.7.4

Če želite namestiti novejšo različico programske opreme Git, lahko uporabite naslednje.

# 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

Preverite različico Git.

git --version
# git version 2.17.0

Namestite Node.js

Namestite Node.js z uporabo repozitorija NodeSource APT za Node.js.

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

Preverite različici Node.js in NPM.

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

Namestite MongoDB

Uporabili bomo uradna repozitorija MongoDB , ki so posodobljena z najnovejšimi večjimi in manjšimi izdajami MongoDB.

Namestite MongoDB Community Edition.

sudo apt install -y mongodb

Preverite različico.

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

Namestite in konfigurirajte Nginx

Namestite 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

Preverite različico.

sudo nginx -v
# nginx version: nginx/1.15.0

Omogočite in zaženite Nginx.

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

Konfigurirajte Nginx kot povratni proxy za aplikacijo Wiki.js.

Zaženite ga sudo vim /etc/nginx/conf.d/wiki.js.confin ga napolnite s spodnjo osnovno konfiguracijo povratnega proxyja.

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

}

Edina stvar, ki jo morate spremeniti v zgornji konfiguraciji, je server_namedirektiva in morda proxy_passdirektiva, če se odločite konfigurirati še katera druga vrata poleg 3000. Wiki.js 3000privzeto uporablja vrata .

Preverite konfiguracijo.

sudo nginx -t

Ponovno naložite Nginx.

sudo systemctl reload nginx.service

Namestite odjemalca Acme.sh in pridobite certifikat Let's Encrypt (izbirno)

Zaščita vašega wikija z HTTPSni potrebna, vendar bo zavarovala promet na vašem spletnem mestu. Acme.sh je čista unix programska oprema za pridobivanje SSL certifikatov iz Let's Encrypt z nič odvisnostmi.

Prenesite in namestite 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 ~

Preverite različico.

/etc/letsencrypt/acme.sh --version

Pridobite potrdila RSA in ECDSA za wiki.example.comdomeno/ime gostitelja.

# 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 

Po zagonu zgornjih ukazov bodo vaši certifikati in ključi v:

• Za RSA: /etc/letsencrypt/wiki.example.comimenik.
• Za ECC/ECDSA: /etc/letsencrypt/wiki.example.com_eccimenik.

Po pridobitvi potrdil od Let's Encrypt moramo Nginx konfigurirati za njihovo uporabo.

Zaženite sudo vim /etc/nginx/conf.d/wiki.js.confznova in konfigurirajte Nginx kot HTTPSpovratni 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;
    }

}

Preverite konfiguracijo.

sudo nginx -t

Ponovno naložite Nginx.

sudo systemctl reload nginx.service

Namestite Wiki.js

Ustvarite prazno korensko mapo dokumenta, kamor naj bo nameščen Wiki.js.

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

Pomaknite se do korenske mape dokumenta.

cd /var/www/wiki.example.com

Spremenite lastništvo /var/www/wiki.example.commape na uporabnika johndoe.

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

V /var/www/wiki.example.commapi zaženite naslednji ukaz, da prenesete in namestite Wiki.js.

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

Če si želite ogledati trenutno nameščeno različico Wiki.js, lahko zaženete naslednji ukaz.

node wiki --version
# 1.0.78

Ko je namestitev končana, boste pozvani, da zaženete čarovnika za konfiguracijo.

Zaženite čarovnika za konfiguracijo.

node wiki configure

To vas bo obvestilo, da brskate do http://localhost:3000za konfiguracijo Wiki.js. Če imate Nginx pred Wiki.js, lahko odprete ime svoje domene (npr. http://wiki.example.com) namesto da greste na localhost.

S spletnim brskalnikom se pomaknite do http://wiki.example.comin sledite navodilom na zaslonu. Vse nastavitve, vnesene med čarovnikom za konfiguracijo, se shranijo v config.ymldatoteko. Čarovnik za konfiguracijo bo samodejno zagnal Wiki.js namesto vas.

Namestite PM2

Wiki.js se privzeto ne zažene samodejno po ponovnem zagonu sistema. Da bi se zagnal ob zagonu, moramo nastaviti PM2. PM2 je priložen Wiki.js kot lokalni modul NPM, zato nam ni treba namestiti PM2 globalno.

Povejte PM2, naj se konfigurira kot zagonska storitev.

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

Na koncu shranite trenutno konfiguracijo PM2.

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

Wiki.js deluje kot proces v ozadju, pri čemer uporablja PM2 kot upravitelja procesov.