Kako instalirati Wiki.js na Ubuntu 18.04

Zahtjevi

Instalirajte Git

Instalirajte Node.js

Instalirajte MongoDB

Instalirajte i konfigurirajte Nginx

Instalirajte Acme.sh klijent i nabavite certifikat Let's Encrypt (opcionalno)

Instalirajte Wiki.js

Instalirajte PM2

Wiki.js je besplatna moderna wiki aplikacija otvorenog koda izgrađena na Node.js , Git i Markdown . Izvorni kod Wiki.js javno se nalazi na Githubu . Ovaj vodič će vam pokazati kako instalirati Wiki.js na novu instancu Ubuntu 18.04 LTS Vultr koristeći Node.js, MongoDB, PM2, Nginx, Git i Acme.sh.

Zahtjevi

Zahtjevi za pokretanje Wiki.js i završetak ovog vodiča su sljedeći:

• Node.js verzija 6.9.0 ili novija
• MongoDB verzija 3.2 ili novija
• Nginx
• Git verzija 2.7.4 ili novija
• Najmanje 768 MB RAM-a
• Ime domene sa A/ AAAApostavljenim zapisima

Provjerite verziju Ubuntua.

lsb_release -ds
# Ubuntu 18.04.4 LTS

Napravite novi non-rootkorisnički račun s sudopristupom i prebacite se na njega.

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

NAPOMENA : Zamijenite johndoesvojim korisničkim imenom.

Postavite vremensku zonu.

sudo dpkg-reconfigure tzdata

Provjerite je li vaš sustav ažuriran.

sudo apt update && sudo apt upgrade -y

Instalirajte potrebne pakete.

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

Instalirajte Git

Git 2.7.4 dolazi unaprijed instaliran na Ubuntu poslužiteljskom izdanju, tako da ga ne moramo instalirati. Ako želite instalirati noviju verziju, možete koristiti PPA-ove treće strane ili sastaviti najnovije izdanje Gita iz izvora.

Možete provjeriti trenutno instaliranu verziju Gita tako da pokrenete:

git --version
# git version 2.7.4

Ako želite instalirati noviju verziju Git softvera, možete koristiti sljedeće.

# 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

Provjerite verziju Gita.

git --version
# git version 2.17.0

Instalirajte Node.js

Instalirajte Node.js korištenjem NodeSource APT spremišta za Node.js.

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

Provjerite verzije Node.js i NPM.

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

Instalirajte MongoDB

Koristit ćemo službena MongoDB spremišta koja se ažuriraju s najnovijim glavnim i manjim MongoDB izdanjima.

Instalirajte MongoDB Community Edition.

sudo apt install -y mongodb

Provjerite verziju.

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

Instalirajte i konfigurirajte Nginx

Instalirajte 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

Provjerite verziju.

sudo nginx -v
# nginx version: nginx/1.15.0

Omogućite i pokrenite Nginx.

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

Konfigurirajte Nginx kao obrnuti proxy za aplikaciju Wiki.js.

Pokrenite ga sudo vim /etc/nginx/conf.d/wiki.js.confi popunite ga osnovnom konfiguracijom obrnutog proxyja u nastavku.

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

}

Jedina stvar koju trebate promijeniti u gornjoj konfiguraciji je server_namedirektiva i potencijalno proxy_passdirektiva ako odlučite konfigurirati bilo koji drugi port osim 3000. Wiki.js 3000prema zadanim postavkama koristi port .

Provjerite konfiguraciju.

sudo nginx -t

Ponovno učitajte Nginx.

sudo systemctl reload nginx.service

Instalirajte Acme.sh klijent i nabavite certifikat Let's Encrypt (opcionalno)

Osiguravanje vašeg wikija pomoću HTTPSnije potrebno, ali će osigurati promet vaše stranice. Acme.sh je čista unix shell softver za dobivanje SSL certifikata od Let's Encrypt s nula ovisnosti.

Preuzmite i instalirajte 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 your_email@example.com
cd ~

Provjerite verziju.

/etc/letsencrypt/acme.sh --version

Nabavite RSA i ECDSA certifikate za wiki.example.comdomenu/naziv hosta.

# 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 your_email@example.com --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 your_email@example.com --ocsp-must-staple --keylength ec-256 

Nakon izvođenja gornjih naredbi, vaši će certifikati i ključevi biti u:

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

Nakon što smo dobili certifikate od Let's Encrypt, moramo konfigurirati Nginx da ih koristi.

Pokrenite sudo vim /etc/nginx/conf.d/wiki.js.confponovno i konfigurirajte Nginx kao HTTPSobrnuti 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;
    }

}

Provjerite konfiguraciju.

sudo nginx -t

Ponovno učitajte Nginx.

sudo systemctl reload nginx.service

Instalirajte Wiki.js

Napravite praznu korijensku mapu dokumenta u koju bi trebao biti instaliran Wiki.js.

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

Idite do korijenske mape dokumenta.

cd /var/www/wiki.example.com

Promijenite vlasništvo nad /var/www/wiki.example.commapom na korisnika johndoe.

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

Iz /var/www/wiki.example.commape pokrenite sljedeću naredbu da preuzmete i instalirate Wiki.js.

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

Da biste vidjeli trenutno instaliranu verziju Wiki.js, možete pokrenuti sljedeću naredbu.

node wiki --version
# 1.0.78

Nakon dovršetka instalacije, od vas će se tražiti da pokrenete čarobnjak za konfiguraciju.

Pokrenite čarobnjak za konfiguraciju.

node wiki configure

Ovo će vas obavijestiti da pregledate http://localhost:3000i konfigurirate Wiki.js. Ako imate Nginx ispred Wiki.js, možete otvoriti naziv svoje domene (npr. http://wiki.example.com) umjesto da idete na localhost.

Koristeći svoj web preglednik, idite do http://wiki.example.comi slijedite upute na zaslonu. Sve postavke unesene tijekom čarobnjaka za konfiguraciju spremaju se u config.ymldatoteku. Čarobnjak za konfiguraciju automatski će pokrenuti Wiki.js umjesto vas.

Instalirajte PM2

Prema zadanim postavkama, Wiki.js se neće automatski pokrenuti nakon ponovnog pokretanja sustava. Da bi se pokrenuo pri pokretanju, moramo postaviti PM2. PM2 dolazi u paketu s Wiki.js kao lokalni NPM modul, tako da ne moramo globalno instalirati PM2.

Recite PM2 da se konfigurira kao servis za pokretanje.

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

Konačno, spremite trenutnu konfiguraciju PM2.

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

Wiki.js radi kao pozadinski proces, koristeći PM2 kao upravitelj procesa.