Hvernig á að setja upp Wiki.js á Ubuntu 18.04

Kröfur

Settu upp Git

Settu upp Node.js

Settu upp MongoDB

Settu upp og stilltu Nginx

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

Settu upp Wiki.js

Settu upp PM2

Wiki.js er ókeypis og opinn uppspretta, nútímalegt wiki app byggt á Node.js , 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 á fersku Ubuntu 18.04 LTS Vultr dæmi með því að nota Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.

Kröfur

Kröfur til að keyra Wiki.js og klára þessa handbók eru sem hér segir:

• Node.js útgáfa 6.9.0 eða nýrri
• MongoDB útgáfa 3.2 eða nýrri
• Nginx
• Git útgáfa 2.7.4 eða nýrri
• Lágmark 768MB vinnsluminni
• Lén með A/ AAAAskrár sett upp

Athugaðu Ubuntu útgáfuna.

lsb_release -ds
# Ubuntu 18.04.4 LTS

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

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

sudo apt update && sudo apt upgrade -y

Settu upp nauðsynlega pakka.

sudo apt install -y build-essential apt-transport-https

Settu upp Git

Git 2.7.4 kemur foruppsett á Ubuntu netþjónaútgáfu, svo við þurfum ekki að setja það upp. Ef þú vilt setja upp nýrri útgáfu geturðu notað PPA frá þriðja aðila eða sett saman nýjustu útgáfuna af Git frá uppruna.

Þú getur staðfest uppsetta útgáfu af Git með því að keyra:

git --version
# git version 2.7.4

Ef þú vilt setja upp nýrri útgáfu af Git hugbúnaði geturðu notað eftirfarandi.

# Remove existing git package
sudo apt remove -y git
sudo apt-get install software-properties-common
sudo add-apt-repository -y ppa:git-core/ppa
sudo apt update && sudo apt upgrade -y
sudo apt install -y git

Staðfestu Git útgáfu.

git --version
# git version 2.17.0

Settu upp Node.js

Settu upp Node.js með því að nota NodeSource APT geymsluna 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

Við munum nota opinberu MongoDB geymslurnar , sem eru uppfærðar með nýjustu helstu og minniháttar MongoDB útgáfum.

Settu upp MongoDB Community Edition.

sudo apt install -y mongodb

Athugaðu útgáfuna.

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

Settu upp og stilltu Nginx

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/ubuntu/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/ubuntu/ $(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 ö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 fyrir utan 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ð mun tryggja umferð síðunnar þinnar. Acme.sh er hreinn unix skel hugbúnaður til að fá SSL vottorð frá Let's Encrypt með núll ósjálfstæði.

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 your_email@example.com
cd ~

Athugaðu útgáfuna.

/etc/letsencrypt/acme.sh --version

Fáðu RSA og ECDSA vottorð fyrir wiki.example.comlén/hýsingarheiti.

# 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 

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

• Fyrir RSA: /etc/letsencrypt/wiki.example.commöppuna.
• Fyrir ECC/ECDSA: skráin /etc/letsencrypt/wiki.example.com_ecc.

Eftir að hafa fengið vottorð frá Let's Encrypt þurfum við að stilla Nginx til að nota þ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 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öppunnar í notandann 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

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

node wiki --version
# 1.0.78

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

Ræstu uppsetningarhjálpina.

node wiki configure

Þetta mun láta þig vita um að vafra til http://localhost:3000að stilla Wiki.js. Ef þú ert með Nginx fyrir framan Wiki.js geturðu 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 eru inn í stillingarhjálpinni eru vistaðar í config.ymlskránni. Stillingarhjálpin mun sjálfkrafa ræsa Wiki.js fyrir þig.

Settu upp 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. 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 keyrir sem bakgrunnsferli og notar PM2 sem vinnslustjóra.