Kā instalēt Wiki.js Ubuntu 18.04

Wiki.js ir bezmaksas atvērtā pirmkoda moderna wiki lietotne, kas veidota uz Node.js , Git un Markdown . Wiki.js pirmkods ir publiski mitināts vietnē Github . Šajā rokasgrāmatā tiks parādīts, kā instalēt Wiki.js jaunā Ubuntu 18.04 LTS Vultr instancē, izmantojot Node.js, MongoDB, PM2, Nginx, Git un Acme.sh.

Prasības

Prasības, lai palaistu Wiki.js un pabeigtu šo rokasgrāmatu, ir šādas:

• Node.js versija 6.9.0 vai jaunāka
• MongoDB versija 3.2 vai jaunāka
• Nginx
• Git versija 2.7.4 vai jaunāka
• Vismaz 768 MB RAM
• Iestatīts domēna nosaukums ar A/ AAAAierakstiem

Pārbaudiet Ubuntu versiju.

lsb_release -ds
# Ubuntu 18.04.4 LTS

Izveidojiet jaunu non-rootlietotāja kontu ar sudopiekļuvi un pārslēdzieties uz to.

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

PIEZĪME . Aizstāt johndoear savu lietotājvārdu.

Iestatiet laika joslu.

sudo dpkg-reconfigure tzdata

Pārliecinieties, vai jūsu sistēma ir atjaunināta.

sudo apt update && sudo apt upgrade -y

Instalējiet nepieciešamās pakotnes.

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

Instalējiet Git

Git 2.7.4 ir iepriekš instalēts Ubuntu servera izdevumā, tāpēc mums tas nav jāinstalē. Ja vēlaties instalēt jaunāku versiju, varat izmantot trešo pušu PPA vai apkopot jaunāko Git versiju no avota.

Varat pārbaudīt pašlaik instalēto Git versiju, izpildot:

git --version
# git version 2.7.4

Ja vēlaties instalēt jaunāku Git programmatūras versiju, varat izmantot tālāk norādīto.

# 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

Pārbaudiet Git versiju.

git --version
# git version 2.17.0

Instalējiet Node.js

Instalējiet Node.js, izmantojot Node.js paredzēto NodeSource APT repozitoriju.

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

Pārbaudiet Node.js un NPM versijas.

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

Instalējiet MongoDB

Mēs izmantosim oficiālās MongoDB krātuves , kas tiek atjauninātas ar jaunākajiem lielākajiem un mazākajiem MongoDB laidieniem.

Instalējiet MongoDB Community Edition.

sudo apt install -y mongodb

Pārbaudiet versiju.

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

Instalējiet un konfigurējiet Nginx

Instalējiet 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

Pārbaudiet versiju.

sudo nginx -v
# nginx version: nginx/1.15.0

Iespējojiet un palaidiet Nginx.

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

Konfigurējiet Nginx kā apgriezto starpniekserveri lietojumprogrammai Wiki.js.

Palaidiet sudo vim /etc/nginx/conf.d/wiki.js.confun aizpildiet to, izmantojot tālāk norādīto reversā starpniekservera pamata konfigurāciju.

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

}

Vienīgais, kas jāmaina iepriekš minētajā konfigurācijā, ir server_namedirektīva un, iespējams, proxy_passdirektīva, ja nolemjat konfigurēt jebkuru citu portu, izņemot 3000. Wiki.js 3000pēc noklusējuma izmanto portu .

Pārbaudiet konfigurāciju.

sudo nginx -t

Pārlādēt Nginx.

sudo systemctl reload nginx.service

Instalējiet Acme.sh klientu un iegūstiet sertifikātu Let's Encrypt (pēc izvēles)

Wiki aizsardzība HTTPSnav nepieciešama, taču tā nodrošinās jūsu vietnes trafiku. Acme.sh ir tīra unix apvalka programmatūra SSL sertifikātu iegūšanai no Let's Encrypt bez atkarības.

Lejupielādēt un instalēt 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 ~

Pārbaudiet versiju.

/etc/letsencrypt/acme.sh --version

Iegūstiet RSA un ECDSA sertifikātus wiki.example.comdomēnam/resursdatora nosaukumam.

# 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ēc iepriekš minēto komandu palaišanas jūsu sertifikāti un atslēgas būs:

• RSA: /etc/letsencrypt/wiki.example.comdirektorijs.
• ECC/ECDSA: /etc/letsencrypt/wiki.example.com_eccdirektorijs.

Pēc sertifikātu iegūšanas no Let's Encrypt mums ir jākonfigurē Nginx, lai tos izmantotu.

Palaidiet sudo vim /etc/nginx/conf.d/wiki.js.confvēlreiz un konfigurējiet Nginx kā HTTPSapgriezto starpniekserveri.

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

}

Pārbaudiet konfigurāciju.

sudo nginx -t

Pārlādēt Nginx.

sudo systemctl reload nginx.service

Instalējiet Wiki.js

Izveidojiet tukšu dokumenta saknes mapi, kurā jāinstalē Wiki.js.

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

Pārejiet uz dokumenta saknes mapi.

cd /var/www/wiki.example.com

Mainiet /var/www/wiki.example.commapes īpašumtiesības uz lietotāju johndoe.

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

No /var/www/wiki.example.commapes palaidiet šo komandu, lai lejupielādētu un instalētu Wiki.js.

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

Lai skatītu pašlaik instalēto Wiki.js versiju, varat palaist šādu komandu.

node wiki --version
# 1.0.78

Kad instalēšana būs pabeigta, jums tiks piedāvāts palaist konfigurācijas vedni.

Sāciet konfigurācijas vedni.

node wiki configure

Tas jums paziņos, lai pārlūkotu, http://localhost:3000lai konfigurētu Wiki.js. Ja jums ir Nginx pirms Wiki.js, varat atvērt savu domēna nosaukumu (piemēram, http://wiki.example.com), nevis doties uz localhost.

Izmantojot tīmekļa pārlūkprogrammu, dodieties uz http://wiki.example.comun izpildiet ekrānā redzamos norādījumus. Visi konfigurācijas vedņa laikā ievadītie iestatījumi tiek saglabāti config.ymlfailā. Konfigurācijas vednis automātiski startēs Wiki.js jūsu vietā.

Instalējiet PM2

Pēc noklusējuma Wiki.js nesāksies automātiski pēc sistēmas atsāknēšanas. Lai to sāktu sāknēšanas laikā, mums ir jāiestata PM2. PM2 ir komplektā ar Wiki.js kā lokālo NPM moduli, tāpēc mums nav jāinstalē PM2 globāli.

Pastāstiet PM2 konfigurēt sevi kā startēšanas pakalpojumu.

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

Visbeidzot, saglabājiet pašreizējo PM2 konfigurāciju.

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

Wiki.js darbojas kā fona process, izmantojot PM2 kā procesa pārvaldnieku.