Cum se instalează Wiki.js pe Ubuntu 18.04

• cerinţe
• Instalați Git
• Instalați Node.js
• Instalați MongoDB
• Instalați și configurați Nginx
• Instalați clientul Acme.sh și obțineți un certificat Let's Encrypt (opțional)
• Instalați Wiki.js
• Instalați PM2

Wiki.js este o aplicație wiki gratuită și deschisă, modernă, construită pe Node.js , Git și Markdown . Codul sursă Wiki.js este găzduit public pe Github . Acest ghid vă va arăta cum să instalați Wiki.js pe o nouă instanță Ubult 18.04 LTS Vultr folosind Node.js, MongoDB, PM2, Nginx, Git și Acme.sh.

cerinţe

Cerințele de a rula Wiki.js și de a termina acest ghid sunt următoarele:

• Node.js versiunea 6.9.0 sau o versiune ulterioară
• MongoDB versiunea 3.2 sau o versiune ulterioară
• Nginx
• Git versiunea 2.7.4 sau mai recentă
• Minim de 768 MB RAM
• Nume de domeniu cu A/ AAAAînregistrări configurate

Verificați versiunea Ubuntu.

lsb_release -ds
# Ubuntu 18.04.4 LTS

Creați un non-rootcont de utilizator nou cu sudoacces și treceți la acesta.

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

NOTĂ : Înlocuiți johndoecu numele de utilizator.

Setați fusul orar.

sudo dpkg-reconfigure tzdata

Asigurați-vă că sistemul dvs. este actualizat.

sudo apt update && sudo apt upgrade -y

Instalați pachetele necesare.

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

Instalați Git

Git 2.7.4 vine preinstalat pe ediția serverului Ubuntu, deci nu trebuie să-l instalăm. Dacă doriți să instalați o versiune mai nouă, puteți utiliza PPA-uri terțe sau compila cea mai recentă versiune de Git de la sursă.

Puteți verifica versiunea actuală instalată de Git rulând:

git --version
# git version 2.7.4

Dacă doriți să instalați o versiune mai nouă a software-ului Git, puteți utiliza următoarele.

# 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

Verificați versiunea Git.

git --version
# git version 2.17.0

Instalați Node.js

Instalați Node.js utilizând depozitul APT NodeSource pentru Node.js.

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

Verificați versiunile Node.js și NPM.

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

Instalați MongoDB

Vom folosi depozitele oficiale MongoDB , care sunt actualizate cu cele mai recente versiuni MongoDB majore și minore.

Instalează MongoDB Community Edition.

sudo apt install -y mongodb

Verificați versiunea.

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

Instalați și configurați Nginx

Instalați 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

Verificați versiunea.

sudo nginx -v
# nginx version: nginx/1.15.0

Activați și porniți Nginx.

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

Configurați Nginx ca proxy invers pentru aplicația Wiki.js.

Rulați sudo vim /etc/nginx/conf.d/wiki.js.confși populați-l cu configurația de bază a proxy-ului invers de mai jos.

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

}

Singurul lucru pe care trebuie să îl schimbați în configurația de mai sus este server_namedirectiva și, eventual, proxy_passdirectiva dacă decideți să configurați orice alt port în afară 3000. Wiki.js utilizează 3000implicit portul .

Verificați configurația.

sudo nginx -t

Reîncărcați Nginx.

sudo systemctl reload nginx.service

Instalați clientul Acme.sh și obțineți un certificat Let's Encrypt (opțional)

Securizarea wiki HTTPSnu este necesară, dar va asigura traficul site-ului dvs. Acme.sh este un software pur shell unix pentru obținerea certificatelor SSL de la Let's Encrypt cu zero dependențe.

Descărcați și instalați 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 ~

Verificați versiunea.

/etc/letsencrypt/acme.sh --version

Obțineți certificate RSA și ECDSA pentru wiki.example.comnume / domeniu gazdă.

# 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 

După executarea comenzilor de mai sus, certificatele și cheile dvs. vor fi în:

• Pentru RSA: /etc/letsencrypt/wiki.example.comdirectorul.
• Pentru ECC / ECDSA: /etc/letsencrypt/wiki.example.com_eccdirectorul.

După obținerea certificatelor de la Let's Encrypt, trebuie să configurăm Nginx pentru a le folosi.

Rulați sudo vim /etc/nginx/conf.d/wiki.js.confdin nou și configurați Nginx ca HTTPSproxy invers.

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

}

Verificați configurația.

sudo nginx -t

Reîncărcați Nginx.

sudo systemctl reload nginx.service

Instalați Wiki.js

Creați un folder rădăcină de document gol în care ar trebui instalat Wiki.js.

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

Navigați la folderul rădăcină al documentului.

cd /var/www/wiki.example.com

Schimbați proprietatea /var/www/wiki.example.comfolderului la utilizator johndoe.

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

Din /var/www/wiki.example.comfolder, executați următoarea comandă pentru a descărca și instala Wiki.js.

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

Pentru a vizualiza versiunea actuală instalată de Wiki.js, puteți rula următoarea comandă.

node wiki --version
# 1.0.78

După terminarea instalării, vi se va solicita să executați asistentul de configurare.

Porniți asistentul de configurare.

node wiki configure

Acest lucru vă va notifica pentru a naviga pentru http://localhost:3000a configura Wiki.js. Dacă aveți Nginx în fața Wiki.js, puteți deschide numele dvs. de domeniu (de exemplu http://wiki.example.com) în loc să mergeți la localhost.

Utilizând browserul dvs. web, navigați la http://wiki.example.comși urmați instrucțiunile de pe ecran. Toate setările introduse în timpul asistentului de configurare sunt salvate în config.ymlfișier. Expertul de configurare va porni automat Wiki.js pentru dvs.

Instalați PM2

În mod implicit, Wiki.js nu va porni automat după repornirea sistemului. Pentru a porni la pornire, trebuie să configurați PM2. PM2 vine în pachet cu Wiki.js ca un modul NPM local, deci nu trebuie să instalăm PM2 la nivel global.

Spuneți PM2 să se configureze ca serviciu de pornire.

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

În cele din urmă, salvați configurația curentă PM2.

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

Wiki.js rulează ca proces de fundal, folosind PM2 ca manager de proces.