Wiki.js installeren op FreeBSD 11

• Vereisten
• Voordat je begint
• Installeer Node.js
• Installeer MongoDB
• Installeer Acme.sh en verkrijg een Let's Encrypt-certificaat (optioneel)
• Installeer en configureer Nginx
• Installeer Wiki.js
• Installeer en stel PM2 procesmanager in

Wiki.js is een gratis en open source, moderne wiki-app gebouwd op Node.js, MongoDB, Git en Markdown. De broncode van Wiki.js wordt openbaar gehost op Github . Deze gids zal je laten zien hoe je Wiki.js installeert op een nieuwe FreeBSD 11 Vultr-instantie met behulp van Node.js, MongoDB, PM2, Nginx, Git en Acme.sh.

Vereisten

Vereisten om Wiki.js uit te voeren zijn als volgt:

• Node.js versie 6.11.1 of hoger
• MongoDB versie 3.2 of hoger
• Git versie 2.7.4 of hoger
• Een webserver zoals Nginx, Apache, IIS, Caddy of H2O. Deze gids zal Nginx gebruiken.
• Een Git-compatibele repository (openbaar of privé) Dit is optioneel
• Een minimum van 512 MB RAM. Het wordt sterk aanbevolen om een ​​machine te gebruiken met minimaal 1 GB RAM.
• Domeinnaam met A/ AAAArecords ingesteld. In deze handleiding gebruiken we wiki.example.comals voorbeelddomein.

Voordat je begint

Controleer de FreeBSD-versie.

uname -ro
# FreeBSD 11.2-RELEASE

Zorg ervoor dat uw FreeBSD-systeem up-to-date is.

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

Installeer sudo, vim, unzip, wget, git, bashen socatpakketten als ze niet aanwezig zijn op uw systeem.

pkg install -y sudo vim unzip wget git bash socat

Maak een nieuw gebruikersaccount aan met uw favoriete gebruikersnaam (we zullen gebruiken 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!

Voer de visudoopdracht uit en maak een commentaar op de %wheel ALL=(ALL) ALLregel, zodat leden van de wheelgroep elke opdracht kunnen uitvoeren.

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

Schakel nu over naar uw zojuist gemaakte gebruiker.

su - johndoe

OPMERKING: vervang johndoedoor uw gebruikersnaam.

Stel de tijdzone in.

sudo tzsetup

Installeer Node.js

Wiki.js vereist Node.js 6.11.1 of hoger, dus we moeten eerst de juiste versie van Node.js. installeren.

Installeer Node.js en NPM.

sudo pkg install -y node8 npm-node8

Controleer de versies.

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

Installeer MongoDB

Wiki.js gebruikt MongoDB als database-engine.

Installeer MongoDB.

sudo pkg install -y mongodb36

Controleer de versie.

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

Schakel MongoDB in en start het.

sudo sysrc mongod_enable=yes
sudo service mongod start

Installeer Acme.sh en verkrijg een Let's Encrypt-certificaat ( optioneel )

Het beveiligen van uw wiki met HTTPS is niet nodig, maar het is een goede gewoonte om uw siteverkeer te beveiligen. Om een ​​SSL-certificaat van Let's Encrypt te verkrijgen, gebruiken we de Acme.sh-client. Acme.sh is pure unix shell-software voor het verkrijgen van SSL-certificaten van Let's Encrypt zonder afhankelijkheden. Dat maakt het zeer licht in vergelijking met sommige andere Acme-protocolclients die veel afhankelijkheden vereisen om succesvol te kunnen werken.

Download en installeer 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 ~

Controleer de acme.shversie.

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

Verkrijgen van RSA- en ECDSA-certificaten voor 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

Na het uitvoeren van de bovenstaande opdrachten, bevinden uw certificaten en sleutels zich in de volgende mappen:

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

OPMERKING: vergeet niet te vervangen wiki.example.comdoor uw domeinnaam.

Na het verkrijgen van certificaten van Let's Encrypt, moeten we Nginx configureren om hiervan te profiteren.

Installeer en configureer Nginx

Wiki.js kan draaien zonder een echte webserver, maar het wordt sterk aanbevolen om er een standaard webserver voor te zetten. Dit zorgt ervoor dat u functies zoals SSL, meerdere websites, caching en andere kunt gebruiken. We zullen Nginx gebruiken in deze tutorial, maar elke andere server zal het doen, je hoeft het alleen maar goed te configureren.

Installeer Nginx.

sudo pkg install -y nginx

Controleer de versie.

nginx -v
# nginx version: nginx/1.14.0

Schakel Nginx in en start het.

sudo sysrc nginx_enable=yes
sudo service nginx start

Configureer Nginx als HTTPS (als je SSL gebruikt) reverse proxy voor de Wiki.js applicatie.

Voer het uit sudo vim /usr/local/etc/nginx/wiki.js.confen vul het in met de basis omgekeerde proxyconfiguratie hieronder.

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

}

Het enige dat u in de bovenstaande configuratie moet wijzigen, is de server_namerichtlijn en mogelijk de proxy_passrichtlijn als u besluit een andere poort dan te configureren 3000. Wiki.js gebruikt 3000standaard poort . Sla het bestand op en sluit af met :+ W+Q

Nu moeten we het wiki.js.confbestand opnemen in het hoofdbestand nginx.conf.

Ren sudo vim /usr/local/etc/nginx/nginx.confen voeg de volgende regel toe aan het http {}blok.

include wiki.js.conf;

Controleer de configuratie.

sudo nginx -t

Herlaad Nginx.

sudo service nginx reload

Installeer Wiki.js

Maak een lege documenthoofdmap waar Wiki.js zal worden geïnstalleerd.

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

Navigeer naar de hoofdmap van het document.

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

Verander het eigendom van de /usr/local/www/wiki.example.commap in de gebruiker johndoe.

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

/usr/local/www/wiki.example.comVoer vanuit de map de volgende opdrachten uit om Wiki.js. te downloaden en te installeren

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

U kunt de volgende opdracht uitvoeren om de momenteel geïnstalleerde versie van Wiki.js. te bekijken.

node wiki --version
# 1.0.102

Zodra de installatie is voltooid, wordt u gevraagd de configuratiewizard uit te voeren.

Start de configuratiewizard door te draaien.

node wiki configure

Dit zal je informeren om naar te navigeren om http://localhost:3000Wiki.js. te configureren Als je Nginx voor Wiki.js hebt, betekent dit dat je je domeinnaam (bijv. http://wiki.example.com) Kunt openen in plaats van naar localhost te gaan.

Navigeer met uw webbrowser naar http://wiki.example.comen volg de instructies op het scherm. Alle instellingen die tijdens de configuratiewizard zijn ingevoerd, worden in het config.ymlbestand opgeslagen . De configuratiewizard start automatisch Wiki.js voor u.

Installeer en stel PM2 procesmanager in

Standaard zal Wiki.js niet automatisch starten nadat het systeem opnieuw is opgestart. Om het bij het opstarten te laten starten, moeten we PM2-procesmanager installeren en instellen.

Installeer PM2 wereldwijd via npm.

sudo npm install -g pm2

Controleer de versie.

pm2 -v
# 3.2.2

Navigeer naar de hoofdmap van uw document als u er nog niet bent en stop 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"

Lijstproces beheerd door PM2.

pm2 list

Laat PM2 zichzelf configureren als opstartservice door het volgende uit te voeren:

pm2 startup

Sla ten slotte de huidige PM2-configuratie op door de opdracht uit te voeren:

pm2 save

Uw Wiki.js-instantie wordt nu uitgevoerd als achtergrondproces, met PM2 als procesmanager.