Kako instalirati Wiki.js na FreeBSD 11

Wiki.js je besplatna i moderna wiki aplikacija otvorenog koda izgrađena na Node.js, MongoDB, Git i Markdown. Izvorni kod Wiki.js javno se nalazi na Githubu . Ovaj vodič će vam pokazati kako instalirati Wiki.js na novu instancu FreeBSD 11 Vultr koristeći Node.js, MongoDB, PM2, Nginx, Git i Acme.sh.

Zahtjevi

Zahtjevi za pokretanje Wiki.js su sljedeći:

• Node.js verzija 6.11.1 ili novija
• MongoDB verzija 3.2 ili novija
• Git verzija 2.7.4 ili novija
• Web poslužitelj kao što je Nginx, Apache, IIS, Caddy ili H2O. Ovaj vodič će koristiti Nginx.
• Git-kompatibilno spremište (javno ili privatno) Ovo nije obavezno
• Minimalno 512 MB RAM-a. Preporučljivo je koristiti stroj s najmanje 1 GB RAM-a.
• Ime domene sa A/ AAAApostavljenim zapisima. U ovom vodiču koristit ćemo wiki.example.comkao primjer domene.

Prije nego što počneš

Provjerite verziju FreeBSD-a.

uname -ro
# FreeBSD 11.2-RELEASE

Provjerite je li vaš FreeBSD sustav ažuriran.

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

Instalirajte sudo, vim, unzip, wget, git, bashi socatpakete ako nisu prisutni na vašem sustavu.

pkg install -y sudo vim unzip wget git bash socat

Izradite novi korisnički račun sa svojim željenim korisničkim imenom (koristit ćemo 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!

Pokrenite visudonaredbu i dekomentirajte %wheel ALL=(ALL) ALLredak kako biste omogućili članovima wheelgrupe da izvrše bilo koju naredbu.

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

Sada se prebacite na svog novostvorenog korisnika.

su - johndoe

NAPOMENA: Zamijenite johndoesvojim korisničkim imenom.

Postavite vremensku zonu.

sudo tzsetup

Instalirajte Node.js

Wiki.js zahtijeva Node.js 6.11.1 ili noviju, pa ćemo prvo morati instalirati odgovarajuću verziju Node.js.

Instalirajte Node.js i NPM.

sudo pkg install -y node8 npm-node8

Provjerite verzije.

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

Instalirajte MongoDB

Wiki.js koristi MongoDB kao motor baze podataka.

Instalirajte MongoDB.

sudo pkg install -y mongodb36

Provjerite verziju.

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

Omogućite i pokrenite MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Instalirajte Acme.sh i pribavite certifikat Let's Encrypt ( opcionalno )

Osiguravanje vašeg wikija HTTPS-om nije potrebno, ali je dobra praksa osigurati promet na web-lokaciji. Za dobivanje SSL certifikata od Let's Encrypt koristit ćemo Acme.sh klijent. Acme.sh je čista unix shell softver za dobivanje SSL certifikata od Let's Encrypt s nula ovisnosti. To ga čini vrlo laganim u usporedbi s nekim drugim klijentima Acme protokola koji zahtijevaju puno ovisnosti za uspješno izvođenje.

Preuzmite i instalirajte 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 ~

Provjerite acme.shverziju.

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

Dobiti RSA i ECDSA certifikate za 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

Nakon pokretanja gornjih naredbi, vaši će certifikati i ključevi biti u sljedećim direktorijima:

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

NAPOMENA: Ne zaboravite zamijeniti wiki.example.comimenom svoje domene.

Nakon što smo dobili certifikate od Let's Encrypt, moramo konfigurirati Nginx da ih iskoristi.

Instalirajte i konfigurirajte Nginx

Wiki.js može raditi bez ikakvog stvarnog web poslužitelja, no preporučljivo je staviti standardni web poslužitelj ispred njega. To osigurava da možete koristiti značajke kao što su SSL, više web-mjesta, predmemorija i druge. Koristit ćemo Nginx u ovom vodiču, ali bilo koji drugi poslužitelj će učiniti, samo ga trebate pravilno konfigurirati.

Instalirajte Nginx.

sudo pkg install -y nginx

Provjerite verziju.

nginx -v
# nginx version: nginx/1.14.0

Omogućite i pokrenite Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Konfigurirajte Nginx kao HTTPS (ako koristite SSL) obrnuti proxy za aplikaciju Wiki.js.

Pokrenite ga sudo vim /usr/local/etc/nginx/wiki.js.confi popunite ga osnovnom konfiguracijom obrnutog proxyja u nastavku.

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

}

Jedina stvar koju trebate promijeniti u gornjoj konfiguraciji je server_namedirektiva, a potencijalno i proxy_passdirektiva ako odlučite konfigurirati neki port koji nije 3000. Wiki.js 3000prema zadanim postavkama koristi port . Spremite datoteku i izađite s :+ W+Q

Sada moramo uključiti wiki.js.confdatoteku u glavnu nginx.confdatoteku.

Pokrenite sudo vim /usr/local/etc/nginx/nginx.confi dodajte sljedeći redak u http {}blok.

include wiki.js.conf;

Provjerite konfiguraciju.

sudo nginx -t

Ponovno učitajte Nginx.

sudo service nginx reload

Instalirajte Wiki.js

Napravite praznu korijensku mapu dokumenta u koju će biti instaliran Wiki.js.

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

Idite do korijenske mape dokumenta.

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

Promijenite vlasništvo nad /usr/local/www/wiki.example.commapom na korisnika johndoe.

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

Iz /usr/local/www/wiki.example.commape pokrenite sljedeće naredbe za preuzimanje i instaliranje 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

Možete pokrenuti sljedeću naredbu kako biste vidjeli trenutno instaliranu verziju Wiki.js.

node wiki --version
# 1.0.102

Nakon dovršetka instalacije, od vas će se tražiti da pokrenete čarobnjak za konfiguraciju.

Pokrenite čarobnjak za konfiguraciju pokretanjem.

node wiki configure

Ovo će vas obavijestiti da http://localhost:3000prijeđete na konfiguraciju Wiki.js. Ako imate Nginx ispred Wiki.js, onda to znači da možete otvoriti naziv svoje domene (npr. http://wiki.example.com) umjesto da idete na localhost.

Koristeći svoj web preglednik, idite do http://wiki.example.comi slijedite upute na zaslonu. Sve postavke unesene tijekom čarobnjaka za konfiguraciju spremaju se u config.ymldatoteku. Čarobnjak za konfiguraciju automatski će pokrenuti Wiki.js umjesto vas.

Instalirajte i postavite PM2 upravitelja procesa

Prema zadanim postavkama, Wiki.js se neće automatski pokrenuti nakon ponovnog pokretanja sustava. Da bi se pokrenuo pri pokretanju, moramo instalirati i postaviti PM2 upravitelj procesa.

Instalirajte PM2 globalno putem npm.

sudo npm install -g pm2

Provjerite verziju.

pm2 -v
# 3.2.2

Dođite do korijenske mape dokumenta ako već niste tamo i zaustavite Wiki.js.

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

Pokrenite Wiki.js putem PM2.

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

Proces popisa kojim upravlja PM2.

pm2 list

Recite PM2 da se konfigurira kao servis za pokretanje tako što će pokrenuti:

pm2 startup

Konačno, spremite trenutnu PM2 konfiguraciju pokretanjem naredbe:

pm2 save

Vaša Wiki.js instanca sada radi kao pozadinski proces, koristeći PM2 kao upravitelj procesa.