Kā instalēt Wiki.js operētājsistēmā CentOS 7

Wiki.js ir bezmaksas atvērtā pirmkoda moderna wiki lietojumprogramma, kas veidota uz Node.js, MongoDB, Git un Markdown. Wiki.js pirmkods ir publiski mitināts vietnē Github . Šajā rokasgrāmatā tiks parādīts, kā instalēt Wiki.js jaunā CentOS 7 Vultr instancē, izmantojot Node.js, MongoDB, PM2, Nginx, Git un Acme.sh.

Prasības

Lai palaistu Wiki.js, ir šādas prasības:

• Node.js versija 6.9.0 vai jaunāka
• MongoDB versija 3.2 vai jaunāka
• Nginx
• Git versija 2.7.4 vai jaunāka
• Ar Git saderīga repozitorijs (publisks vai privāts) ( pēc izvēles )
• Vismaz 768 MB RAM
• Iestatīts domēna nosaukums ar A/ AAAAierakstiem

Pārbaudiet CentOS versiju.

cat /etc/centos-release
# CentOS Linux release 7.5.1804 (Core)

Izveidojiet jaunu non-rootlietotāja kontu ar sudopiekļuvi un pārslēdzieties uz to.

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

PIEZĪME . Aizstāt johndoear savu lietotājvārdu .

Iestatiet laika joslu.

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

Pārliecinieties, vai jūsu sistēma ir atjaunināta.

sudo yum update -y

Instalējiet nepieciešamās pakotnes, lai pabeigtu šo apmācību.

sudo yum install -y wget curl vim zip unzip bash-completion

Atspējojiet SELinux un ugunsmūri.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Iespējot EPEL repozitoriju.

sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

Instalējiet Git

CentOS krātuves nodrošina ļoti novecojušu Git versiju, tāpēc mums būs jāveido Git no avota.

Instalējiet Git, izveidojot to no pirmkoda.

# Remove existing git package if installed: 
sudo yum remove -y git
sudo yum groupinstall -y "Development Tools"
sudo yum install -y gettext-devel openssl-devel perl-CPAN perl-devel zlib-devel curl-devel
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.17.1.tar.gz && tar zxvf git-2.17.1.tar.gz
rm git-2.17.1.tar.gz
cd git-2.17.1
make configure
./configure
make prefix=/usr/local all
sudo make prefix=/usr/local install
cd ~

# Confirm this command returns /usr/local/bin/git:
which git

Pārbaudiet versiju.

git --version
# git version 2.17.1

Instalējiet Node.js

Wiki.js ir nepieciešama Node.js 6.9.0 vai jaunāka versija, tāpēc mums vispirms būs jāinstalē Node.js.

Instalējiet Node.js, izmantojot Node.js paredzēto NodeSource YUM repozitoriju.

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
sudo yum install -y nodejs

Pārbaudiet Node.js un NPM versijas.

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

Instalējiet MongoDB

Wiki.js izmanto MongoDB kā datu bāzes dzinēju. Mēs izmantosim oficiālās MongoDB krātuves , kurās ir jaunākie lielākie un mazākie MongoDB laidieni.

Instalējiet MongoDB Community Edition.

sudo vim /etc/yum.repos.d/mongodb-org-3.6.repo

# Copy/paste this
[mongodb-org-3.6]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.6/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.6.asc

sudo yum install -y mongodb-org

Pārbaudiet versiju.

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

Iespējojiet un palaidiet MongoDB.

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

Instalējiet un konfigurējiet Nginx

Ir ļoti ieteicams Wiki.js priekšā ievietot standarta tīmekļa serveri. Tas nodrošina, ka varat izmantot tādas funkcijas kā SSL, vairākas vietnes, kešatmiņu un citas.

Instalējiet Nginx.

sudo vim /etc/yum.repos.d/nginx_mainline.repo

# Copy/paste this
[nginx]
name=nginx repo
baseurl=https://nginx.org/packages/mainline/centos/7/$basearch/
gpgcheck=1
enabled=1

wget https://nginx.org/keys/nginx_signing.key
sudo rpm --import nginx_signing.key
rm nginx_signing.key

sudo yum install -y nginx

Pārbaudiet versiju.

nginx -v
# nginx version: nginx/1.15.0

Iespējojiet un palaidiet Nginx.

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

Konfigurējiet Nginx kā Wiki.js starpniekserveri HTTPvai HTTPSapgriezto starpniekserveri.

