Jak zainstalować Wiki.js na Ubuntu 18.04

• Wymagania
• Zainstaluj Git
• Zainstaluj Node.js
• Zainstaluj MongoDB
• Zainstaluj i skonfiguruj Nginx
• Zainstaluj klienta Acme.sh i uzyskaj certyfikat Let's Encrypt (opcjonalnie)
• Zainstaluj Wiki.js
• Zainstaluj PM2

Wiki.js to darmowa i otwarta, nowoczesna aplikacja wiki oparta na Node.js , 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 Ubuntu 18.04 LTS Vultr przy użyciu Node.js, MongoDB, PM2, Nginx, Git i Acme.sh.

Wymagania

Wymagania do uruchomienia Wiki.js i ukończenia tego przewodnika są następujące:

• Node.js w wersji 6.9.0 lub nowszej
• MongoDB wersja 3.2 lub nowsza
• Nginx
• Git w wersji 2.7.4 lub nowszej
• Co najmniej 768 MB pamięci RAM
• Nazwa domeny z ustawieniem A/ AAAArecords

Sprawdź wersję Ubuntu.

lsb_release -ds
# Ubuntu 18.04.4 LTS

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

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

sudo apt update && sudo apt upgrade -y

Zainstaluj niezbędne pakiety.

sudo apt install -y build-essential apt-transport-https

Zainstaluj Git

Git 2.7.4 jest fabrycznie zainstalowany na serwerze Ubuntu, więc nie musimy go instalować. Jeśli chcesz zainstalować nowszą wersję, możesz użyć umów PPA innych firm lub skompilować najnowszą wersję Git ze źródła.

Możesz zweryfikować aktualnie zainstalowaną wersję Git, uruchamiając:

git --version
# git version 2.7.4

Jeśli chcesz zainstalować nowszą wersję oprogramowania Git, możesz użyć następujących opcji.

# Remove existing git package
sudo apt remove -y git
sudo apt-get install software-properties-common
sudo add-apt-repository -y ppa:git-core/ppa
sudo apt update && sudo apt upgrade -y
sudo apt install -y git

Sprawdź wersję Git.

git --version
# git version 2.17.0

Zainstaluj Node.js

Zainstaluj Node.js, korzystając z 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

Będziemy korzystać z oficjalnych repozytoriów MongoDB , które są na bieżąco z najnowszymi głównymi i mniejszymi wydaniami MongoDB.

Zainstaluj MongoDB Community Edition.

sudo apt install -y mongodb

Sprawdź wersję.

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

Zainstaluj i skonfiguruj Nginx

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/ubuntu/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/ubuntu/ $(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 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ć dowolny inny port oprócz 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 zabezpieczy ruch w Twojej witrynie. Acme.sh to czysto uniksowe oprogramowanie powłoki do uzyskiwania certyfikatów SSL z Let's Encrypt z zerowymi zależnościami.

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

/etc/letsencrypt/acme.sh --version

Uzyskaj certyfikaty RSA i ECDSA dla wiki.example.comdomeny / nazwy hosta.

# 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.comkatalog.
• W przypadku ECC / ECDSA: /etc/letsencrypt/wiki.example.com_ecckatalog.

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

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

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

node wiki --version
# 1.0.78

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

Uruchom kreatora konfiguracji.

node wiki configure

Powiadomi Cię to do przeglądania w http://localhost:3000celu skonfigurowania Wiki.js. Jeśli masz Nginx przed Wiki.js, możesz otworzyć swoją nazwę domeny (np. http://wiki.example.com) Zamiast iść 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 PM2

Domyślnie Wiki.js nie uruchamia się automatycznie po ponownym uruchomieniu systemu. Aby uruchomić go przy starcie, musimy skonfigurować 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

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