Zahtjevi
Prije nego što počneš
Instalirajte Node.js
Instalirajte MongoDB
Instalirajte i konfigurirajte Nginx
Instalirajte Acme.sh klijent i nabavite certifikat Let's Encrypt (opcionalno)
Instalirajte Wiki.js
Postavljanje PM2
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 Fedora 28 Vultr koristeći Node.js, MongoDB, PM2, Nginx, Git i Acme.sh.
Zahtjevi
Zahtjevi za pokretanje Wiki.js su sljedeći:
- Node.js verzija 6.9.0 ili novija
- MongoDB verzija 3.2 ili novija
- Web poslužitelj kao što je Nginx, Apache, IIS, Caddy ili H2O. Ovaj vodič će koristiti Nginx
- Git verzija 2.7.4 ili novija
- Git-kompatibilno spremište (javno ili privatno) Ovo nije obavezno
- Najmanje 768 MB RAM-a
- Ime domene sa
A/ AAAApostavljenim zapisima
Prije nego što počneš
Provjerite verziju OS-a.
cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)
Stvorite novi nekorijenski korisnički račun sa sudo pristupom i prebacite se na njega.
useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe
NAPOMENA: Zamijenite johndoesvojim korisničkim imenom.
Provjerite je li vaš sustav ažuriran.
sudo dnf check-upgrade || sudo dnf upgrade -y
Postavite vremensku zonu.
timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'
Instalirajte potrebne i korisne pakete.
sudo dnf install -y wget vim unzip bash-completion git
Radi jednostavnosti, onemogućite SELinux i vatrozid.
sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld
Instalirajte Node.js
Wiki.js zahtijeva Node.js 6.9.0 ili noviji, pa ćemo prvo morati instalirati Node.js.
Instalirajte Node.js.
sudo dnf install -y nodejs
Provjerite verzije Node.js i npm.
node -v && npm -v
# v8.11.3
# 5.6.0
Instalirajte MongoDB
Wiki.js koristi MongoDB kao motor baze podataka. U skladu s tim, morat ćemo instalirati MongoDB na naš poslužitelj.
Instalirajte MongoDB.
sudo dnf install -y mongodb mongodb-server
Provjerite verziju MongoDB.
mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.3
# db version v3.6.3
Omogućite i pokrenite MongoDB.
sudo systemctl enable mongod.service
sudo systemctl start mongod.service
Wiki.js može raditi bez stvarnog web poslužitelja (kao što je Nginx ili Apache). Međutim, 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 druge. Koristit ćemo Nginx u ovom vodiču, ali bilo koji drugi poslužitelj će učiniti, samo ga trebate pravilno konfigurirati.
Instalirajte Nginx.
sudo dnf install -y nginx
Provjerite verziju.
nginx -v
# nginx version: nginx/1.12.1
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 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, a potencijalno i proxy_passdirektiva ako odlučite konfigurirati neki port koji nije 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 je dobra praksa osigurati promet na vašoj web-lokaciji. Za dobivanje SSL certifikata 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 your_email@example.com
cd ~
Provjerite acme.shverziju.
/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 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.com
- Za ECC/ECDSA:
/etc/letsencrypt/wiki.example.com_ecc
NAPOMENA : Ne zaboravite zamijeniti wiki.example.comimenom svoje domene.
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/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 treba instalirati 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 tako što će pokrenuti:
/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup
Konačno, spremite trenutnu PM2 konfiguraciju pokretanjem naredbe: /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.