Kaip įdiegti Wiki.js FreeBSD 11

Wiki.js yra nemokama atvirojo kodo moderni wiki programa, sukurta naudojant Node.js, MongoDB, Git ir Markdown. Wiki.js šaltinio kodas viešai priglobtas Github . Šis vadovas parodys, kaip įdiegti Wiki.js naujame FreeBSD 11 Vultr egzemplioriuje naudojant Node.js, MongoDB, PM2, Nginx, Git ir Acme.sh.

Reikalavimai

Reikalavimai norint paleisti Wiki.js yra tokie:

• Node.js 6.11.1 arba naujesnė versija
• MongoDB 3.2 ar naujesnė versija
• Git versija 2.7.4 arba naujesnė
• Žiniatinklio serveris, pvz., Nginx, Apache, IIS, Caddy arba H2O. Šiame vadove bus naudojamas Nginx.
• Su Git suderinama saugykla (vieša arba privati) Tai neprivaloma
• Mažiausiai 512 MB RAM. Labai rekomenduojama naudoti įrenginį, kuriame yra bent 1 GB RAM.
• Domeno vardas su nustatyta A/ AAAAįrašais. Šiame vadove naudosime wiki.example.comkaip pavyzdinį domeną.

Prieš tau pradedant

Patikrinkite FreeBSD versiją.

uname -ro
# FreeBSD 11.2-RELEASE

Įsitikinkite, kad jūsų FreeBSD sistema yra atnaujinta.

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

Įdiekite sudo, vim, unzip, wget, git, bashir socatpaketai, jei jų nėra jūsų sistemoje.

pkg install -y sudo vim unzip wget git bash socat

Sukurkite naują vartotojo paskyrą su pageidaujamu vartotojo vardu (naudosime 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!

Vykdykite visudokomandą ir panaikinkite %wheel ALL=(ALL) ALLeilutės komentarą, kad wheelgrupės nariai galėtų vykdyti bet kurią komandą.

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

Dabar pereikite prie naujai sukurto vartotojo.

su - johndoe

PASTABA: pakeiskite johndoesavo vartotojo vardu.

Nustatykite laiko juostą.

sudo tzsetup

Įdiekite Node.js

Wiki.js reikalinga Node.js 6.11.1 arba naujesnė versija, todėl pirmiausia turėsime įdiegti atitinkamą Node.js versiją.

Įdiekite Node.js ir NPM.

sudo pkg install -y node8 npm-node8

Patikrinkite versijas.

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

Įdiekite MongoDB

Wiki.js naudoja MongoDB kaip duomenų bazės variklį.

Įdiekite MongoDB.

sudo pkg install -y mongodb36

Patikrinkite versiją.

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

Įgalinkite ir paleiskite MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Įdiekite Acme.sh ir gaukite Let's Encrypt sertifikatą ( neprivaloma )

Apsaugoti wiki naudojant HTTPS nebūtina, tačiau tai yra gera praktika siekiant apsaugoti svetainės srautą. Norėdami gauti SSL sertifikatą iš Let's Encrypt, naudosime Acme.sh klientą. Acme.sh yra gryna unix apvalkalo programinė įranga, skirta gauti SSL sertifikatus iš Let's Encrypt be jokių priklausomybių. Dėl to jis yra labai lengvas, palyginti su kai kuriais kitais „Acme“ protokolo klientais, kuriems norint sėkmingai veikti, reikia daug priklausomybių.

Atsisiųskite ir įdiekite 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 ~

Patikrinkite acme.shversiją.

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

Gaukite RSA ir ECDSA sertifikatus 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

Paleidus aukščiau pateiktas komandas, jūsų sertifikatai ir raktai bus šiuose kataloguose:

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

PASTABA: nepamirškite pakeisti wiki.example.comsavo domeno pavadinimu.

Gavę sertifikatus iš Let's Encrypt, turime sukonfigūruoti Nginx, kad galėtume jais pasinaudoti.

Įdiekite ir sukonfigūruokite „Nginx“.

Wiki.js gali veikti be jokio tikrojo žiniatinklio serverio, tačiau labai rekomenduojama priešais jį įdėti standartinį žiniatinklio serverį. Tai užtikrina, kad galite naudoti tokias funkcijas kaip SSL, kelios svetainės, talpyklos kaupimas ir kt. Šioje pamokoje naudosime Nginx, bet tiks bet kuris kitas serveris, tereikia jį tinkamai sukonfigūruoti.

Įdiekite „Nginx“.

sudo pkg install -y nginx

Patikrinkite versiją.

nginx -v
# nginx version: nginx/1.14.0

Įgalinkite ir paleiskite „Nginx“.

sudo sysrc nginx_enable=yes
sudo service nginx start

Konfigūruokite Nginx kaip HTTPS (jei naudojate SSL) atvirkštinį tarpinį serverį Wiki.js programai.

Paleiskite sudo vim /usr/local/etc/nginx/wiki.js.confir užpildykite jį naudodami toliau pateiktą pagrindinę atvirkštinio tarpinio serverio konfigūraciją.

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

}

