Hvernig á að setja upp Wiki.js á Fedora 28

Wiki.js er ókeypis og opinn uppspretta, nútímalegt wikiforrit byggt á Node.js, MongoDB, Git og Markdown. Wiki.js frumkóði er hýst opinberlega á Github . Þessi handbók mun sýna þér hvernig á að setja upp Wiki.js á nýju Fedora 28 Vultr tilviki með því að nota Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.

Kröfur

Kröfur til að keyra Wiki.js eru eftirfarandi:

• Node.js útgáfa 6.9.0 eða nýrri
• MongoDB útgáfa 3.2 eða nýrri
• Vefþjónn eins og Nginx, Apache, IIS, Caddy eða H2O. Þessi handbók mun nota Nginx
• Git útgáfa 2.7.4 eða nýrri
• Git-samhæft geymsla (opinber eða einkarekin) Þetta er valfrjálst
• Að lágmarki 768MB vinnsluminni
• Lén með A/ AAAAskrár sett upp

Áður en þú byrjar

Athugaðu stýrikerfisútgáfuna.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

Búðu til nýjan notandareikning sem ekki er rót með sudo aðgangi og skiptu yfir í hann.

useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe

ATH: Skiptu út johndoefyrir notendanafnið þitt.

Gakktu úr skugga um að kerfið þitt sé uppfært.

sudo dnf check-upgrade || sudo dnf upgrade -y

Settu upp tímabeltið.

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

Settu upp nauðsynlega og gagnlega pakka.

sudo dnf install -y wget vim unzip bash-completion git

Til einföldunar skaltu slökkva á SELinux og Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Settu upp Node.js

Wiki.js krefst Node.js 6.9.0 eða nýrri, svo við þurfum fyrst að setja upp Node.js.

Settu upp Node.js.

sudo dnf install -y nodejs

Athugaðu Node.js og npm útgáfur.

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

Settu upp MongoDB

Wiki.js notar MongoDB sem gagnagrunnsvél. Samkvæmt því þurfum við að setja upp MongoDB á netþjóninum okkar.

Settu upp MongoDB.

sudo dnf install -y mongodb mongodb-server

Athugaðu MongoDB útgáfuna.

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

Virkjaðu og ræstu MongoDB.

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

Settu upp og stilltu Nginx

Wiki.js getur keyrt án raunverulegs vefþjóns (eins og Nginx eða Apache). Hins vegar er mjög mælt með því að setja venjulegan vefþjón fyrir framan Wiki.js. Þetta tryggir að þú getur notað eiginleika eins og SSL, margar vefsíður, skyndiminni og fleira. Við munum nota Nginx í þessari kennslu, en allir aðrir netþjónar munu gera það, þú þarft bara að stilla hann rétt.

Settu upp Nginx.

sudo dnf install -y nginx

Athugaðu útgáfuna.

nginx -v
# nginx version: nginx/1.12.1

Virkjaðu og ræstu Nginx.

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

Stilltu Nginx sem HTTPeða HTTPS(ef þú notar SSL) öfugt umboð fyrir Wiki.js forritið.

Keyrðu sudo vim /etc/nginx/conf.d/wiki.js.confog fylltu það út með grunnstillingu um öfugri proxy hér að neðan.

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

}

Það eina sem þú þarft að breyta í ofangreindri stillingu er server_nametilskipunin og hugsanlega proxy_passtilskipunin ef þú ákveður að stilla einhverja aðra höfn en 3000. Wiki.js notar port 3000sjálfgefið.

Athugaðu stillinguna.

sudo nginx -t

Endurhlaða Nginx.

sudo systemctl reload nginx.service

Settu upp Acme.sh viðskiptavin og fáðu Let's Encrypt vottorð (valfrjálst)

Það HTTPSer ekki nauðsynlegt að tryggja wiki þinn með , en það er góð æfing til að tryggja umferð á síðuna þína. Til þess að fá SSL vottorð frá Let's Encrypt munum við nota Acme.sh viðskiptavin. Acme.sh er hreinn unix skel hugbúnaður til að fá SSL vottorð frá Let's Encrypt með núll ósjálfstæði. Það gerir það mjög létt í samanburði við aðra ACME siðareglur viðskiptavini sem þurfa mikið af ósjálfstæði til að keyra með góðum árangri.

Sækja og setja upp 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 ~

Athugaðu acme.shútgáfuna.

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

Fáðu RSA og ECDSA vottorð fyrir 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 

Eftir að hafa keyrt ofangreindar skipanir verða vottorð þín og lyklar í:

• Fyrir RSA: /etc/letsencrypt/wiki.example.com
• Fyrir ECC/ECDSA: /etc/letsencrypt/wiki.example.com_ecc

ATH : Ekki gleyma að skipta wiki.example.comút fyrir lénið þitt.

Eftir að hafa fengið vottorð frá Let's Encrypt þurfum við að stilla Nginx til að nýta þau.

Keyrðu sudo vim /etc/nginx/conf.d/wiki.js.confaftur og stilltu Nginx sem HTTPSöfugt umboð.

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

}

Athugaðu stillinguna.

sudo nginx -t

Endurhlaða Nginx.

sudo systemctl reload nginx.service

Settu upp Wiki.js

Búðu til tóma skjalrótarmöppu þar sem Wiki.js ætti að vera uppsett.

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

Farðu í rótarmöppuna skjalsins.

cd /var/www/wiki.example.com

Breyttu eignarhaldi á /var/www/wiki.example.commöppu í notanda johndoe.

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

Í /var/www/wiki.example.commöppunni skaltu keyra eftirfarandi skipun til að hlaða niður og setja upp Wiki.js.

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

Þú getur keyrt eftirfarandi skipun til að skoða uppsetta útgáfu af Wiki.js.

node wiki --version
# 1.0.78

Þegar uppsetningunni er lokið verðurðu beðinn um að keyra uppsetningarhjálpina.

Ræstu uppsetningarhjálpina með því að keyra.

node wiki configure

Þetta mun láta þig vita um að fara á til http://localhost:3000að stilla Wiki.js. Ef þú ert með Nginx fyrir framan Wiki.js þýðir það að þú getur opnað lénið þitt (td http://wiki.example.com) í stað þess að fara á localhost.

Notaðu netvafrann þinn, farðu að http://wiki.example.comog fylgdu leiðbeiningunum á skjánum. Allar stillingar sem færðar voru inn í stillingarhjálpinni eru vistaðar í config.ymlskránni. Stillingarhjálpin mun sjálfkrafa ræsa Wiki.js fyrir þig.

Uppsetning PM2

Sjálfgefið er að Wiki.js ræsist ekki sjálfkrafa eftir endurræsingu kerfisins. Til þess að láta það byrja við ræsingu þurfum við að setja upp PM2 vinnslustjóra. PM2 kemur með Wiki.js sem staðbundinni NPM mát, svo við þurfum ekki að setja upp PM2 á heimsvísu.

Segðu PM2 að stilla sig sem ræsingarþjónustu með því að keyra:

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

Að lokum skaltu vista núverandi PM2 uppsetningu með því að keyra skipunina: /var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

Wiki.js tilvikið þitt keyrir sem bakgrunnsferli og notar PM2 sem vinnslustjóra.