Come installare Wiki.js su CentOS 7

• Requisiti
• Installa Git
• Installa Node.js
• Installa MongoDB
• Installa e configura Nginx
• Installa il client Acme.sh e ottieni un certificato Let's Encrypt (opzionale)
• Installa Wiki.js
• Setup PM2

Wiki.js è un'applicazione wiki moderna, gratuita e open source, costruita su Node.js, MongoDB, Git e Markdown. Il codice sorgente di Wiki.js è ospitato pubblicamente su Github . Questa guida ti mostrerà come installare Wiki.js su una nuova istanza di CentOS 7 Vultr usando Node.js, MongoDB, PM2, Nginx, Git e Acme.sh.

Requisiti

I requisiti per eseguire Wiki.js sono i seguenti:

• Node.js versione 6.9.0 o successiva
• MongoDB versione 3.2 o successive
• nginx
• Git versione 2.7.4 o successive
• Un repository conforme a Git (pubblico o privato) ( opzionale )
• Almeno 768 MB di RAM
• Nome dominio con A/ AAAArecord impostati

Controlla la versione di CentOS.

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

Crea un nuovo non-rootaccount utente con sudoaccesso e passa ad esso.

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

NOTA : sostituisci johndoecon il tuo nome utente .

Imposta il fuso orario.

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

Assicurati che il tuo sistema sia aggiornato.

sudo yum update -y

Installa i pacchetti necessari per completare questo tutorial.

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

Disabilita SELinux e Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Abilita il repository EPEL.

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

Installa Git

I repository CentOS forniscono una versione molto obsoleta di Git, quindi dovremo creare Git dal sorgente.

Installa Git costruendolo dal codice sorgente.

# 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 versione

git --version
# git version 2.17.1

Installa Node.js

Wiki.js richiede Node.js 6.9.0 o successivo, quindi dovremo prima installare Node.js.

Installa Node.js utilizzando il repository YUM NodeSource per Node.js.

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

Controlla le versioni Node.js e NPM.

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

Installa MongoDB

Wiki.js utilizza MongoDB come motore di database. Useremo i repository MongoDB ufficiali , che contengono le versioni MongoDB principali e minori più recenti.

Installa 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

Controlla la versione

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

Abilita e avvia MongoDB.

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

Installa e configura Nginx

Si consiglia vivamente di mettere un web server standard davanti a Wiki.js. In questo modo è possibile utilizzare funzionalità come SSL, più siti Web, memorizzazione nella cache e altro.

Installa 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

Controlla la versione

nginx -v
# nginx version: nginx/1.15.0

Abilita e avvia Nginx.

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

Configura Nginx come proxy inverso HTTPo HTTPSper Wiki.js.

Eseguilo sudo vim /etc/nginx/conf.d/wiki.js.confe popolalo con la configurazione di base del proxy inverso di seguito.

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'unica cosa che devi cambiare nella configurazione sopra è server_namedirettiva e potenzialmente proxy_passdirettiva se decidi di configurare una porta diversa da quella 3000. Wiki.js utilizza la porta 3000per impostazione predefinita.

Controlla la configurazione.

sudo nginx -t

Ricarica Nginx.

sudo systemctl reload nginx.service

Installa il client Acme.sh e ottieni un certificato Let's Encrypt (opzionale)

HTTPSNon è necessario proteggere la tua wiki , ma è buona norma proteggere il traffico del tuo sito. Per ottenere un certificato SSL da Let's Encrypt, utilizzeremo il client Acme.sh. Acme.sh è uno script di shell UNIX puro per ottenere certificati SSL da Let's Encrypt con zero dipendenze. Ciò lo rende molto leggero rispetto ad altri client con protocollo Acme che richiedono molte dipendenze per funzionare correttamente.

Scaricare e installare 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 ~

Controlla la versione

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

Ottieni i certificati RSA ed ECDSA per il tuo dominio / nome host.

# 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 

Dopo aver eseguito i comandi precedenti, i certificati e le chiavi saranno nelle seguenti directory:

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

NOTA : non dimenticare di sostituire wiki.example.comcon il tuo nome di dominio.

Dopo aver ottenuto i certificati da Let's Encrypt, dobbiamo configurare Nginx per sfruttarli.

Esegui di sudo vim /etc/nginx/conf.d/wiki.js.confnuovo e configura Nginx come HTTPSproxy inverso.

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

}

Controlla la configurazione.

sudo nginx -t

Ricarica Nginx.

sudo systemctl reload nginx.service

Installa Wiki.js

Crea una cartella radice del documento vuota in cui installare Wiki.js.

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

Passare alla cartella principale del documento.

cd /var/www/wiki.example.com

Cambia la proprietà della /var/www/wiki.example.comcartella in utente johndoe.

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

Dalla /var/www/wiki.example.comcartella, eseguire il comando seguente per scaricare e installare Wiki.js.

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

È possibile eseguire il comando seguente per visualizzare la versione attualmente installata di Wiki.js.

node wiki --version
# 1.0.78

Una volta completata l'installazione, ti verrà richiesto di eseguire la procedura guidata di configurazione.

Avviare la procedura guidata di configurazione.

node wiki configure

Questo ti avviserà di navigare http://localhost:3000per configurare Wiki.js. Se hai Nginx davanti a Wiki.js, puoi aprire il tuo nome di dominio (ad es. http://wiki.example.com) Invece di andare localhost.

Utilizzando il browser Web, navigare http://wiki.example.come seguire le istruzioni visualizzate. Tutte le impostazioni inserite durante la procedura guidata di configurazione sono state salvate nel config.ymlfile. La procedura guidata di configurazione avvierà automaticamente Wiki.js per te.

Setup PM2

Per impostazione predefinita, Wiki.js non si avvia automaticamente dopo il riavvio del sistema. Per avviarlo all'avvio, è necessario impostare il gestore processi PM2.

Di 'a PM2 di configurarsi come servizio di avvio.

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

Infine, salva la configurazione corrente di PM2 eseguendo il comando.

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

L'istanza di Wiki.js viene eseguita come processo in background, utilizzando PM2 come gestore dei processi. È possibile riavviare il sistema operativo con sudo reboote assicurarsi che Wiki.js si avvii dopo un riavvio.