Cum se instalează Wiki.js pe CentOS 7

• 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
• Configurare PM2

Wiki.js este o aplicație wiki gratuită și deschisă, modernă, construită pe Node.js, MongoDB, 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ță CentOS 7 Vultr folosind Node.js, MongoDB, PM2, Nginx, Git și Acme.sh.

cerinţe

Cerințele pentru a rula Wiki.js 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ă
• Un depozit conform Git (public sau privat) ( opțional )
• Minim de 768 MB RAM
• Nume de domeniu cu A/ AAAAînregistrări configurate

Verificați versiunea CentOS.

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

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

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

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

Setați fusul orar.

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

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

sudo yum update -y

Instalați pachetele necesare pentru a termina acest tutorial.

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

Dezactivează SELinux și Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Activați depozitul EPEL

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

Instalați Git

Depozitele CentOS oferă o versiune foarte învechită a Git, așa că va trebui să construim Git de la sursă.

Instalați Git construindu-l din codul sursă.

# 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

Verificați versiunea.

git --version
# git version 2.17.1

Instalați Node.js

Wiki.js necesită Node.js 6.9.0 sau o versiune ulterioară, așa că va trebui mai întâi să instalăm Node.js.

Instalați Node.js folosind depozitul NodeSource YUM pentru Node.js.

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

Verificați versiunile Node.js și NPM.

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

Instalați MongoDB

Wiki.js folosește MongoDB ca motor de bază de date. Vom folosi depozitele oficiale MongoDB , care conțin cele mai recente versiuni majore și minore MongoDB.

Instalează 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

Verificați versiunea.

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

Activați și porniți MongoDB.

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

Instalați și configurați Nginx

Este foarte recomandat să puneți un server web standard în fața Wiki.js. Acest lucru vă asigură că puteți utiliza funcții precum SSL, mai multe site-uri web, memorie în cache și multe altele.

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

Verificați versiunea.

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 HTTPsau HTTPSinvers pentru 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 modificați în configurația de mai sus este server_namedirectiva și, eventual, proxy_passdirectiva dacă decideți să configurați orice alt port decât 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-ului dvs. HTTPSnu este necesară, dar este o practică bună pentru a vă asigura traficul site-ului. Pentru a obține un certificat SSL de la Let's Encrypt, vom folosi clientul Acme.sh. Acme.sh este un script shell pur UNIX pentru obținerea certificatelor SSL de la Let's Encrypt cu zero dependențe. Acest lucru îl face foarte ușor în comparație cu alți clienți ai protocolului Acme care necesită multe dependențe pentru a rula cu succes.

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
# v2.7.9

Obțineți certificate RSA și ECDSA pentru numele dvs. de nume / 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 următoarele directoare:

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

NOTĂ : Nu uitați să înlocuiți wiki.example.comcu numele dvs. de domeniu.

După obținerea certificatelor de la Let's Encrypt, trebuie să configuram Nginx pentru a profita de ele.

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

Puteți rula următoarea comandă pentru a vizualiza versiunea actuală instalată de Wiki.js.

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 să navigați 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 au fost salvate în config.ymlfișier. Expertul de configurare va porni automat Wiki.js pentru dvs.

Configurare PM2

În mod implicit, Wiki.js nu va porni automat după repornirea sistemului. Pentru a porni la pornire, trebuie să configurați managerul de proces PM2.

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 rulând comanda.

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

Instanta dvs. Wiki.js rulează ca proces de fundal, folosind PM2 ca manager de proces. Puteți reporni sistemul de operare cu sudo rebootși vă asigurați că Wiki.js începe după o repornire.