Com instal·lar Wiki.js a CentOS 7

Wiki.js és una aplicació wiki moderna, gratuïta i de codi obert, construïda a Node.js, MongoDB, Git i Markdown. El codi font de Wiki.js està allotjat públicament a Github . Aquesta guia us mostrarà com instal·lar Wiki.js en una nova instància de CentOS 7 Vultr mitjançant Node.js, MongoDB, PM2, Nginx, Git i Acme.sh.

Requisits

Els requisits per executar Wiki.js són els següents:

• Node.js versió 6.9.0 o posterior
• MongoDB versió 3.2 o posterior
• Nginx
• Git versió 2.7.4 o posterior
• Un dipòsit compatible amb Git (públic o privat) ( opcional )
• Mínim de 768 MB de RAM
• Nom de domini amb A/ AAAAregistres configurats

Comproveu la versió de CentOS.

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

Creeu un non-rootcompte d'usuari nou amb sudoaccés i canvieu-hi.

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

NOTA : Substituïu-lo johndoepel vostre nom d'usuari .

Configura la zona horària.

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

Assegureu-vos que el vostre sistema estigui actualitzat.

sudo yum update -y

Instal·leu els paquets necessaris per acabar aquest tutorial.

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

Desactiveu SELinux i el tallafoc.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Habiliteu el repositori EPEL.

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

Instal·leu Git

Els dipòsits de CentOS proporcionen una versió molt obsoleta de Git, per la qual cosa haurem de crear Git des de la font.

Instal·leu Git construint-lo des del codi font.

# 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 la versió.

git --version
# git version 2.17.1

Instal·leu Node.js

Wiki.js requereix Node.js 6.9.0 o posterior, de manera que primer haurem d'instal·lar Node.js.

Instal·leu Node.js utilitzant el repositori YUM de NodeSource per a Node.js.

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

Comproveu les versions de Node.js i NPM.

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

Instal·leu MongoDB

Wiki.js utilitza MongoDB com a motor de base de dades. Utilitzarem els dipòsits oficials de MongoDB , que contenen les versions més recents i menors de MongoDB.

Instal·leu 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

Comproveu la versió.

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

Activeu i inicieu MongoDB.

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

Instal·leu i configureu Nginx

És molt recomanable posar un servidor web estàndard davant de Wiki.js. Això garanteix que podeu utilitzar funcions com SSL, diversos llocs web, memòria cau i molt més.

Instal·leu 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

Comproveu la versió.

nginx -v
# nginx version: nginx/1.15.0

Activeu i inicieu Nginx.

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

Configureu Nginx com a servidor intermediari HTTPo com a HTTPSproxy invers per a Wiki.js.

Executeu-lo sudo vim /etc/nginx/conf.d/wiki.js.confi empleneu-lo amb la configuració bàsica del servidor intermediari invers a continuació.

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

}

L'únic que necessiteu canviar a la configuració anterior és la server_namedirectiva, i potencialment la proxy_passdirectiva si decidiu configurar qualsevol altre port que no sigui 3000. Wiki.js utilitza port 3000per defecte.

Comproveu la configuració.

sudo nginx -t

Torna a carregar Nginx.

sudo systemctl reload nginx.service

Instal·leu el client Acme.sh i obteniu un certificat Let's Encrypt (opcional)

Protegir el vostre wiki HTTPSno és necessari, però és una bona pràctica per assegurar el trànsit del vostre lloc. Per obtenir un certificat SSL de Let's Encrypt, utilitzarem el client Acme.sh. Acme.sh és un script d'intèrpret d'ordres UNIX pur per obtenir certificats SSL de Let's Encrypt amb zero dependències. Això fa que sigui molt lleuger en comparació amb altres clients de protocol Acme que requereixen moltes dependències per funcionar amb èxit.

Descarregar i instal·lar 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 ~

Comproveu la versió.

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

Obteniu certificats RSA i ECDSA per al vostre domini/nom d'amfitrió.

# 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 

Després d'executar les ordres anteriors, els vostres certificats i claus estaran als directoris següents:

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

NOTA : No oblideu substituir-lo wiki.example.compel vostre nom de domini.

Després d'obtenir els certificats de Let's Encrypt, hem de configurar Nginx per aprofitar-los.

sudo vim /etc/nginx/conf.d/wiki.js.confTorna a executar i configura Nginx com a HTTPSservidor intermediari 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;
    }

}

Comproveu la configuració.

sudo nginx -t

Torna a carregar Nginx.

sudo systemctl reload nginx.service

Instal·leu Wiki.js

Creeu una carpeta arrel del document buida on s'hauria d'instal·lar Wiki.js.

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

Navegueu a la carpeta arrel del document.

cd /var/www/wiki.example.com

Canvia la propietat de la /var/www/wiki.example.comcarpeta a usuari johndoe.

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

Des de la /var/www/wiki.example.comcarpeta, executeu l'ordre següent per descarregar i instal·lar Wiki.js.

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

Podeu executar l'ordre següent per veure la versió instal·lada actualment de Wiki.js.

node wiki --version
# 1.0.78

Un cop finalitzada la instal·lació, se us demanarà que executeu l'assistent de configuració.

Inicieu l'assistent de configuració.

node wiki configure

Això us avisarà per navegar http://localhost:3000per configurar Wiki.js. Si teniu Nginx davant de Wiki.js, podeu obrir el vostre nom de domini (p http://wiki.example.com. ex. ) en lloc d'anar a localhost.

Amb el vostre navegador web, navegueu http://wiki.example.comi seguiu les instruccions que apareixen a la pantalla. Tots els paràmetres que es van introduir durant l'assistent de configuració s'han desat al config.ymlfitxer. L'assistent de configuració iniciarà automàticament el Wiki.js.

Configuració PM2

Per defecte, Wiki.js no s'iniciarà automàticament després d'un reinici del sistema. Per tal que s'iniciï a l'arrencada, hem de configurar el gestor de processos PM2.

Digueu a PM2 que es configure com a servei d'inici.

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

Finalment, deseu la configuració actual de PM2 executant l'ordre.

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

La vostra instància de Wiki.js s'executa com a procés en segon pla, utilitzant PM2 com a gestor de processos. Podeu reiniciar el vostre sistema operatiu amb sudo rebootWiki.js i assegurar-vos que s'iniciï després d'un reinici.