Kuidas installida Wiki.jsi FreeBSD 11-sse

Wiki.js on tasuta avatud lähtekoodiga kaasaegne vikirakendus, mis on üles ehitatud Node.js-ile, MongoDB-le, Gitile ja Markdownile. Wiki.js lähtekoodi majutatakse avalikult Githubis . See juhend näitab teile, kuidas installida Wiki.js värskele FreeBSD 11 Vultr eksemplarile, kasutades Node.js, MongoDB, PM2, Nginx, Git ja Acme.sh.

Nõuded

Nõuded Wiki.js-i käitamiseks on järgmised:

• Node.js versioon 6.11.1 või uuem
• MongoDB versioon 3.2 või uuem
• Giti versioon 2.7.4 või uuem
• Veebiserver, nagu Nginx, Apache, IIS, Caddy või H2O. See juhend kasutab Nginxit.
• Gitiga ühilduv hoidla (avalik või privaatne) See on valikuline
• Vähemalt 512 MB RAM. Soovitatav on kasutada masinat, millel on vähemalt 1 GB muutmälu.
• Domeeninimi A/ AAAAkirjetega seadistatud. Selles juhendis kasutame wiki.example.comnäidisdomeeni.

Enne alustamist

Kontrollige FreeBSD versiooni.

uname -ro
# FreeBSD 11.2-RELEASE

Veenduge, et teie FreeBSD süsteem on ajakohane.

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

Paigalda sudo, vim, unzip, wget, git, bashja socatpakette, kui nad ei ole praegu teie süsteemis.

pkg install -y sudo vim unzip wget git bash socat

Loo uus kasutajakonto oma eelistatud kasutajanimega (kasutame 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!

Käivitage visudokäsk ja tühjendage %wheel ALL=(ALL) ALLrea kommentaarid , et wheelrühma liikmed saaksid mis tahes käsku täita.

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

Nüüd lülituge oma vastloodud kasutajale.

su - johndoe

MÄRKUS. Asendage johndoeoma kasutajanimega.

Seadistage ajavöönd.

sudo tzsetup

Installige Node.js

Wiki.js nõuab versiooni Node.js 6.11.1 või uuemat, seega peame esmalt installima Node.js-i sobiva versiooni.

Installige Node.js ja NPM.

sudo pkg install -y node8 npm-node8

Kontrollige versioone.

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

Installige MongoDB

Wiki.js kasutab andmebaasimootorina MongoDB-d.

Installige MongoDB.

sudo pkg install -y mongodb36

Kontrolli versiooni.

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

Lubage ja käivitage MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Installige Acme.sh ja hankige Let's Encrypt sertifikaat ( valikuline )

Viki kaitsmine HTTPS-iga ei ole vajalik, kuid see on hea tava saidi liikluse kaitsmiseks. Let's Encrypti SSL-sertifikaadi saamiseks kasutame klienti Acme.sh. Acme.sh on puhas unixi kestatarkvara, mis võimaldab hankida Let's Encrypt SSL-sertifikaate ilma sõltuvusteta. See muudab selle väga kergeks võrreldes mõne teise Acme protokolli kliendiga, mis nõuavad edukaks töötamiseks palju sõltuvusi.

Laadige alla ja installige 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 ~

Kontrolli acme.shversiooni.

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

Hankige RSA ja ECDSA sertifikaadid 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

Pärast ülaltoodud käskude käivitamist asuvad teie sertifikaadid ja võtmed järgmistes kataloogides:

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

MÄRKUS. Ärge unustage asendada wiki.example.comoma domeeninimega.

Pärast Let's Encrypti sertifikaatide saamist peame Nginxi konfigureerima, et neid ära kasutada.

Installige ja konfigureerige Nginx

Wiki.js saab töötada ilma tegeliku veebiserverita, kuid soovitatav on selle ette panna tavaline veebiserver. See tagab, et saate kasutada selliseid funktsioone nagu SSL, mitu veebisaiti, vahemällu salvestamine ja muud. Me kasutame selles õpetuses Nginxit, kuid iga teine ​​server teeb seda, peate selle lihtsalt õigesti konfigureerima.

Installige Nginx.

sudo pkg install -y nginx

Kontrolli versiooni.

nginx -v
# nginx version: nginx/1.14.0

Lubage ja käivitage Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Seadistage Nginx rakenduse Wiki.js jaoks HTTPS-i (kui kasutate SSL-i) pöördpuhverserverina.

Käivitage sudo vim /usr/local/etc/nginx/wiki.js.confja sisestage see alloleva pöördpuhverserveri põhikonfiguratsiooniga.

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

}

Ainus asi, mida peate ülaltoodud konfiguratsioonis muutma, on server_namedirektiiv ja potentsiaalselt ka proxy_passdirektiiv, kui otsustate konfigureerida mõne muu pordi peale 3000. Wiki.js kasutab 3000vaikimisi porti . Salvestage fail ja väljuge nupuga :+ W+Q

Nüüd peame wiki.js.conffaili lisama nginx.confpõhifaili.

Käivitage sudo vim /usr/local/etc/nginx/nginx.confja lisage http {}plokki järgmine rida .

include wiki.js.conf;

Kontrollige konfiguratsiooni.

sudo nginx -t

Laadige Nginx uuesti.

sudo service nginx reload

Installige Wiki.js

Looge tühi dokumendi juurkaust, kuhu Wiki.js installitakse.

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

Liikuge dokumendi juurkausta.

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

Muutke /usr/local/www/wiki.example.comkausta omandiõigus kasutajaks johndoe.

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

Alates /usr/local/www/wiki.example.comkausta, käivitada käske alla laadida ja installida 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

Praegu installitud Wiki.js-i versiooni vaatamiseks saate käivitada järgmise käsu.

node wiki --version
# 1.0.102

Kui installimine on lõpetatud, palutakse teil käivitada konfiguratsiooniviisard.

Käivitage konfiguratsiooniviisard käivitades.

node wiki configure

See teavitab teid, et http://localhost:3000peaksite Wiki.js-i seadistamiseks navigeerima. Kui teil on Wiki.js-i ees Nginx, tähendab see, et saate kohaliku hosti http://wiki.example.comasemel avada oma domeeninime (nt ).

Liikuge oma veebibrauseriga lehele http://wiki.example.comja järgige ekraanil kuvatavaid juhiseid. Kõik konfiguratsiooniviisardi käigus sisestatud seaded salvestatakse config.ymlfaili. Konfiguratsiooniviisard käivitab teie eest automaatselt Wiki.js'i.

Installige ja seadistage PM2 protsessihaldur

Vaikimisi ei käivitu Wiki.js automaatselt pärast süsteemi taaskäivitamist. Selle käivitamiseks käivitamiseks peame installima ja seadistama PM2 protsessihalduri.

Installige PM2 globaalselt npm.

sudo npm install -g pm2

Kontrolli versiooni.

pm2 -v
# 3.2.2

Liikuge oma dokumendi juurkausta, kui te seal veel pole, ja peatage Wiki.js.

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

Käivitage Wiki.js PM2 kaudu.

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

PM2 hallatav loendiprotsess.

pm2 list

Öelge PM2-le, et ta konfigureeriks end käivitusteenusena, käivitades:

pm2 startup

Lõpuks salvestage praegune PM2 konfiguratsioon, käivitades käsu:

pm2 save

Teie Wiki.js-i eksemplar töötab nüüd taustaprotsessina, kasutades protsessihaldurina PM2.