Jak zainstalować Wiki.js na FreeBSD 11

• Wymagania
• Zanim zaczniesz
• Zainstaluj Node.js
• Zainstaluj MongoDB
• Zainstaluj plik Acme.sh i uzyskaj certyfikat Let's Encrypt (opcjonalnie)
• Zainstaluj i skonfiguruj Nginx
• Zainstaluj Wiki.js
• Zainstaluj i skonfiguruj menedżera procesów PM2

Wiki.js to darmowa i otwarta, nowoczesna aplikacja wiki zbudowana na Node.js, MongoDB, Git i Markdown. Kod źródłowy Wiki.js jest publicznie hostowany na Github . W tym przewodniku dowiesz się, jak zainstalować Wiki.js na nowej instancji FreeBSD 11 Vultr przy użyciu Node.js, MongoDB, PM2, Nginx, Git i Acme.sh.

Wymagania

Wymagania do uruchomienia Wiki.js są następujące:

• Node.js wersja 6.11.1 lub nowsza
• MongoDB wersja 3.2 lub nowsza
• Git w wersji 2.7.4 lub nowszej
• Serwer WWW, taki jak Nginx, Apache, IIS, Caddy lub H2O. Ten przewodnik użyje Nginx.
• Repozytorium zgodne z Git (publiczne lub prywatne) Jest to opcjonalne
• Co najmniej 512 MB pamięci RAM. Zdecydowanie zaleca się korzystanie z komputera z co najmniej 1 GB pamięci RAM.
• Nazwa domeny z ustawieniem A/ AAAArecords. W tym przewodniku wykorzystamy wiki.example.comjako przykładową domenę.

Zanim zaczniesz

Sprawdź wersję FreeBSD.

uname -ro
# FreeBSD 11.2-RELEASE

Upewnij się, że twój system FreeBSD jest aktualny.

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

Zainstalować sudo, vim, unzip, wget, git, bashi socatpakiety, jeśli nie są one obecne w systemie.

pkg install -y sudo vim unzip wget git bash socat

Utwórz nowe konto użytkownika z preferowaną nazwą użytkownika (użyjemy 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!

Uruchom visudopolecenie i usuń komentarz z %wheel ALL=(ALL) ALLwiersza, aby umożliwić członkom wheelgrupy wykonanie dowolnego polecenia.

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

Teraz przejdź do nowo utworzonego użytkownika.

su - johndoe

UWAGA: Zamień na johndoeswoją nazwę użytkownika.

Ustaw strefę czasową.

sudo tzsetup

Zainstaluj Node.js

Wiki.js wymaga Node.js 6.11.1 lub nowszej, więc najpierw musimy zainstalować odpowiednią wersję Node.js.

Zainstaluj Node.js i NPM.

sudo pkg install -y node8 npm-node8

Sprawdź wersje.

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

Zainstaluj MongoDB

Wiki.js używa MongoDB jako silnika bazy danych.

Zainstaluj MongoDB.

sudo pkg install -y mongodb36

Sprawdź wersję.

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

Włącz i uruchom MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Zainstaluj plik Acme.sh i uzyskaj certyfikat Let's Encrypt ( opcjonalnie )

Zabezpieczanie wiki za pomocą HTTPS nie jest konieczne, ale dobrą praktyką jest zabezpieczenie ruchu w witrynie. W celu uzyskania certyfikatu SSL od Let's Encrypt użyjemy klienta Acme.sh. Acme.sh to czysto uniksowe oprogramowanie powłoki do uzyskiwania certyfikatów SSL z Let's Encrypt z zerowymi zależnościami. To sprawia, że ​​jest bardzo lekki w porównaniu do niektórych innych klientów protokołu Acme, które wymagają wielu zależności, aby działać poprawnie.

Pobierz i zainstaluj 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 ~

Sprawdź acme.shwersję.

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

Uzyskaj certyfikaty RSA i ECDSA dla 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 uruchomieniu powyższych poleceń certyfikaty i klucze będą znajdować się w następujących katalogach:

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

UWAGA: Nie zapomnij zastąpić wiki.example.comnazwą domeny.

Po uzyskaniu certyfikatów z Let's Encrypt musimy skonfigurować Nginx, aby z nich skorzystać.

Zainstaluj i skonfiguruj Nginx

Wiki.js może działać bez żadnego rzeczywistego serwera WWW, jednak zdecydowanie zaleca się postawienie przed nim standardowego serwera WWW. Dzięki temu możesz korzystać z funkcji, takich jak SSL, wiele stron internetowych, buforowanie i inne. Będziemy używać Nginx w tym samouczku, ale zrobi to każdy inny serwer, wystarczy go poprawnie skonfigurować.

Zainstaluj Nginx.

sudo pkg install -y nginx

Sprawdź wersję.

nginx -v
# nginx version: nginx/1.14.0

Włącz i uruchom Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Skonfiguruj Nginx jako HTTPS (jeśli używasz SSL) odwrotnego proxy dla aplikacji Wiki.js.

Uruchom sudo vim /usr/local/etc/nginx/wiki.js.confi zapełnij podstawową konfiguracją odwrotnego proxy poniżej.

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

}

