Ako nainštalovať Wiki.js na Ubuntu 18.04

Wiki.js je bezplatná a moderná wiki aplikácia s otvoreným zdrojom postavená na Node.js , Git a Markdown . Zdrojový kód Wiki.js je verejne hosťovaný na serveri Github . Táto príručka vám ukáže, ako nainštalovať Wiki.js na novú inštanciu Ubuntu 18.04 LTS Vultr pomocou Node.js, MongoDB, PM2, Nginx, Git a Acme.sh.

Požiadavky

Požiadavky na spustenie Wiki.js a dokončenie tohto sprievodcu sú nasledovné:

• Node.js verzie 6.9.0 alebo novšej
• MongoDB verzia 3.2 alebo novšia
• Nginx
• Git verzia 2.7.4 alebo novšia
• Minimálne 768 MB RAM
• Názov domény s nastavenými záznamami A/AAAA

Skontrolujte verziu Ubuntu.

lsb_release -ds
# Ubuntu 18.04.4 LTS

Vytvorte si nový non-rootpoužívateľský účet s sudoprístupom a prepnite sa naň.

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

POZNÁMKA : Nahraďte johndoesvojím užívateľským menom.

Nastavte časové pásmo.

sudo dpkg-reconfigure tzdata

Uistite sa, že váš systém je aktuálny.

sudo apt update && sudo apt upgrade -y

Nainštalujte potrebné balíčky.

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

Nainštalujte Git

Git 2.7.4 je predinštalovaný na serverovej edícii Ubuntu, takže ho nemusíme inštalovať. Ak chcete nainštalovať novšiu verziu, môžete použiť PPA tretích strán alebo skompilovať najnovšie vydanie Git zo zdroja.

Aktuálne nainštalovanú verziu Git si môžete overiť spustením:

git --version
# git version 2.7.4

Ak chcete nainštalovať novšiu verziu softvéru Git, môžete použiť nasledujúce.

# 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

Overte verziu Git.

git --version
# git version 2.17.0

Nainštalujte Node.js

Nainštalujte Node.js pomocou repozitára NodeSource APT pre Node.js.

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

Skontrolujte verzie Node.js a NPM.

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

Nainštalujte MongoDB

Budeme používať oficiálne úložiská MongoDB , ktoré sú aktualizované podľa najnovších veľkých a menších vydaní MongoDB.

Nainštalujte si MongoDB Community Edition.

sudo apt install -y mongodb

Skontrolujte verziu.

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

Nainštalujte a nakonfigurujte Nginx

Nainštalujte 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

Skontrolujte verziu.

sudo nginx -v
# nginx version: nginx/1.15.0

Povoľte a spustite Nginx.

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

Nakonfigurujte Nginx ako reverzný proxy pre aplikáciu Wiki.js.

Spustite sudo vim /etc/nginx/conf.d/wiki.js.confa naplňte ho základnou konfiguráciou reverzného servera proxy nižšie.

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

}

Jediná vec, ktorú musíte zmeniť vo vyššie uvedenej konfigurácii, je server_namesmernica a prípadne proxy_passsmernica, ak sa rozhodnete nakonfigurovať akýkoľvek iný port okrem 3000. Wiki.js štandardne používa port 3000.

Skontrolujte konfiguráciu.

sudo nginx -t

Znova načítať Nginx.

sudo systemctl reload nginx.service

Nainštalujte klienta Acme.sh a získajte certifikát Let's Encrypt (voliteľné)

Zabezpečenie vašej wiki HTTPSnie je potrebné, ale zabezpečí návštevnosť vašej stránky. Acme.sh je čistý unixový shell softvér na získavanie SSL certifikátov od Let's Encrypt s nulovými závislosťami.

Sťahovať a inštalovať 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 ~

Skontrolujte verziu.

/etc/letsencrypt/acme.sh --version

Získajte certifikáty RSA a ECDSA pre wiki.example.comdoménu/názov hostiteľa.

# 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 spustení vyššie uvedených príkazov budú vaše certifikáty a kľúče v:

• Pre RSA: /etc/letsencrypt/wiki.example.comadresár.
• Pre ECC/ECDSA: /etc/letsencrypt/wiki.example.com_eccadresár.

Po získaní certifikátov z Let's Encrypt musíme nakonfigurovať Nginx na ich používanie.

Spustite sudo vim /etc/nginx/conf.d/wiki.js.confznova a nakonfigurujte Nginx ako HTTPSreverzný 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;
    }

}

Skontrolujte konfiguráciu.

sudo nginx -t

Znova načítať Nginx.

sudo systemctl reload nginx.service

Nainštalujte si Wiki.js

Vytvorte prázdny koreňový priečinok dokumentov, kde by mala byť nainštalovaná Wiki.js.

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

Prejdite do koreňového priečinka dokumentu.

cd /var/www/wiki.example.com

Zmeňte vlastníctvo /var/www/wiki.example.compriečinka na používateľa johndoe.

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

Z /var/www/wiki.example.compriečinka spustite nasledujúci príkaz na stiahnutie a inštaláciu Wiki.js.

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

Ak chcete zobraziť aktuálne nainštalovanú verziu Wiki.js, môžete spustiť nasledujúci príkaz.

node wiki --version
# 1.0.78

Po dokončení inštalácie sa zobrazí výzva na spustenie sprievodcu konfiguráciou.

Spustite sprievodcu konfiguráciou.

node wiki configure

Toto vás upozorní, aby ste http://localhost:3000prešli na konfiguráciu Wiki.js. Ak máte pred Wiki.js Nginx, môžete si http://wiki.example.comnamiesto prechodu na stránku otvoriť názov svojej domény (napr. ) localhost.

Pomocou webového prehliadača prejdite na http://wiki.example.compokyny na obrazovke a postupujte podľa nich. Všetky nastavenia zadané počas sprievodcu konfiguráciou sa uložia do config.ymlsúboru. Sprievodca konfiguráciou automaticky spustí Wiki.js.

Nainštalujte PM2

V predvolenom nastavení sa Wiki.js nespustí automaticky po reštarte systému. Aby sa to spustilo pri bootovaní, musíme nastaviť PM2. PM2 sa dodáva spolu s Wiki.js ako lokálny modul NPM, takže PM2 nemusíme inštalovať globálne.

Povedzte PM2, aby sa nakonfiguroval ako spúšťacia služba.

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

Nakoniec uložte aktuálnu konfiguráciu PM2.

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

Wiki.js beží ako proces na pozadí a používa PM2 ako svojho správcu procesov.