Palaidiet sudo vim /etc/nginx/conf.d/wiki.js.confun aizpildiet to, izmantojot tālāk norādīto reversā starpniekservera pamata konfigurāciju.

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

}

Vienīgais, kas jāmaina iepriekš minētajā konfigurācijā, ir server_namedirektīva un, iespējams, proxy_passdirektīva, ja nolemjat konfigurēt jebkuru citu portu, nevis 3000. Wiki.js 3000pēc noklusējuma izmanto portu .

Pārbaudiet konfigurāciju.

sudo nginx -t

Pārlādēt Nginx.

sudo systemctl reload nginx.service

Instalējiet Acme.sh klientu un iegūstiet Let's Encrypt sertifikātu (pēc izvēles)

Wiki aizsardzība HTTPSnav nepieciešama, taču tā ir laba prakse, lai nodrošinātu vietnes trafiku. Lai no Let's Encrypt iegūtu SSL sertifikātu, mēs izmantosim Acme.sh klientu. Acme.sh ir tīrs UNIX apvalka skripts SSL sertifikātu iegūšanai no Let's Encrypt bez atkarības. Tas padara to ļoti vieglu salīdzinājumā ar dažiem citiem Acme protokola klientiem, kuru veiksmīgai darbībai ir nepieciešams daudz atkarību.

Lejupielādēt un instalēt 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 ~

Pārbaudiet versiju.

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

Iegūstiet RSA un ECDSA sertifikātus savam domēnam/resursdatora nosaukumam.

# 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 

Pēc iepriekš minēto komandu palaišanas jūsu sertifikāti un atslēgas atradīsies šādos direktorijos:

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

PIEZĪME : neaizmirstiet aizstāt wiki.example.comar savu domēna nosaukumu.

Pēc sertifikātu iegūšanas no Let's Encrypt mums ir jākonfigurē Nginx, lai tos izmantotu.

Palaidiet sudo vim /etc/nginx/conf.d/wiki.js.confvēlreiz un konfigurējiet Nginx kā HTTPSapgriezto starpniekserveri.

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

}

Pārbaudiet konfigurāciju.

sudo nginx -t

Pārlādēt Nginx.

sudo systemctl reload nginx.service

Instalējiet Wiki.js

Izveidojiet tukšu dokumenta saknes mapi, kurā jāinstalē Wiki.js.

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

Pārejiet uz dokumenta saknes mapi.

cd /var/www/wiki.example.com

Mainiet /var/www/wiki.example.commapes īpašumtiesības uz lietotāju johndoe.

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

No /var/www/wiki.example.commapes palaidiet šo komandu, lai lejupielādētu un instalētu Wiki.js.

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

Varat palaist šo komandu, lai skatītu pašlaik instalēto Wiki.js versiju.

node wiki --version
# 1.0.78

Kad instalēšana ir pabeigta, jums tiks piedāvāts palaist konfigurācijas vedni.

Sāciet konfigurācijas vedni.

node wiki configure

Tas jums paziņos, lai pārietu uz http://localhost:3000vietni, lai konfigurētu Wiki.js. Ja jums ir Nginx pirms Wiki.js, varat atvērt savu domēna nosaukumu (piemēram, http://wiki.example.com), nevis doties uz localhost.

Izmantojot tīmekļa pārlūkprogrammu, dodieties uz http://wiki.example.comun izpildiet ekrānā redzamos norādījumus. Visi iestatījumi, kas tika ievadīti konfigurācijas vedņa laikā, ir saglabāti config.ymlfailā. Konfigurācijas vednis automātiski startēs Wiki.js jūsu vietā.

Iestatīt PM2

Pēc noklusējuma Wiki.js nesāksies automātiski pēc sistēmas atsāknēšanas. Lai to sāktu sāknēšanas laikā, mums ir jāiestata PM2 procesa pārvaldnieks.

Pastāstiet PM2 konfigurēt sevi kā startēšanas pakalpojumu.

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

Visbeidzot, saglabājiet pašreizējo PM2 konfigurāciju, izpildot komandu.

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

Jūsu Wiki.js instance darbojas kā fona process, izmantojot PM2 kā procesa pārvaldnieku. Varat atsāknēt savu OS, izmantojot sudo rebootun nodrošināt, lai Wiki.js tiktu palaists pēc pārstartēšanas.