Jedyną rzeczą, którą musisz zmienić w powyższej konfiguracji, jest server_namedyrektywa i potencjalnie proxy_passdyrektywa, jeśli zdecydujesz się skonfigurować inny port niż 3000. Wiki.js domyślnie używa portu 3000. Zapisz plik i wyjdź za pomocą :+ W+Q

Teraz musimy dołączyć wiki.js.confplik do pliku głównego nginx.conf.

Uruchom sudo vim /usr/local/etc/nginx/nginx.confi dodaj następujący wiersz do http {}bloku.

include wiki.js.conf;

Sprawdź konfigurację.

sudo nginx -t

Załaduj ponownie Nginx.

sudo service nginx reload

Zainstaluj Wiki.js

Utwórz pusty folder główny dokumentu, w którym zostanie zainstalowany Wiki.js.

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

Przejdź do folderu głównego dokumentu.

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

Zmień własność /usr/local/www/wiki.example.comfolderu na użytkownika johndoe.

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

Z /usr/local/www/wiki.example.comfolderu uruchom następujące polecenia, aby pobrać i zainstalować 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żesz uruchomić następujące polecenie, aby wyświetlić aktualnie zainstalowaną wersję Wiki.js.

node wiki --version
# 1.0.102

Po zakończeniu instalacji pojawi się monit o uruchomienie kreatora konfiguracji.

Uruchom kreatora konfiguracji, uruchamiając.

node wiki configure

Powiadomi Cię to o przejściu http://localhost:3000do konfiguracji Wiki.js. Jeśli masz Nginx przed Wiki.js, oznacza to, że możesz otworzyć swoją nazwę domeny (np. http://wiki.example.com) Zamiast przechodzić do localhost.

Za pomocą przeglądarki internetowej przejdź do http://wiki.example.cominstrukcji wyświetlanych na ekranie i postępuj zgodnie z nimi. Wszystkie ustawienia wprowadzone w kreatorze konfiguracji są zapisywane w config.ymlpliku. Kreator konfiguracji automatycznie uruchomi Wiki.js.

Zainstaluj i skonfiguruj menedżera procesów PM2

Domyślnie Wiki.js nie uruchamia się automatycznie po ponownym uruchomieniu systemu. Aby uruchomić go przy starcie, musimy zainstalować i skonfigurować menedżera procesów PM2.

Zainstaluj PM2 globalnie przez npm.

sudo npm install -g pm2

Sprawdź wersję.

pm2 -v
# 3.2.2

Przejdź do folderu głównego dokumentu, jeśli jeszcze go nie ma i zatrzymaj Wiki.js.

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

Uruchom Wiki.js przez PM2.

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

Proces listy zarządzany przez PM2.

pm2 list

Powiedz PM2, aby skonfigurował się jako usługa uruchamiania, uruchamiając:

pm2 startup

Na koniec zapisz bieżącą konfigurację PM2, uruchamiając polecenie:

pm2 save

Twoja instancja Wiki.js działa teraz jako proces w tle, używając PM2 jako menedżera procesów.