Jak zainstalować Wiki.js na Fedorze 28

• Wymagania
• Zanim zaczniesz
• Zainstaluj Node.js
• Zainstaluj MongoDB
• Zainstaluj i skonfiguruj Nginx
• Zainstaluj klienta Acme.sh i uzyskaj certyfikat Let's Encrypt (opcjonalnie)
• Zainstaluj Wiki.js
• Skonfiguruj 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 . Ten przewodnik pokaże, jak zainstalować Wiki.js na nowej instancji Fedory 28 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 w wersji 6.9.0 lub nowszej
• MongoDB wersja 3.2 lub nowsza
• Serwer WWW, taki jak Nginx, Apache, IIS, Caddy lub H2O. Ten przewodnik użyje Nginx
• Git w wersji 2.7.4 lub nowszej
• Repozytorium zgodne z Git (publiczne lub prywatne) Jest to opcjonalne
• Co najmniej 768 MB pamięci RAM
• Nazwa domeny z ustawieniem A/ AAAArecords

Zanim zaczniesz

Sprawdź wersję systemu operacyjnego.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

Utwórz nowe konto użytkownika innego niż root z dostępem sudo i przełącz się na to.

useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe

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

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

sudo dnf check-upgrade || sudo dnf upgrade -y

Ustaw strefę czasową.

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

Zainstaluj wymagane i przydatne pakiety.

sudo dnf install -y wget vim unzip bash-completion git

Dla uproszczenia wyłącz SELinux i Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Zainstaluj Node.js

Wiki.js wymaga Node.js 6.9.0 lub nowszej wersji, więc najpierw musimy zainstalować Node.js.

Zainstaluj Node.js.

sudo dnf install -y nodejs

Sprawdź wersje Node.js i npm.

node -v && npm -v
# v8.11.3
# 5.6.0

Zainstaluj MongoDB

Wiki.js używa MongoDB jako silnika bazy danych. Zgodnie z tym będziemy musieli zainstalować MongoDB na naszym serwerze.

Zainstaluj MongoDB.

sudo dnf install -y mongodb mongodb-server

Sprawdź wersję MongoDB.

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

Włącz i uruchom MongoDB.

sudo systemctl enable mongod.service
sudo systemctl start mongod.service

Zainstaluj i skonfiguruj Nginx

Wiki.js może działać bez żadnego rzeczywistego serwera WWW (takiego jak Nginx lub Apache). Zaleca się jednak umieszczenie standardowego serwera WWW przed Wiki.js. 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 dnf install -y nginx

Sprawdź wersję.

nginx -v
# nginx version: nginx/1.12.1

Włącz i uruchom Nginx.

sudo systemctl enable nginx.service
sudo systemctl start nginx.service

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

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

server {

    listen [::]:80;
    listen 80;

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

    location /.well-known/acme-challenge/ {
        allow all;
    }

    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.

Sprawdź konfigurację.

sudo nginx -t

Załaduj ponownie Nginx.

sudo systemctl reload nginx.service

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

Zabezpieczanie wiki za pomocą HTTPSnie 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.

Pobrać i zainstalować 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 ~

Sprawdź acme.shwersję.

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

Uzyskaj certyfikaty RSA i ECDSA dla wiki.example.com.

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail your_email@example.com --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail your_email@example.com --ocsp-must-staple --keylength ec-256 

Po uruchomieniu powyższych poleceń twoje certyfikaty i klucze będą w:

• W przypadku RSA: /etc/letsencrypt/wiki.example.com
• W przypadku 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ć.

Uruchom sudo vim /etc/nginx/conf.d/wiki.js.confponownie i skonfiguruj Nginx jako HTTPSodwrotne proxy.

server {

    listen [::]:443 ssl http2;
    listen 443 ssl http2;
    listen [::]:80;
    listen 80;

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

    location /.well-known/acme-challenge/ {
        allow all;
    }

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

}

Sprawdź konfigurację.

sudo nginx -t

Załaduj ponownie Nginx.

sudo systemctl reload nginx.service

Zainstaluj Wiki.js

Utwórz pusty folder główny dokumentu, w którym należy zainstalować Wiki.js.

sudo mkdir -p /var/www/wiki.example.com

Przejdź do folderu głównego dokumentu.

cd /var/www/wiki.example.com

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

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

Z /var/www/wiki.example.comfolderu uruchom następujące polecenie, aby pobrać i zainstalować Wiki.js.

curl -sSo- https://wiki.js.org/install.sh | bash

Możesz uruchomić następujące polecenie, aby wyświetlić aktualnie zainstalowaną wersję Wiki.js.

node wiki --version
# 1.0.78

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 iść 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.

Skonfiguruj PM2

Domyślnie Wiki.js nie uruchamia się automatycznie po ponownym uruchomieniu systemu. Aby uruchomić go przy starcie, musimy skonfigurować menedżera procesów PM2. PM2 jest dostarczany w pakiecie z Wiki.js jako lokalny moduł NPM, więc nie musimy instalować PM2 globalnie.

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

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup

Na koniec zapisz bieżącą konfigurację PM2, uruchamiając polecenie: /var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

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