Kuidas installida Wiki.js-i Ubuntu versiooni 18.04

Wiki.js on tasuta ja avatud lähtekoodiga, kaasaegne wiki app ehitatud Node.js , Git ja Hinnaalandus . Wiki.js lähtekoodi majutatakse avalikult Githubis . See juhend näitab teile, kuidas installida Wiki.js uuele Ubuntu 18.04 LTS Vultr eksemplarile, kasutades Node.js, MongoDB, PM2, Nginx, Git ja Acme.sh.

Nõuded

Nõuded Wiki.js-i käivitamiseks ja selle juhendi lõpetamiseks on järgmised:

• Node.js versioon 6.9.0 või uuem
• MongoDB versioon 3.2 või uuem
• Nginx
• Giti versioon 2.7.4 või uuem
• Vähemalt 768 MB RAM
• Domeeninimi A/ AAAAkirjetega seadistatud

Kontrollige Ubuntu versiooni.

lsb_release -ds
# Ubuntu 18.04.4 LTS

Looge uus juurdepääsuga non-rootkasutajakonto sudoja lülituge sellele.

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

MÄRKUS . Asendage johndoeoma kasutajanimega.

Seadistage ajavöönd.

sudo dpkg-reconfigure tzdata

Veenduge, et teie süsteem on ajakohane.

sudo apt update && sudo apt upgrade -y

Installige vajalikud paketid.

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

Installige Git

Git 2.7.4 on Ubuntu serveriväljaandes eelinstallitud, nii et me ei pea seda installima. Kui soovite installida uuema versiooni, võite kasutada kolmandate osapoolte PPA-sid või kompileerida Giti uusima väljalase allikast.

Praegu installitud Giti versiooni saate kontrollida, käivitades:

git --version
# git version 2.7.4

Kui soovite installida Giti tarkvara uuema versiooni, saate kasutada järgmist.

# 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

Kontrollige Giti versiooni.

git --version
# git version 2.17.0

Installige Node.js

Installige Node.js, kasutades Node.js jaoks NodeSource APT hoidlat.

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

Kontrollige Node.js ja NPM versioone.

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

Installige MongoDB

Kasutame ametlikke MongoDB hoidlaid , mida hoitakse kursis viimaste suuremate ja väiksemate MongoDB väljaannetega.

Installige MongoDB Community Edition.

sudo apt install -y mongodb

Kontrolli versiooni.

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

Installige ja konfigureerige Nginx

Installige 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

Kontrolli versiooni.

sudo nginx -v
# nginx version: nginx/1.15.0

Lubage ja käivitage Nginx.

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

Seadistage Nginx rakenduse Wiki.js pöördpuhverserverina.

Käivitage sudo vim /etc/nginx/conf.d/wiki.js.confja sisestage see alloleva pöördpuhverserveri põhikonfiguratsiooniga.

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

}

Ainus asi, mida ülaltoodud konfiguratsioonis muutma pead, on server_namedirektiiv ja potentsiaalselt ka proxy_passdirektiiv, kui otsustad seadistada peale mõne muu pordi 3000. Wiki.js kasutab 3000vaikimisi porti .

Kontrollige konfiguratsiooni.

sudo nginx -t

Laadige Nginx uuesti.

sudo systemctl reload nginx.service

Installige Acme.sh klient ja hankige Let's Encrypt sertifikaat (valikuline)

Viki kaitsmine HTTPSei ole vajalik, kuid see tagab teie saidi liikluse. Acme.sh on puhas unixi kestatarkvara, mis võimaldab hankida Let's Encrypt SSL-sertifikaate ilma sõltuvusteta.

Laadige alla ja installige 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 ~

Kontrolli versiooni.

/etc/letsencrypt/acme.sh --version

Hankige wiki.example.comdomeeni/hostinime jaoks RSA ja ECDSA sertifikaadid .

# 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 

Pärast ülaltoodud käskude käivitamist on teie sertifikaadid ja võtmed:

• RSA jaoks: /etc/letsencrypt/wiki.example.comkataloog.
• ECC/ECDSA jaoks: /etc/letsencrypt/wiki.example.com_ecckataloog.

Pärast Let's Encrypti sertifikaatide saamist peame konfigureerima Nginxi nende kasutamiseks.

Käivitage sudo vim /etc/nginx/conf.d/wiki.js.confuuesti ja konfigureerige Nginx pöördpuhverserverina HTTPS.

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

}

Kontrollige konfiguratsiooni.

sudo nginx -t

Laadige Nginx uuesti.

sudo systemctl reload nginx.service

Installige Wiki.js

Looge tühi dokumendi juurkaust, kuhu tuleks installida Wiki.js.

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

Liikuge dokumendi juurkausta.

cd /var/www/wiki.example.com

Muutke /var/www/wiki.example.comkausta omandiõigus kasutajale johndoe.

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

Alates /var/www/wiki.example.comkausta, käivitage järgmine käsk alla laadida ja installida Wiki.js.

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

Praegu installitud Wiki.js-i versiooni vaatamiseks võite käivitada järgmise käsu.

node wiki --version
# 1.0.78

Kui installimine on lõpetatud, palutakse teil käivitada konfiguratsiooniviisard.

Käivitage konfiguratsiooniviisard.

node wiki configure

See teavitab teid http://localhost:3000Wiki.js-i seadistamiseks sirvides. Kui teil on Wiki.js-i ees Nginx, saate http://wiki.example.comselle asemel avada oma domeeninime (nt ) localhost.

Liikuge oma veebibrauseriga lehele http://wiki.example.comja järgige ekraanil kuvatavaid juhiseid. Kõik konfiguratsiooniviisardi käigus sisestatud seaded salvestatakse config.ymlfaili. Konfiguratsiooniviisard käivitab teie eest automaatselt Wiki.js'i.

Installige PM2

Vaikimisi ei käivitu Wiki.js automaatselt pärast süsteemi taaskäivitamist. Selle käivitamiseks käivitamisel peame seadistama PM2. PM2 on kohaliku NPM-moodulina komplektis Wiki.js-iga, nii et me ei pea PM2 globaalselt installima.

Öelge PM2-le, et ta konfigureeriks end käivitusteenusena.

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

Lõpuks salvestage praegune PM2 konfiguratsioon.

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

Wiki.js töötab taustprotsessina, kasutades protsessihaldurina PM2.