Kako instalirati Wiki.js na Debian 9

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

Zahtjevi

• Node.js 6.9.0 ili noviji
• MongoDB 3.2 ili noviji
• Nginx
• Git 2.7.4 ili noviji
• Git-kompatibilno spremište (javno ili privatno) ( opcionalno )
• Najmanje od 768MB RAM
• Ime domene sa A/ AAAApostavljenim zapisima

Provjerite verziju Debiana.

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

Provjerite je li vaš sustav ažuriran.

apt update && apt upgrade -y

Instalirajte potrebne pakete.

apt install -y build-essential apt-transport-https sudo curl wget dirmngr sudo

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

Instalirajte Git

Instalirajte Git na Debian.

sudo apt install -y git

Provjerite verziju Gita.

git --version
# git version 2.11.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

Wiki.js koristi MongoDB kao motor baze podataka. Prema tome, morat ćemo instalirati MongoDB na naš poslužitelj. Za instalaciju ćemo koristiti službena MongoDB repozitorija .

Instalirajte MongoDB Community Edition.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/3.6 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
sudo apt update
sudo apt install -y mongodb-org

Provjerite verziju.

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

Omogućite i pokrenite MongoDB.

sudo systemctl enable mongod.service
sudo systemctl start mongod.service

Instalirajte i konfigurirajte Nginx

Preporučljivo je staviti standardni web poslužitelj ispred Wiki.js. To osigurava da možete koristiti značajke kao što su SSL, više web-mjesta, predmemorija i još mnogo toga. Koristit ćemo Nginx u ovom vodiču, ali bilo koji drugi poslužitelj će učiniti, samo ga trebate pravilno konfigurirati.

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/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(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 HTTPili HTTPS(ako koristite SSL) obrnuti proxy za Wiki.js aplikaciju.

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, a potencijalno i proxy_passdirektiva ako odlučite konfigurirati neki 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 i pribavite certifikat Let's Encrypt (opcionalno)

Osiguravanje vašeg wikija pomoću HTTPSnije potrebno, ali je dobra praksa osigurati promet na vašoj web-lokaciji. Kako bismo dobili SSL certifikat od Let's Encrypt, koristit ćemo Acme.sh klijent. Acme.sh je čista unix shell softver za dobivanje SSL certifikata od Let's Encrypt s nula ovisnosti. To ga čini vrlo laganim u usporedbi s nekim drugim klijentima ACME protokola koji zahtijevaju puno ovisnosti za uspješno izvođenje.

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 [email protected]
cd ~

Provjerite verziju.

/etc/letsencrypt/acme.sh --version
# v2.7.9

Dobiti RSA i ECDSA certifikate za wiki.example.com.

# 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 

NAPOMENA : Ne zaboravite zamijeniti wiki.example.comimenom svoje domene.

Nakon izvođenja gornjih naredbi, vaši će certifikati i ključevi biti u sljedećim imenicima.

• 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 iskoristi.

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/example.com.key;
    # ECDSA
    ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/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

Možete pokrenuti sljedeću naredbu kako biste vidjeli trenutno instaliranu verziju Wiki.js.

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 pokretanjem.

node wiki configure

Ovo će vas obavijestiti da http://localhost:3000prijeđete na konfiguraciju Wiki.js. Ako imate Nginx ispred Wiki.js, onda to znači da 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.

Postavljanje PM2

Prema zadanim postavkama, Wiki.js se neće automatski pokrenuti nakon ponovnog pokretanja sustava. Da bi se pokrenuo pri pokretanju, moramo postaviti PM2 upravitelj procesa. 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

Vaša Wiki.js instanca radi kao pozadinski proces, koristeći PM2 kao upravitelj procesa. Možete ponovno pokrenuti svoj OS sudo rebooti provjeriti pokreće li se Wiki.js nakon ponovnog pokretanja.