Hur man installerar Wiki.js på FreeBSD 11

Krav

Innan du börjar

Installera Node.js

Installera MongoDB

Installera Acme.sh och skaffa ett Let's Encrypt-certifikat (valfritt)

Installera och konfigurera Nginx

Installera Wiki.js

Installera och konfigurera PM2 process manager

Wiki.js är en gratis och öppen källkod, modern wiki-app byggd på Node.js, MongoDB, Git och Markdown. Wiki.js källkod är offentligt värd på Github . Den här guiden visar dig hur du installerar Wiki.js på en ny FreeBSD 11 Vultr-instans genom att använda Node.js, MongoDB, PM2, Nginx, Git och Acme.sh.

Krav

Kraven för att köra Wiki.js är följande:

• Node.js version 6.11.1 eller senare
• MongoDB version 3.2 eller senare
• Git version 2.7.4 eller senare
• En webbserver som Nginx, Apache, IIS, Caddy eller H2O. Den här guiden kommer att använda Nginx.
• Ett Git-kompatibelt arkiv (offentligt eller privat) Detta är valfritt
• Minst 512MB RAM. Det rekommenderas starkt att använda en maskin med minst 1 GB RAM.
• Domännamn med A/ AAAAposter inställda. I den här guiden kommer vi att använda wiki.example.comsom exempeldomän.

Innan du börjar

Kontrollera FreeBSD-versionen.

uname -ro
# FreeBSD 11.2-RELEASE

Se till att ditt FreeBSD-system är uppdaterat.

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

Installera sudo, vim, unzip, wget, git, bashoch socatpaket om de inte finns på ditt system.

pkg install -y sudo vim unzip wget git bash socat

Skapa ett nytt användarkonto med ditt föredragna användarnamn (vi kommer att använda 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!

Kör visudokommandot och avkommentera %wheel ALL=(ALL) ALLraden för att tillåta medlemmar i wheelgruppen att utföra vilket kommando som helst.

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

Byt nu till din nyskapade användare.

su - johndoe

OBS: Ersätt johndoemed ditt användarnamn.

Ställ in tidszonen.

sudo tzsetup

Installera Node.js

Wiki.js kräver Node.js 6.11.1 eller senare, så vi måste först installera lämplig version av Node.js.

Installera Node.js och NPM.

sudo pkg install -y node8 npm-node8

Kontrollera versionerna.

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

Installera MongoDB

Wiki.js använder MongoDB som en databasmotor.

Installera MongoDB.

sudo pkg install -y mongodb36

Kontrollera versionen.

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

Aktivera och starta MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Installera Acme.sh och skaffa ett Let's Encrypt-certifikat ( valfritt )

Att säkra din wiki med HTTPS är inte nödvändigt, men det är en bra praxis att säkra din webbplatstrafik. För att få ett SSL-certifikat från Let's Encrypt kommer vi att använda Acme.sh-klienten. Acme.sh är ett rent unix-skalprogramvara för att erhålla SSL-certifikat från Let's Encrypt med noll beroenden. Det gör den väldigt lätt i jämförelse med vissa andra Acme-protokollklienter som kräver många beroenden för att fungera framgångsrikt.

Ladda ner och installera 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 your_email@example.com
cd ~

Kontrollera acme.shversionen.

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

Skaffa RSA- och ECDSA-certifikat för 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

Efter att ha kört kommandona ovan kommer dina certifikat och nycklar att finnas i följande kataloger:

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

OBS: Glöm inte att ersätta wiki.example.commed ditt domännamn.

Efter att ha erhållit certifikat från Let's Encrypt måste vi konfigurera Nginx för att dra fördel av dem.

Installera och konfigurera Nginx

Wiki.js kan köras utan någon egentlig webbserver, men det rekommenderas starkt att sätta en vanlig webbserver framför den. Detta säkerställer att du kan använda funktioner som SSL, flera webbplatser, cachning och andra. Vi kommer att använda Nginx i den här handledningen, men vilken annan server som helst, du behöver bara konfigurera den ordentligt.

Installera Nginx.

sudo pkg install -y nginx

Kontrollera versionen.

nginx -v
# nginx version: nginx/1.14.0

Aktivera och starta Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Konfigurera Nginx som en HTTPS (om du använder SSL) omvänd proxy för Wiki.js-applikationen.

Kör sudo vim /usr/local/etc/nginx/wiki.js.confoch fyll i den med den grundläggande omvända proxykonfigurationen nedan.

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 enda du behöver ändra i konfigurationen ovan är server_namedirektivet och eventuellt proxy_passdirektivet om du bestämmer dig för att konfigurera någon annan port än 3000. Wiki.js använder port som 3000standard. Spara filen och avsluta med :+ W+Q

Nu måste vi inkludera wiki.js.conffilen i huvudfilen nginx.conf.

Kör sudo vim /usr/local/etc/nginx/nginx.confoch lägg till följande rad i http {}blocket.

include wiki.js.conf;

Kontrollera konfigurationen.

sudo nginx -t

Ladda om Nginx.

sudo service nginx reload

Installera Wiki.js

Skapa en tom dokumentrotmapp där Wiki.js kommer att installeras.

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

Navigera till dokumentets rotmapp.

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

Ändra ägande av /usr/local/www/wiki.example.commapp till användare johndoe.

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

/usr/local/www/wiki.example.comKör följande kommandon från mappen för att ladda ner och installera 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 köra följande kommando för att se den för närvarande installerade versionen av Wiki.js.

node wiki --version
# 1.0.102

När installationen är klar kommer du att bli ombedd att köra konfigurationsguiden.

Starta konfigurationsguiden genom att köra.

node wiki configure

Detta kommer att meddela dig att navigera till för http://localhost:3000att konfigurera Wiki.js. Om du har Nginx framför Wiki.js betyder det att du kan öppna ditt domännamn (t.ex. http://wiki.example.com) istället för att gå till localhost.

Använd din webbläsare, navigera till http://wiki.example.comoch följ instruktionerna på skärmen. Alla inställningar som angetts under konfigurationsguiden sparas i config.ymlfilen. Konfigurationsguiden startar automatiskt Wiki.js åt dig.

Installera och konfigurera PM2 process manager

Som standard startar inte Wiki.js automatiskt efter en omstart av systemet. För att få det att starta vid uppstart måste vi installera och konfigurera PM2 process manager.

Installera PM2 globalt via npm.

sudo npm install -g pm2

Kontrollera versionen.

pm2 -v
# 3.2.2

Navigera till din dokumentrotmapp om du inte redan är där och stoppa Wiki.js.

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

Starta Wiki.js via PM2.

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

Listprocess hanteras av PM2.

pm2 list

Be PM2 att konfigurera sig själv som en starttjänst genom att köra:

pm2 startup

Slutligen, spara den aktuella PM2-konfigurationen genom att köra kommandot:

pm2 save

Din Wiki.js-instans körs nu som en bakgrundsprocess, med PM2 som processhanterare.