Hvernig á að setja upp Wiki.js á Debian 9

Kröfur

Settu upp Git

Settu upp Node.js

Settu upp MongoDB

Settu upp og stilltu Nginx

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

Settu upp Wiki.js

Uppsetning PM2

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 Debian 9 Vultr tilviki með því að nota Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.

Kröfur

Node.js 6.9.0 eða nýrri
MongoDB 3.2 eða nýrri
Nginx
Git 2.7.4 eða nýrri
Git-samhæft geymsla (opinber eða einkarekin) ( valfrjálst )
Lágmark af 768MB RAM
Lén með A/ AAAAskrár sett upp

Athugaðu Debian útgáfuna.

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

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

apt update && apt upgrade -y

Settu upp nauðsynlega pakka.

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

Búðu til nýjan non-rootnotandareikning með sudoaðgangi og skiptu yfir í hann.

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

ATH : Skiptu út johndoefyrir notendanafnið þitt.

Settu upp tímabeltið.

sudo dpkg-reconfigure tzdata

Settu upp Git

Settu upp Git á Debian.

sudo apt install -y git

Staðfestu Git útgáfuna.

git --version
# git version 2.11.0

Settu upp Node.js

Settu upp Node.js með því að nota NodeSource APT geymslu fyrir Node.js.

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

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

node -v && npm -v
# v8.11.2
# 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. Við munum nota opinberu MongoDB geymslurnar fyrir uppsetningu.

Settu upp 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

Athugaðu útgáfuna.

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

Virkjaðu og ræstu MongoDB.

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

Settu upp og stilltu Nginx

Það 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.

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

Athugaðu útgáfuna.

sudo nginx -v
# nginx version: nginx/1.15.0

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 og fáðu Let's Encrypt vottorð (valfrjálst)

Securing your wiki with HTTPS is not necessary, but it is a good practice to secure your site traffic. In order to obtain an SSL certificate from Let's Encrypt we will use the Acme.sh client. Acme.sh is a pure unix shell software for obtaining SSL certificates from Let's Encrypt with zero dependencies. That makes it very lightweight in comparison to some other ACME protocol clients that require a lot of dependencies to run successfully.

Download and install 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 ~

Check the version.

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

Obtain RSA and ECDSA certificates for 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

NOTE: Don't forget to replace wiki.example.com with your domain name.

After running the above commands, your certificates and keys will be in the following directories.

For RSA: /etc/letsencrypt/wiki.example.com directory.
Fyrir ECC/ECDSA: /etc/letsencrypt/wiki.example.com_eccskrá.

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

}

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 sett upp.

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órann. 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.

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

Að lokum skaltu vista núverandi PM2 stillingu.

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

Wiki.js tilvikið þitt keyrir sem bakgrunnsferli og notar PM2 sem vinnslustjóra. Þú getur endurræst stýrikerfið með sudo rebootog athugað hvort Wiki.js byrjar eftir endurræsingu.

Skildu eftir athugasemd

Athugasemd *

Nafn *

Vefur

The Rise of Machines: Real World Applications of AI

Gervigreind er ekki í framtíðinni, hún er hér í nútímanum Í þessu bloggi Lestu hvernig gervigreindarforrit hafa haft áhrif á ýmsa geira.

DDOS árásir: Stutt yfirlit

Ertu líka fórnarlamb DDOS árása og ruglaður með forvarnaraðferðirnar? Lestu þessa grein til að leysa spurningar þínar.

Hefur þú einhvern tíma velt því fyrir þér hvernig tölvuþrjótar græða peninga?

Þú gætir hafa heyrt að tölvuþrjótar græða mikið af peningum, en hefur þú einhvern tíma velt því fyrir þér hvernig þeir vinna sér inn svona peninga? við skulum ræða.

Byltingarkenndar uppfinningar frá Google sem munu auðvelda lífi þínu.

Viltu sjá byltingarkenndar uppfinningar frá Google og hvernig þessar uppfinningar breyttu lífi hvers manns í dag? Lestu síðan til að blogga til að sjá uppfinningar frá Google.

Föstudagur Nauðsynlegur: Hvað varð um gervigreindardrifna bíla?

Hugmyndin um að sjálfkeyrandi bílar fari á göturnar með hjálp gervigreindar er draumur sem við höfum átt um tíma núna. En þrátt fyrir nokkur loforð eru þau hvergi sjáanleg. Lestu þetta blogg til að læra meira…

Tæknileg sérkenni: Fjarlæg framtíð mannlegrar siðmenningar?

Þar sem vísindin þróast hratt og taka yfir mikið af viðleitni okkar, eykst hættan á því að verða fyrir óútskýranlegri einstæðu. Lestu, hvað sérkenni gæti þýtt fyrir okkur.

Virkni Big Data Reference Architecture Layers

Lestu bloggið til að þekkja mismunandi lög í Big Data Architecture og virkni þeirra á einfaldasta hátt.

Þróun gagnageymslu – Infographic

Geymsluaðferðir gagna hafa verið að þróast gæti verið frá fæðingu gagna. Þetta blogg fjallar um þróun gagnageymslu á grundvelli upplýsingamynda.

6 ótrúlegir kostir þess að hafa snjall heimilistæki í lífi okkar

Í þessum stafræna heimi hafa snjallheimilistæki orðið afgerandi hluti af lífi. Hér eru nokkrir ótrúlegir kostir snjallheimatækja um hvernig þau gera líf okkar þess virði að lifa því og einfaldara.

macOS Catalina 10.15.4 viðbót uppfærsla veldur fleiri vandamálum en að leysa

Nýlega gaf Apple út macOS Catalina 10.15.4 viðbótaruppfærslu til að laga vandamál en svo virðist sem uppfærslan sé að valda fleiri vandamálum sem leiða til múrsteins á Mac vélum. Lestu þessa grein til að læra meira