Vienintelis dalykas, kurį reikia pakeisti aukščiau pateiktoje konfigūroje, yra server_namedirektyva ir galbūt proxy_passdirektyva, jei nuspręsite sukonfigūruoti kitą prievadą nei 3000. Wiki.js 3000pagal numatytuosius nustatymus naudoja prievadą . Išsaugokite failą ir išeikite su :+ W+Q

Dabar turime įtraukti wiki.js.conffailą į pagrindinį nginx.conffailą.

Vykdykite sudo vim /usr/local/etc/nginx/nginx.confir pridėkite šią eilutę prie http {}bloko.

include wiki.js.conf;

Patikrinkite konfigūraciją.

sudo nginx -t

Iš naujo įkelti Nginx.

sudo service nginx reload

Įdiekite Wiki.js

Sukurkite tuščią dokumento šakninį aplanką, kuriame bus įdiegtas Wiki.js.

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

Eikite į dokumento šakninį aplanką.

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

Pakeiskite /usr/local/www/wiki.example.comaplanko nuosavybės teisę į vartotoją johndoe.

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

Iš /usr/local/www/wiki.example.comaplanko paleiskite šias komandas, kad atsisiųstumėte ir įdiegtumėte 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

Norėdami peržiūrėti šiuo metu įdiegtą Wiki.js versiją, galite paleisti šią komandą.

node wiki --version
# 1.0.102

Kai diegimas bus baigtas, būsite paraginti paleisti konfigūracijos vedlį.

Paleiskite konfigūracijos vedlį paleisdami.

node wiki configure

Tai jums praneš, kad reikia pereiti prie http://localhost:3000Wiki.js konfigūravimo. Jei turite Nginx prieš Wiki.js, tai reiškia, kad galite atidaryti savo domeno pavadinimą (pvz., http://wiki.example.com), o ne eiti į localhost.

Naudodami žiniatinklio naršyklę eikite į http://wiki.example.comir vykdykite ekrane pateikiamas instrukcijas. Visi konfigūracijos vedlio metu įvesti nustatymai išsaugomi config.ymlfaile. Konfigūracijos vedlys automatiškai paleis Wiki.js už jus.

Įdiekite ir nustatykite PM2 proceso tvarkyklę

Pagal numatytuosius nustatymus Wiki.js nebus paleistas automatiškai po sistemos perkrovimo. Kad jis prasidėtų įkrovos metu, turime įdiegti ir nustatyti PM2 proceso tvarkyklę.

Įdiekite PM2 visame pasaulyje per npm.

sudo npm install -g pm2

Patikrinkite versiją.

pm2 -v
# 3.2.2

Eikite į savo dokumento šakninį aplanką, jei ten dar nesate, ir sustabdykite Wiki.js.

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

Paleiskite Wiki.js per PM2.

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

PM2 valdomas sąrašo procesas.

pm2 list

Nurodykite PM2 konfigūruoti save kaip paleisties paslaugą, paleisdami:

pm2 startup

Galiausiai išsaugokite dabartinę PM2 konfigūraciją vykdydami komandą:

pm2 save

Jūsų Wiki.js egzempliorius dabar veikia kaip foninis procesas, naudojant PM2 kaip proceso tvarkyklę.