Kërkesat
Perpara se te fillosh
Instaloni Node.js
Instaloni MongoDB
Instaloni dhe konfiguroni Nginx
Instaloni klientin Acme.sh dhe merrni certifikatën Let's Encrypt (opsionale)
Instaloni Wiki.js
Konfiguro PM2
Wiki.js është një aplikacion modern wiki falas dhe me burim të hapur i ndërtuar në Node.js, MongoDB, Git dhe Markdown. Kodi burimor i Wiki.js është i pritur publikisht në Github . Ky udhëzues do t'ju tregojë se si të instaloni Wiki.js në një shembull të ri Fedora 28 Vultr duke përdorur Node.js, MongoDB, PM2, Nginx, Git dhe Acme.sh.
Kërkesat
Kërkesat për të ekzekutuar Wiki.js janë si më poshtë:
- Node.js versioni 6.9.0 ose më i ri
- Versioni i MongoDB 3.2 ose më i ri
- Një server në internet si Nginx, Apache, IIS, Caddy ose H2O. Ky udhëzues do të përdorë Nginx
- Versioni Git 2.7.4 ose më i ri
- Një depo e përputhshme me Git (publike ose private) Kjo është fakultative
- Një minimum prej 768 MB RAM
- Emri i domenit me
A
/ AAAA
konfigurimin e regjistrimeve
Perpara se te fillosh
Kontrolloni versionin e OS.
cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)
Krijoni një llogari të re përdoruesi jo-root me akses sudo dhe kaloni në të.
useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe
SHËNIM: Zëvendësojeni johndoe
me emrin tuaj të përdoruesit.
Sigurohuni që sistemi juaj të jetë i përditësuar.
sudo dnf check-upgrade || sudo dnf upgrade -y
Vendosni zonën kohore.
timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'
Instaloni paketat e nevojshme dhe të dobishme.
sudo dnf install -y wget vim unzip bash-completion git
Për thjeshtësi, çaktivizoni SELinux dhe Firewall.
sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld
Instaloni Node.js
Wiki.js kërkon Node.js 6.9.0 ose version më të ri, kështu që fillimisht do të na duhet të instalojmë Node.js.
Instaloni Node.js.
sudo dnf install -y nodejs
Kontrolloni versionet Node.js dhe npm.
node -v && npm -v
# v8.11.3
# 5.6.0
Instaloni MongoDB
Wiki.js përdor MongoDB si një motor bazë të dhënash. Sipas kësaj, ne do të duhet të instalojmë MongoDB në serverin tonë.
Instaloni MongoDB.
sudo dnf install -y mongodb mongodb-server
Kontrolloni versionin MongoDB.
mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.3
# db version v3.6.3
Aktivizo dhe nis MongoDB.
sudo systemctl enable mongod.service
sudo systemctl start mongod.service
Wiki.js mund të funksionojë pa ndonjë server aktual të internetit (si Nginx ose Apache). Megjithatë, rekomandohet shumë që të vendosni një ueb server standard përpara Wiki.js. Kjo siguron që ju të mund të përdorni veçori si SSL, uebfaqe të shumta, memorie dhe të tjera. Ne do të përdorim Nginx në këtë tutorial, por çdo server tjetër do ta bëjë këtë, ju vetëm duhet ta konfiguroni atë siç duhet.
Instaloni Nginx.
sudo dnf install -y nginx
Kontrolloni versionin.
nginx -v
# nginx version: nginx/1.12.1
Aktivizo dhe nis Nginx.
sudo systemctl enable nginx.service
sudo systemctl start nginx.service
Konfiguro Nginx si një përfaqësues të kundërt HTTP
ose HTTPS
(nëse përdorni SSL) për aplikacionin Wiki.js.
Ekzekutoni sudo vim /etc/nginx/conf.d/wiki.js.conf
dhe plotësoni atë me konfigurimin bazë të përfaqësuesit të kundërt më poshtë.
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;
}
}
E vetmja gjë që duhet të ndryshoni në konfigurimin e mësipërm është server_name
direktiva, dhe potencialisht proxy_pass
direktiva nëse vendosni të konfiguroni një port tjetër përveç 3000
. Wiki.js përdor portin si 3000
parazgjedhje.
Kontrolloni konfigurimin.
sudo nginx -t
Rifresko Nginx.
sudo systemctl reload nginx.service
Instaloni klientin Acme.sh dhe merrni certifikatën Let's Encrypt (opsionale)
Sigurimi i wiki-t tuaj me HTTPS
nuk është i nevojshëm, por është një praktikë e mirë për të siguruar trafikun e faqes suaj. Për të marrë një certifikatë SSL nga Let's Encrypt ne do të përdorim klientin Acme.sh. Acme.sh është një softuer i pastër i guaskës unix për marrjen e certifikatave SSL nga Let's Encrypt me zero varësi. Kjo e bën atë shumë të lehtë në krahasim me disa klientë të tjerë të protokollit ACME që kërkojnë shumë varësi për të ekzekutuar me sukses.
Shkarkoni dhe instaloni 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 ~
Kontrolloni acme.sh
versionin.
/etc/letsencrypt/acme.sh --version
# v2.7.9
Merrni certifikatat RSA dhe ECDSA për 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
Pas ekzekutimit të komandave të mësipërme, certifikatat dhe çelësat tuaj do të jenë në:
- Për RSA:
/etc/letsencrypt/wiki.example.com
- Për ECC/ECDSA:
/etc/letsencrypt/wiki.example.com_ecc
SHËNIM : Mos harroni të zëvendësoni wiki.example.com
me emrin e domain.
Pas marrjes së certifikatave nga Let's Encrypt, duhet të konfigurojmë Nginx për të përfituar prej tyre.
Ekzekutoni sudo vim /etc/nginx/conf.d/wiki.js.conf
përsëri dhe konfiguroni Nginx si një HTTPS
përfaqësues të kundërt.
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;
}
}
Kontrolloni konfigurimin.
sudo nginx -t
Rifresko Nginx.
sudo systemctl reload nginx.service
Instaloni Wiki.js
Krijoni një dosje të zbrazët rrënjësore të dokumentit, ku duhet të instalohet Wiki.js.
sudo mkdir -p /var/www/wiki.example.com
Navigoni te dosja rrënjë e dokumentit.
cd /var/www/wiki.example.com
Ndrysho pronësinë e /var/www/wiki.example.com
dosjes në përdorues johndoe
.
sudo chown -R johndoe:johndoe /var/www/wiki.example.com
Nga /var/www/wiki.example.com
dosja, ekzekutoni komandën e mëposhtme për të shkarkuar dhe instaluar Wiki.js.
curl -sSo- https://wiki.js.org/install.sh | bash
Ju mund të ekzekutoni komandën e mëposhtme për të parë versionin e instaluar aktualisht të Wiki.js.
node wiki --version
# 1.0.78
Pasi të përfundojë instalimi, do t'ju kërkohet të ekzekutoni magjistarin e konfigurimit.
Nisni magjistarin e konfigurimit duke ekzekutuar.
node wiki configure
Kjo do t'ju njoftojë për të lundruar për http://localhost:3000
të konfiguruar Wiki.js. Nëse keni Nginx përpara Wiki.js, atëherë kjo do të thotë që ju mund të hapni emrin e domenit tuaj (p.sh. http://wiki.example.com
) në vend që të shkoni te localhost
.
Duke përdorur shfletuesin tuaj të internetit, lundroni http://wiki.example.com
dhe ndiqni udhëzimet në ekran. Të gjitha cilësimet e futura gjatë magjistarit të konfigurimit ruhen në config.yml
skedar. Magjistari i konfigurimit do të nisë automatikisht Wiki.js për ju.
Konfiguro PM2
Si parazgjedhje, Wiki.js nuk do të fillojë automatikisht pas një rindezjeje të sistemit. Për ta bërë atë të fillojë në boot, ne duhet të konfigurojmë menaxherin e procesit PM2. PM2 vjen i bashkuar me Wiki.js si një modul lokal NPM, kështu që nuk kemi nevojë të instalojmë PM2 globalisht.
Thuaji PM2 të konfigurojë veten si një shërbim fillestar duke ekzekutuar:
/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup
Më në fund, ruani konfigurimin aktual PM2 duke ekzekutuar komandën: /var/www/wiki.example.com/node_modules/pm2/bin/pm2 save
Shembulli juaj Wiki.js ekzekutohet si një proces sfondi, duke përdorur PM2 si menaxherin e tij të procesit.