Come installare Wiki.js su Fedora 28

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

Wiki.js è un'app 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 Fedora 28 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
• Un server Web come Nginx, Apache, IIS, Caddy o H2O. Questa guida utilizzerà Nginx
• Git versione 2.7.4 o successive
• Un repository conforme a Git (pubblico o privato) Questo è facoltativo
• Almeno 768 MB di RAM
• Nome dominio con A/ AAAArecord impostati

Prima di iniziare

Controlla la versione del sistema operativo.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

Crea un nuovo account utente non root con accesso sudo e passa ad esso.

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

NOTA: sostituisci johndoecon il tuo nome utente.

Assicurati che il tuo sistema sia aggiornato.

sudo dnf check-upgrade || sudo dnf upgrade -y

Imposta il fuso orario.

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

Installa i pacchetti necessari e utili.

sudo dnf install -y wget vim unzip bash-completion git

Per semplicità, disabilitare SELinux e Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Installa Node.js

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

Installa Node.js.

sudo dnf install -y nodejs

Controlla le versioni Node.js e npm.

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

Installa MongoDB

Wiki.js utilizza MongoDB come motore di database. In base a ciò, dovremo installare MongoDB sul nostro server.

Installa MongoDB.

sudo dnf install -y mongodb mongodb-server

Controlla la versione di MongoDB.

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

Abilita e avvia MongoDB.

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

Installa e configura Nginx

Wiki.js può essere eseguito senza alcun server Web effettivo (come Nginx o Apache). Tuttavia, 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 altri. Useremo Nginx in questo tutorial, ma qualsiasi altro server lo farà, devi solo configurarlo correttamente.

Installa Nginx.

sudo dnf install -y nginx

Controlla la versione

nginx -v
# nginx version: nginx/1.12.1

Abilita e avvia Nginx.

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

Configurare Nginx come proxy inverso HTTPo HTTPS(se si utilizza SSL) per l'applicazione 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 è la server_namedirettiva, e potenzialmente la 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 il 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 è un software 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 acme.shversione

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

Ottieni i certificati RSA ed ECDSA per wiki.example.com.

# 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 sopra, i certificati e le chiavi saranno in:

• 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, dove Wiki.js dovrebbe essere installato.

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 eseguendo.

node wiki configure

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

Utilizzando il browser Web, navigare http://wiki.example.come seguire le istruzioni visualizzate. Tutte le impostazioni immesse durante la procedura guidata di configurazione vengono 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. PM2 viene fornito in bundle con Wiki.js come modulo NPM locale, quindi non è necessario installare PM2 a livello globale.

Di 'a PM2 di configurarsi come servizio di avvio eseguendo:

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

Infine, salva la configurazione PM2 corrente 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.