Hvordan installere Wiki.js på FreeBSD 11

Wiki.js er en gratis og åpen kildekode, moderne wiki-app bygget på Node.js, MongoDB, Git og Markdown. Wiki.js kildekode er offentlig vert på Github . Denne guiden viser deg hvordan du installerer Wiki.js på en fersk FreeBSD 11 Vultr-instans ved å bruke Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.

Krav

Kravene for å kjøre Wiki.js er som følger:

• Node.js versjon 6.11.1 eller nyere
• MongoDB versjon 3.2 eller nyere
• Git versjon 2.7.4 eller nyere
• En webserver som Nginx, Apache, IIS, Caddy eller H2O. Denne veiledningen vil bruke Nginx.
• Et Git-kompatibelt depot (offentlig eller privat) Dette er valgfritt
• Minst 512 MB RAM. Det anbefales sterkt å bruke en maskin med minst 1 GB RAM.
• Domenenavn med A/ AAAAposter satt opp. I denne guiden vil vi bruke wiki.example.comsom eksempeldomene.

Før du begynner

Sjekk FreeBSD-versjonen.

uname -ro
# FreeBSD 11.2-RELEASE

Sørg for at ditt FreeBSD-system er oppdatert.

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

Installer sudo, vim, unzip, wget, git, bashog socatpakker hvis de ikke finnes på systemet.

pkg install -y sudo vim unzip wget git bash socat

Opprett en ny brukerkonto med ditt foretrukne brukernavn (vi bruker 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!

Kjør visudokommandoen og fjern kommentarfeltet for %wheel ALL=(ALL) ALLå la medlemmer av wheelgruppen utføre en hvilken som helst kommando.

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

Nå bytter du til den nyopprettede brukeren.

su - johndoe

MERK: Erstatt johndoemed brukernavnet ditt.

Sett opp tidssonen.

sudo tzsetup

Installer Node.js

Wiki.js krever Node.js 6.11.1 eller nyere, så vi må først installere riktig versjon av Node.js.

Installer Node.js og NPM.

sudo pkg install -y node8 npm-node8

Sjekk versjonene.

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

Installer MongoDB

Wiki.js bruker MongoDB som en databasemotor.

Installer MongoDB.

sudo pkg install -y mongodb36

Sjekk versjonen.

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

Aktiver og start MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Installer Acme.sh og få et Let's Encrypt-sertifikat ( valgfritt )

Det er ikke nødvendig å sikre wikien din med HTTPS, men det er en god praksis å sikre trafikken til nettstedet ditt. For å få et SSL-sertifikat fra Let's Encrypt bruker vi Acme.sh-klienten. Acme.sh er en ren unix-skallprogramvare for å få SSL-sertifikater fra Let's Encrypt med null avhengigheter. Det gjør den veldig lett sammenlignet med noen andre Acme-protokollklienter som krever mange avhengigheter for å kjøre vellykket.

Last ned og installer 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 ~

Sjekk acme.shversjonen.

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

Skaff RSA- og ECDSA-sertifikater for 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

Etter å ha kjørt kommandoene ovenfor, vil sertifikatene og nøklene dine være i følgende kataloger:

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

MERK: Ikke glem å erstatte wiki.example.commed ditt domenenavn.

Etter å ha fått sertifikater fra Let's Encrypt, må vi konfigurere Nginx for å dra nytte av dem.

Installer og konfigurer Nginx

Wiki.js kan kjøre uten noen faktisk webserver, men det anbefales sterkt å sette en standard webserver foran den. Dette sikrer at du kan bruke funksjoner som SSL, flere nettsteder, caching og andre. Vi vil bruke Nginx i denne opplæringen, men enhver annen server vil gjøre det, du trenger bare å konfigurere den riktig.

Installer Nginx.

sudo pkg install -y nginx

Sjekk versjonen.

nginx -v
# nginx version: nginx/1.14.0

Aktiver og start Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Konfigurer Nginx som en HTTPS (hvis du bruker SSL) omvendt proxy for Wiki.js-applikasjonen.

Kjør sudo vim /usr/local/etc/nginx/wiki.js.confog fyll den med den grunnleggende omvendte proxy-konfigurasjonen nedenfor.

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

}

Det eneste du trenger å endre i konfigurasjonen ovenfor er server_namedirektivet, og potensielt proxy_passdirektivet hvis du bestemmer deg for å konfigurere en annen port enn 3000. Wiki.js bruker port 3000som standard. Lagre filen og avslutt med :+ W+Q

Nå må vi inkludere wiki.js.conffilen i hovedfilen nginx.conf.

Kjør sudo vim /usr/local/etc/nginx/nginx.confog legg til følgende linje i http {}blokken.

include wiki.js.conf;

Sjekk konfigurasjonen.

sudo nginx -t

Last inn Nginx på nytt.

sudo service nginx reload

Installer Wiki.js

Opprett en tom dokumentrotmappe der Wiki.js skal installeres.

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

Naviger til dokumentrotmappen.

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

Endre eierskap av /usr/local/www/wiki.example.commappe til bruker johndoe.

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

/usr/local/www/wiki.example.comKjør følgende kommandoer fra mappen for å laste ned og installere 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

Du kan kjøre følgende kommando for å se den installerte versjonen av Wiki.js.

node wiki --version
# 1.0.102

Når installasjonen er fullført, vil du bli bedt om å kjøre konfigurasjonsveiviseren.

Start konfigurasjonsveiviseren ved å kjøre.

node wiki configure

Dette vil varsle deg om å navigere til for http://localhost:3000å konfigurere Wiki.js. Hvis du har Nginx foran Wiki.js, betyr det at du kan åpne domenenavnet ditt (f.eks. http://wiki.example.com) i stedet for å gå til localhost.

Bruk nettleseren din, naviger til http://wiki.example.comog følg instruksjonene på skjermen. Alle innstillingene som ble angitt under konfigurasjonsveiviseren, lagres i config.ymlfilen. Konfigurasjonsveiviseren vil automatisk starte Wiki.js for deg.

Installer og konfigurer PM2-prosessbehandler

Som standard vil ikke Wiki.js starte automatisk etter en omstart av systemet. For å få det til å starte ved oppstart, må vi installere og konfigurere PM2-prosessbehandling.

Installer PM2 globalt via npm.

sudo npm install -g pm2

Sjekk versjonen.

pm2 -v
# 3.2.2

Naviger til dokumentrotmappen din hvis du ikke allerede er der, og stopp Wiki.js.

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

Start Wiki.js via PM2.

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

Listeprosess administrert av PM2.

pm2 list

Be PM2 om å konfigurere seg selv som en oppstartstjeneste ved å kjøre:

pm2 startup

Til slutt lagrer du gjeldende PM2-konfigurasjon ved å kjøre kommandoen:

pm2 save

Wiki.js-forekomsten din kjører nå som en bakgrunnsprosess, og bruker PM2 som prosessbehandler.