Jak zainstalować Wiki.js na Debian 9

• Wymagania
• Zainstaluj Git
• Zainstaluj Node.js
• Zainstaluj MongoDB
• Zainstaluj i skonfiguruj Nginx
• Zainstaluj plik 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 Debiana 9 Vultr przy użyciu Node.js, MongoDB, PM2, Nginx, Git i Acme.sh.

Wymagania

• Node.js 6.9.0 lub nowszy
• MongoDB 3.2 lub nowszy
• Nginx
• Git 2.7.4 lub nowszy
• Repozytorium zgodne z Git (publiczne lub prywatne) ( opcjonalnie )
• Minimum 768MB RAM
• Nazwa domeny z ustawieniem A/ AAAArecords

Sprawdź wersję Debiana.

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

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

apt update && apt upgrade -y

Zainstaluj niezbędne pakiety.

apt install -y build-essential apt-transport-https sudo curl wget dirmngr sudo

Utwórz nowe non-rootkonto użytkownika z sudodostępem i przejdź do niego.

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

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

Ustaw strefę czasową.

sudo dpkg-reconfigure tzdata

Zainstaluj Git

Zainstaluj Git na Debianie.

sudo apt install -y git

Sprawdź wersję Git.

git --version
# git version 2.11.0

Zainstaluj Node.js

Zainstaluj Node.js przy użyciu repozytorium NodeSource APT dla Node.js.

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt install -y nodejs

Sprawdź wersje Node.js i npm.

node -v && npm -v
# v8.11.2
# 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. Do instalacji wykorzystamy oficjalne repozytoria MongoDB .

Zainstaluj MongoDB Community Edition.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/3.6 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
sudo apt update
sudo apt install -y mongodb-org

Sprawdź wersję.

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

Włącz i uruchom MongoDB.

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

Zainstaluj i skonfiguruj Nginx

Zdecydowanie zaleca się umieszczenie standardowego serwera WWW przed Wiki.js. Dzięki temu możesz korzystać z funkcji, takich jak SSL, wiele stron internetowych, buforowanie i więcej. Będziemy używać Nginx w tym samouczku, ale zrobi to każdy inny serwer, wystarczy go poprawnie skonfigurować.

Zainstaluj Nginx.

wget https://nginx.org/keys/nginx_signing.key
sudo apt-key add nginx_signing.key
rm nginx_signing.key
sudo -s
printf "deb https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx

Sprawdź wersję.

sudo nginx -v
# nginx version: nginx/1.15.0

Włącz i uruchom Nginx.

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

Skonfiguruj Nginx jako odwrotne proxy ( HTTPlub HTTPSjeś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 plik 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.

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ź wersję.

/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 [email protected] --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 [email protected] --ocsp-must-staple --keylength ec-256 

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

Po uruchomieniu powyższych poleceń certyfikaty i klucze będą znajdować się w następujących katalogach.

• Dla RSA: /etc/letsencrypt/wiki.example.comkatalog.
• W przypadku ECC / ECDSA: /etc/letsencrypt/wiki.example.com_ecckatalog.

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/example.com.key;
    # ECDSA
    ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/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.

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

Na koniec zapisz bieżącą konfigurację PM2.

/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. Możesz ponownie uruchomić system operacyjny sudo rebooti sprawdzić, czy Wiki.js uruchamia się po ponownym uruchomieniu.