Hvernig á að setja upp Wiki.js á FreeBSD 11

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 FreeBSD 11 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 sem hér segir:

• Node.js útgáfa 6.11.1 eða nýrri
• MongoDB útgáfa 3.2 eða nýrri
• Git útgáfa 2.7.4 eða nýrri
• Vefþjónn eins og Nginx, Apache, IIS, Caddy eða H2O. Þessi handbók mun nota Nginx.
• Git-samhæft geymsla (opinber eða einkarekin) Þetta er valfrjálst
• Að lágmarki 512MB vinnsluminni. Það er mjög mælt með því að nota vél með að minnsta kosti 1GB af vinnsluminni.
• Lén með A/ AAAAskrár sett upp. Í þessari handbók munum við nota wiki.example.comsem dæmi um lén.

Áður en þú byrjar

Athugaðu FreeBSD útgáfuna.

uname -ro
# FreeBSD 11.2-RELEASE

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

freebsd-update fetch install
pkg update && pkg upgrade -y

Settu upp sudo, vim, unzip, wget, git, bashog socatpakka ef þeir eru ekki til staðar á kerfinu þínu.

pkg install -y sudo vim unzip wget git bash socat

Búðu til nýjan notandareikning með valinn notandanafni þínu (við munum nota johndoe).

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

Keyrðu visudoskipunina og afskrifaðu %wheel ALL=(ALL) ALLlínuna til að leyfa meðlimum wheelhópsins að framkvæma hvaða skipun sem er.

# Uncomment by removing the hash (#) sign
%wheel ALL=(ALL) ALL

Skiptu nú yfir í nýstofnaðan notanda þinn.

su - johndoe

ATH: Skiptu út johndoefyrir notendanafnið þitt.

Settu upp tímabeltið.

sudo tzsetup

Settu upp Node.js

Wiki.js krefst Node.js 6.11.1 eða nýrri, svo við þurfum fyrst að setja upp viðeigandi útgáfu af Node.js.

Settu upp Node.js og NPM.

sudo pkg install -y node8 npm-node8

Athugaðu útgáfurnar.

node -v && npm -v
# v8.12.0
# 6.4.1

Settu upp MongoDB

Wiki.js notar MongoDB sem gagnagrunnsvél.

Settu upp MongoDB.

sudo pkg install -y mongodb36

Athugaðu útgáfuna.

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

Virkjaðu og ræstu MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

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

Það er ekki nauðsynlegt að tryggja wiki með HTTPS, 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æktu og settu 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.8.0

Fáðu RSA og ECDSA vottorð fyrir wiki.example.com.

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength ec-256

Eftir að hafa keyrt skipanirnar hér að ofan verða vottorð þín og lyklar í eftirfarandi möppum:

• RSA: /etc/letsencrypt/wiki.example.com
• 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.

Settu upp og stilltu Nginx

Wiki.js getur keyrt án raunverulegs vefþjóns, hins vegar er mjög mælt með því að setja venjulegan vefþjón fyrir framan hann. Þetta tryggir að þú getir 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 pkg install -y nginx

Athugaðu útgáfuna.

nginx -v
# nginx version: nginx/1.14.0

Virkjaðu og ræstu Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

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

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

server {

  listen [::]:443 ssl http2;
  listen 443 ssl http2;
  listen [::]:80;
  listen 80;

  server_name wiki.example.com;

  charset utf-8;
  client_max_body_size 50M;

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

}

Það eina sem þú þarft að breyta í stillingunni hér að ofan er server_nametilskipunin og hugsanlega proxy_passtilskipunin ef þú ákveður að stilla einhverja aðra port en 3000. Wiki.js notar port 3000sjálfgefið. Vistaðu skrána og lokaðu með :+ W+Q

Nú þurfum við að setja wiki.js.confskrána inn í nginx.confaðalskrána.

Hlaupa sudo vim /usr/local/etc/nginx/nginx.confog bæta eftirfarandi línu við http {}blokkina.

include wiki.js.conf;

Athugaðu stillinguna.

sudo nginx -t

Endurhlaða Nginx.

sudo service nginx reload

Settu upp Wiki.js

Búðu til tóma skjalrótarmöppu þar sem Wiki.js verður sett upp.

sudo mkdir -p /usr/local/www/wiki.example.com

Farðu í rótarmöppuna skjalsins.

cd /usr/local/www/wiki.example.com

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

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

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

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

VERSION=$(curl -L -s -S https://beta.requarks.io/api/version/stable)
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/wiki-js.tar.gz | tar -f - -xz -C .
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/node_modules.tar.gz | tar -f - -xz -C .
cp -n config.sample.yml config.yml

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

node wiki --version
# 1.0.102

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

Settu upp og settu upp PM2 vinnslustjóra

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 og setja upp PM2 vinnslustjóra.

Settu upp PM2 á heimsvísu í gegnum npm.

sudo npm install -g pm2

Athugaðu útgáfuna.

pm2 -v
# 3.2.2

Farðu í rótarmöppuna þína ef þú ert ekki þegar þar og stöðvaðu Wiki.js.

cd /usr/local/www/wiki.example.com
node wiki stop

Ræstu Wiki.js í gegnum PM2.

pm2 start server/index.js --name "Wiki.js"

Listaferli stjórnað af PM2.

pm2 list

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

pm2 startup

Að lokum skaltu vista núverandi PM2 uppsetningu með því að keyra skipunina:

pm2 save

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