Cum se instalează Wiki.js pe FreeBSD 11

• cerinţe
• Înainte de a începe
• Instalați Node.js
• Instalați MongoDB
• Instalați Acme.sh și obțineți un certificat Let's Encrypt (opțional)
• Instalați și configurați Nginx
• Instalați Wiki.js
• Instalați și configurați managerul de proces PM2

Wiki.js este o aplicație wiki modernă, gratuită și deschisă, construită pe Node.js, MongoDB, Git și Markdown. Codul sursă Wiki.js este găzduit public pe Github . Acest ghid vă va arăta cum instalați Wiki.js pe o nouă instanță FreeBSD 11 Vultr folosind Node.js, MongoDB, PM2, Nginx, Git și Acme.sh.

cerinţe

Cerințele pentru a rula Wiki.js sunt următoarele:

• Node.js versiunea 6.11.1 sau mai recentă
• MongoDB versiunea 3.2 sau o versiune ulterioară
• Git versiunea 2.7.4 sau mai recentă
• Un server web precum Nginx, Apache, IIS, Caddy sau H2O. Acest ghid va folosi Nginx.
• Un depozit conform Git (public sau privat) Acesta este opțional
• Minim RAM 512 MB. Este recomandat să folosiți o mașină cu cel puțin 1 GB RAM.
• Nume de domeniu cu A/ AAAAînregistrări configurate. În acest ghid vom folosi wiki.example.comca domeniu de exemplu.

Înainte de a începe

Verificați versiunea FreeBSD.

uname -ro
# FreeBSD 11.2-RELEASE

Asigurați-vă că sistemul dvs. FreeBSD este actualizat.

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

Instalați sudo, vim, unzip, wget, git, bashși socatpachete în cazul în care nu sunt prezente pe sistemul dumneavoastră.

pkg install -y sudo vim unzip wget git bash socat

Creați un cont de utilizator nou cu numele de utilizator preferat (vom folosi 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!

Rulați visudocomanda și dezarhivați %wheel ALL=(ALL) ALLlinia, pentru a permite membrilor wheelgrupului să execute orice comandă.

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

Acum, treceți la utilizatorul dvs. recent creat.

su - johndoe

NOTĂ: Înlocuiți johndoecu numele de utilizator.

Setați fusul orar.

sudo tzsetup

Instalați Node.js

Wiki.js necesită Node.js 6.11.1 sau o versiune ulterioară, deci va trebui mai întâi să instalăm versiunea corespunzătoare a Node.js.

Instalați Node.js și NPM.

sudo pkg install -y node8 npm-node8

Verificați versiunile.

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

Instalați MongoDB

Wiki.js folosește MongoDB ca motor de bază de date.

Instalați MongoDB.

sudo pkg install -y mongodb36

Verificați versiunea.

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

Activați și porniți MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Instalați Acme.sh și obțineți un certificat Let's Encrypt ( opțional )

Securizarea wiki-ului dvs. cu HTTPS nu este necesară, dar este o practică bună pentru a vă asigura traficul site-ului. Pentru a obține un certificat SSL de la Let's Encrypt, vom folosi clientul Acme.sh. Acme.sh este un software pur shell unix pentru obținerea certificatelor SSL de la Let's Encrypt cu zero dependențe. Acest lucru îl face foarte ușor în comparație cu alți clienți ai protocolului Acme care necesită multe dependențe pentru a rula cu succes.

Descărcați și instalați 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 ~

Verificați acme.shversiunea.

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

Obțineți certificate RSA și ECDSA pentru 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

După executarea comenzilor de mai sus, certificatele și cheile dvs. vor fi în următoarele directoare:

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

NOTĂ: Nu uitați să înlocuiți wiki.example.comcu numele dvs. de domeniu.

După obținerea certificatelor de la Let's Encrypt, trebuie să configuram Nginx pentru a profita de ele.

Instalați și configurați Nginx

Wiki.js poate rula fără niciun server web propriu-zis, însă este foarte recomandat să puneți un server web standard în fața acestuia. Acest lucru vă asigură că puteți utiliza funcții precum SSL, mai multe site-uri web, memorie în cache și altele. Vom folosi Nginx în acest tutorial, dar orice alt server o va face, trebuie doar să îl configurați corect.

Instalați Nginx.

sudo pkg install -y nginx

Verificați versiunea.

nginx -v
# nginx version: nginx/1.14.0

Activați și porniți Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Configurați Nginx ca un HTTPS (dacă utilizați SSL) proxy invers pentru aplicația Wiki.js.

Rulați sudo vim /usr/local/etc/nginx/wiki.js.confși populați-l cu configurația de bază a proxy-ului invers de mai jos.

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

}

Singurul lucru pe care trebuie să îl schimbați în configurația de mai sus este server_namedirectiva și, eventual, proxy_passdirectiva dacă decideți să configurați un alt port decât 3000. Wiki.js utilizează 3000implicit portul . Salvați fișierul și ieșiți cu :+ W+Q

Acum trebuie să includem wiki.js.conffișierul în nginx.conffișierul principal .

Rulați sudo vim /usr/local/etc/nginx/nginx.confși adăugați următoarea linie la http {}bloc.

include wiki.js.conf;

Verificați configurația.

sudo nginx -t

Reîncărcați Nginx.

sudo service nginx reload

Instalați Wiki.js

Creați un folder rădăcină document gol unde va fi instalat Wiki.js.

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

Navigați la folderul rădăcină al documentului.

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

Schimbați proprietatea /usr/local/www/wiki.example.comfolderului în utilizator johndoe.

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

Din /usr/local/www/wiki.example.comfolder, executați următoarele comenzi pentru a descărca și instala 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

Puteți rula următoarea comandă pentru a vizualiza versiunea actuală instalată de Wiki.js.

node wiki --version
# 1.0.102

După terminarea instalării, vi se va solicita să executați asistentul de configurare.

Porniți asistentul de configurare rulând.

node wiki configure

Acest lucru vă va notifica să navigați pentru http://localhost:3000a configura Wiki.js. Dacă aveți Nginx în fața Wiki.js, atunci înseamnă că puteți deschide numele de domeniu (de exemplu http://wiki.example.com) în loc să mergeți la localhost.

Utilizând browserul dvs. web, navigați la http://wiki.example.comși urmați instrucțiunile de pe ecran. Toate setările introduse în timpul asistentului de configurare sunt salvate în config.ymlfișier. Expertul de configurare va porni automat Wiki.js pentru dvs.

Instalați și configurați managerul de proces PM2

În mod implicit, Wiki.js nu va porni automat după repornirea sistemului. Pentru a porni la pornire, trebuie să instalăm și să instalăm managerul de proces PM2.

Instalați PM2 la nivel global prin intermediul npm.

sudo npm install -g pm2

Verificați versiunea.

pm2 -v
# 3.2.2

Navigați în folderul rădăcină al documentului dacă nu sunteți deja acolo și opriți Wiki.js.

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

Porniți Wiki.js prin PM2.

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

Listă proces gestionat de PM2.

pm2 list

Spuneți PM2 să se configureze ca serviciu de pornire rulând:

pm2 startup

În cele din urmă, salvați configurația curentă PM2 rulând comanda:

pm2 save

Instanta dvs. Wiki.js rulează acum ca proces de fundal, folosind PM2 ca manager de proces.