Jak nainstalovat Wiki.js na FreeBSD 11

Požadavky

Než začnete

Nainstalujte Node.js

Nainstalujte MongoDB

Nainstalujte Acme.sh a získejte certifikát Let's Encrypt (volitelné)

Nainstalujte a nakonfigurujte Nginx

Nainstalujte Wiki.js

Nainstalujte a nastavte správce procesů PM2

Wiki.js je bezplatná a open source, moderní wiki aplikace postavená na Node.js, MongoDB, Git a Markdown. Zdrojový kód Wiki.js je veřejně hostován na Github . Tato příručka vám ukáže, jak nainstalovat Wiki.js na čerstvou instanci FreeBSD 11 Vultr pomocí Node.js, MongoDB, PM2, Nginx, Git a Acme.sh.

Požadavky

Požadavky na spuštění Wiki.js jsou následující:

• Node.js verze 6.11.1 nebo novější
• MongoDB verze 3.2 nebo novější
• Git verze 2.7.4 nebo novější
• Webový server, jako je Nginx, Apache, IIS, Caddy nebo H2O. Tato příručka bude používat Nginx.
• Úložiště kompatibilní s Git (veřejné nebo soukromé) Toto je volitelné
• Minimálně 512 MB RAM. Důrazně se doporučuje používat počítač s alespoň 1 GB RAM.
• Název domény s nastavenými záznamy A/ AAAA. V této příručce budeme používat wiki.example.comjako příklad domény.

Než začnete

Zkontrolujte verzi FreeBSD.

uname -ro
# FreeBSD 11.2-RELEASE

Ujistěte se, že váš systém FreeBSD je aktuální.

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

Instalovat sudo, vim, unzip, wget, git, basha socatbalíčky v případě, že nejsou k dispozici ve vašem systému.

pkg install -y sudo vim unzip wget git bash socat

Vytvořte si nový uživatelský účet s preferovaným uživatelským jménem (použijeme 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!

Spusťte visudopříkaz a odkomentujte %wheel ALL=(ALL) ALLřádek, aby členové wheelskupiny mohli provést jakýkoli příkaz.

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

Nyní se přepněte na nově vytvořeného uživatele.

su - johndoe

POZNÁMKA: Nahraďte johndoesvým uživatelským jménem.

Nastavte časové pásmo.

sudo tzsetup

Nainstalujte Node.js

Wiki.js vyžaduje Node.js 6.11.1 nebo novější, takže nejprve budeme muset nainstalovat příslušnou verzi Node.js.

Nainstalujte Node.js a NPM.

sudo pkg install -y node8 npm-node8

Zkontrolujte verze.

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

Nainstalujte MongoDB

Wiki.js používá MongoDB jako databázový stroj.

Nainstalujte MongoDB.

sudo pkg install -y mongodb36

Zkontrolujte verzi.

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

Povolte a spusťte MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Nainstalujte Acme.sh a získejte certifikát Let's Encrypt ( volitelné )

Zabezpečení vaší wiki pomocí HTTPS není nutné, ale je dobrým zvykem pro zabezpečení provozu na vašem webu. K získání SSL certifikátu od Let's Encrypt použijeme klienta Acme.sh. Acme.sh je čistě unixový shell software pro získávání SSL certifikátů od Let's Encrypt s nulovými závislostmi. Díky tomu je velmi lehký ve srovnání s některými jinými klienty protokolu Acme, kteří k úspěšnému spuštění vyžadují mnoho závislostí.

Stáhněte a nainstalujte 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 ~

Zkontrolujte acme.shverzi.

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

Získejte certifikáty RSA a ECDSA pro 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

Po spuštění výše uvedených příkazů budou vaše certifikáty a klíče v následujících adresářích:

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

POZNÁMKA: Nezapomeňte jej nahradit wiki.example.comnázvem vaší domény.

Po získání certifikátů z Let's Encrypt musíme nakonfigurovat Nginx, abychom je mohli využívat.

Nainstalujte a nakonfigurujte Nginx

Wiki.js může běžet bez jakéhokoli skutečného webového serveru, ale důrazně se doporučuje umístit před něj standardní webový server. To zajišťuje, že můžete používat funkce jako SSL, více webových stránek, ukládání do mezipaměti a další. V tomto tutoriálu použijeme Nginx, ale bude fungovat jakýkoli jiný server, stačí jej správně nakonfigurovat.

Nainstalujte Nginx.

sudo pkg install -y nginx

Zkontrolujte verzi.

nginx -v
# nginx version: nginx/1.14.0

Povolte a spusťte Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Nakonfigurujte Nginx jako HTTPS (pokud používáte SSL) reverzní proxy pro aplikaci Wiki.js.

Spusťte sudo vim /usr/local/etc/nginx/wiki.js.confa naplňte jej základní konfigurací reverzního proxy níže.

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

}

Jediná věc, kterou musíte změnit ve výše uvedené konfiguraci, je server_namedirektiva a případně proxy_passdirektiva, pokud se rozhodnete nakonfigurovat jiný port než 3000. Wiki.js standardně používá port 3000. Uložte soubor a ukončete s :+ W+Q

Nyní musíme wiki.js.confsoubor zahrnout do hlavního nginx.confsouboru.

Spusťte sudo vim /usr/local/etc/nginx/nginx.confa přidejte do http {}bloku následující řádek .

include wiki.js.conf;

Zkontrolujte konfiguraci.

sudo nginx -t

Znovu načtěte Nginx.

sudo service nginx reload

Nainstalujte Wiki.js

Vytvořte prázdnou kořenovou složku dokumentů, kam se nainstaluje Wiki.js.

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

Přejděte do kořenové složky dokumentu.

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

Změnit vlastnictví /usr/local/www/wiki.example.comsložky na uživatele johndoe.

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

Ze /usr/local/www/wiki.example.comsložky spusťte následující příkazy ke stažení a instalaci 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

Chcete-li zobrazit aktuálně nainstalovanou verzi Wiki.js, můžete spustit následující příkaz.

node wiki --version
# 1.0.102

Po dokončení instalace budete vyzváni ke spuštění průvodce konfigurací.

Spusťte průvodce konfigurací spuštěním.

node wiki configure

To vás upozorní, abyste http://localhost:3000přešli na a nakonfigurovali Wiki.js. Pokud máte Nginx před Wiki.js, znamená to, že si můžete otevřít název své domény (např. http://wiki.example.com) namísto přechodu na localhost.

Pomocí webového prohlížeče přejděte na http://wiki.example.compokyny na obrazovce a postupujte podle nich. Všechna nastavení zadaná během průvodce konfigurací se uloží do config.ymlsouboru. Průvodce konfigurací za vás automaticky spustí Wiki.js.

Nainstalujte a nastavte správce procesů PM2

Ve výchozím nastavení se Wiki.js nespustí automaticky po restartu systému. Aby se spustil při startu, musíme nainstalovat a nastavit správce procesů PM2.

Nainstalujte PM2 globálně přes npm.

sudo npm install -g pm2

Zkontrolujte verzi.

pm2 -v
# 3.2.2

Přejděte do kořenové složky dokumentů, pokud tam ještě nejste, a zastavte Wiki.js.

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

Spusťte Wiki.js přes PM2.

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

Vypsat proces spravovaný PM2.

pm2 list

Řekněte PM2, aby se nakonfiguroval jako spouštěcí služba spuštěním:

pm2 startup

Nakonec uložte aktuální konfiguraci PM2 spuštěním příkazu:

pm2 save

Vaše instance Wiki.js nyní běží jako proces na pozadí a jako správce procesů používá PM2.