Si të instaloni Wiki.js në CentOS 7

Wiki.js është një aplikacion modern wiki falas dhe me burim të hapur i ndërtuar në Node.js, MongoDB, Git dhe Markdown. Kodi burimor i Wiki.js është i pritur publikisht në Github . Ky udhëzues do t'ju tregojë se si të instaloni Wiki.js në një shembull të ri CentOS 7 Vultr duke përdorur Node.js, MongoDB, PM2, Nginx, Git dhe Acme.sh.

Kërkesat

Kërkesat për të ekzekutuar Wiki.js janë si më poshtë:

• Node.js versioni 6.9.0 ose më i ri
• Versioni i MongoDB 3.2 ose më i ri
• Nginx
• Versioni Git 2.7.4 ose më i ri
• Një depo e përputhshme me Git (publik ose privat) ( opsionale )
• Minimumi 768 MB RAM
• Emri i domenit me A/ AAAAkonfigurimin e regjistrimeve

Kontrolloni versionin CentOS.

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

Krijoni një non-rootllogari të re përdoruesi me sudoakses dhe kaloni në të.

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

SHËNIM : Zëvendësojeni johndoeme emrin tuaj të përdoruesit .

Vendosni zonën kohore.

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

Sigurohuni që sistemi juaj të jetë i përditësuar.

sudo yum update -y

Instaloni paketat e nevojshme për të përfunduar këtë tutorial.

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

Çaktivizo SELinux dhe Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Aktivizo depon e EPEL.

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

Instaloni Git

Depot e CentOS ofrojnë një version shumë të vjetëruar të Git, kështu që do të na duhet të ndërtojmë Git nga burimi.

Instaloni Git duke e ndërtuar atë nga kodi burimor.

# 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

Verifiko versionin.

git --version
# git version 2.17.1

Instaloni Node.js

Wiki.js kërkon Node.js 6.9.0 ose version më të ri, kështu që fillimisht do të na duhet të instalojmë Node.js.

Instaloni Node.js duke përdorur depon e NodeSource YUM për Node.js.

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

Kontrolloni versionet Node.js dhe NPM.

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

Instaloni MongoDB

Wiki.js përdor MongoDB si një motor bazë të dhënash. Ne do të përdorim depot zyrtare të MongoDB , të cilat përmbajnë lëshimet më të fundit kryesore dhe të vogla të MongoDB.

Instaloni 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

Kontrolloni versionin.

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

Aktivizo dhe nis MongoDB.

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

Instaloni dhe konfiguroni Nginx

Rekomandohet shumë që të vendosni një ueb server standard përpara Wiki.js. Kjo siguron që ju të mund të përdorni veçori si SSL, uebsajte të shumta, memorie dhe më shumë.

Instaloni 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

Kontrolloni versionin.

nginx -v
# nginx version: nginx/1.15.0

Aktivizo dhe nis Nginx.

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

Konfiguro Nginx si një përfaqësues HTTPose të HTTPSkundërt për Wiki.js.

Ekzekutoni sudo vim /etc/nginx/conf.d/wiki.js.confdhe plotësoni atë me konfigurimin bazë të përfaqësuesit të kundërt më poshtë.

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

}

E vetmja gjë që duhet të ndryshoni në konfigurimin e mësipërm është server_namedirektiva, dhe potencialisht proxy_passdirektiva nëse vendosni të konfiguroni ndonjë port tjetër përveç 3000. Wiki.js përdor portin si 3000parazgjedhje.

Kontrolloni konfigurimin.

sudo nginx -t

Rifresko Nginx.

sudo systemctl reload nginx.service

Instaloni klientin Acme.sh dhe merrni një certifikatë Let's Encrypt (opsionale)

Securing your wiki with HTTPS is not necessary, but it is a good practice to secure your site traffic. In order to obtain an SSL certificate from Let's Encrypt, we will use Acme.sh client. Acme.sh is a pure UNIX shell script for obtaining SSL certificates from Let's Encrypt with zero dependencies. That makes it very lightweight in comparison to some other Acme protocol clients that require a lot of dependencies to run successfully.

Download and install 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 ~

Check the version.

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

Obtain RSA and ECDSA certificates for your domain/hostname.

# 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 

After running the above commands, your certificates and keys will be in the following directories:

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

NOTE: Don't forget to replace wiki.example.com with your domain name.

Pas marrjes së certifikatave nga Let's Encrypt, duhet të konfigurojmë Nginx për të përfituar prej tyre.

Ekzekutoni sudo vim /etc/nginx/conf.d/wiki.js.confpërsëri dhe konfiguroni Nginx si një HTTPSpërfaqësues të kundërt.

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

}

Kontrolloni konfigurimin.

sudo nginx -t

Rifresko Nginx.

sudo systemctl reload nginx.service

Instaloni Wiki.js

Krijo një dosje të zbrazët rrënjësore të dokumentit ku duhet të instalohet Wiki.js.

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

Navigoni te dosja rrënjë e dokumentit.

cd /var/www/wiki.example.com

Ndrysho pronësinë e /var/www/wiki.example.comdosjes në përdorues johndoe.

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

Nga /var/www/wiki.example.comdosja, ekzekutoni komandën e mëposhtme për të shkarkuar dhe instaluar Wiki.js.

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

Ju mund të ekzekutoni komandën e mëposhtme për të parë versionin e instaluar aktualisht të Wiki.js.

node wiki --version
# 1.0.78

Pasi të përfundojë instalimi, do t'ju kërkohet të ekzekutoni magjistarin e konfigurimit.

Nisni magjistarin e konfigurimit.

node wiki configure

Kjo do t'ju njoftojë për të lundruar për http://localhost:3000të konfiguruar Wiki.js. Nëse keni Nginx përpara Wiki.js, mund të hapni emrin e domenit tuaj (p.sh. http://wiki.example.com) në vend që të shkoni te localhost.

Duke përdorur shfletuesin tuaj të internetit, lundroni http://wiki.example.comdhe ndiqni udhëzimet në ekran. Të gjitha cilësimet që u futën gjatë magjistarit të konfigurimit janë ruajtur në config.ymlskedar. Magjistari i konfigurimit do të nisë automatikisht Wiki.js për ju.

Konfiguro PM2

Si parazgjedhje, Wiki.js nuk do të fillojë automatikisht pas një rindezjeje të sistemit. Për ta bërë atë të fillojë në boot, ne duhet të konfigurojmë menaxherin e procesit PM2.

Thuaji PM2 të konfigurojë veten si një shërbim fillestar.

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

Më në fund, ruani konfigurimin aktual PM2 duke ekzekutuar komandën.

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

Shembulli juaj Wiki.js ekzekutohet si një proces sfondi, duke përdorur PM2 si menaxherin e tij të procesit. Ju mund të rindizni OS tuaj me sudo rebootdhe të siguroheni që Wiki.js të fillojë pas një rindezjeje.