Wiki.js è un'app wiki moderna e gratuita open source costruita su Node.js , 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 Ubuntu 18.04 LTS Vultr usando Node.js, MongoDB, PM2, Nginx, Git e Acme.sh.
Requisiti
I requisiti per eseguire Wiki.js e completare questa guida 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
- Almeno 768 MB di RAM
- Nome dominio con
A
/ AAAA
record impostati
Controlla la versione di Ubuntu.
lsb_release -ds
# Ubuntu 18.04.4 LTS
Crea un nuovo non-root
account utente con sudo
accesso e passa ad esso.
adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe
NOTA : sostituisci johndoe
con il tuo nome utente.
Imposta il fuso orario.
sudo dpkg-reconfigure tzdata
Assicurati che il tuo sistema sia aggiornato.
sudo apt update && sudo apt upgrade -y
Installa i pacchetti necessari.
sudo apt install -y build-essential apt-transport-https
Installa Git
Git 2.7.4 viene preinstallato sull'edizione del server Ubuntu, quindi non è necessario installarlo. Se vuoi installare una versione più recente, puoi usare PPA di terze parti o compilare l'ultima versione di Git dal sorgente.
Puoi verificare la versione attualmente installata di Git eseguendo:
git --version
# git version 2.7.4
Se si desidera installare una versione più recente del software Git, è possibile utilizzare quanto segue.
# Remove existing git package
sudo apt remove -y git
sudo apt-get install software-properties-common
sudo add-apt-repository -y ppa:git-core/ppa
sudo apt update && sudo apt upgrade -y
sudo apt install -y git
Verifica la versione di Git.
git --version
# git version 2.17.0
Installa Node.js
Installa Node.js utilizzando il repository APT NodeSource per Node.js.
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt install -y nodejs
Controlla le versioni Node.js e NPM.
node -v && npm -v
# v8.11.2
# 5.6.0
Installa MongoDB
Useremo i repository MongoDB ufficiali , che sono tenuti aggiornati con le versioni principali e minori MongoDB più recenti.
Installa MongoDB Community Edition.
sudo apt install -y mongodb
Controlla la versione
mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.3
# db version v3.6.3
Installa Nginx.
wget https://nginx.org/keys/nginx_signing.key
sudo apt-key add nginx_signing.key
rm nginx_signing.key
sudo -s
printf "deb https://nginx.org/packages/mainline/ubuntu/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/ubuntu/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx
Controlla la versione
sudo 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 per l'applicazione Wiki.js.
Eseguilo sudo vim /etc/nginx/conf.d/wiki.js.conf
e 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 modificare nella configurazione sopra è la server_name
direttiva e potenzialmente la proxy_pass
direttiva se decidi di configurare qualsiasi altra porta oltre 3000
. Wiki.js utilizza la porta 3000
per 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)
HTTPS
Non è necessario proteggere la tua wiki con , ma proteggerà il traffico del tuo sito. Acme.sh è un software di shell unix puro per ottenere certificati SSL da Let's Encrypt con zero dipendenze.
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
Ottieni certificati RSA ed ECDSA per wiki.example.com
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 sopra, i certificati e le chiavi saranno in:
- Per RSA: la
/etc/letsencrypt/wiki.example.com
directory.
- Per ECC / ECDSA: la
/etc/letsencrypt/wiki.example.com_ecc
directory.
Dopo aver ottenuto i certificati da Let's Encrypt, dobbiamo configurare Nginx per usarli.
Esegui di sudo vim /etc/nginx/conf.d/wiki.js.conf
nuovo e configura Nginx come HTTPS
proxy 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.com
cartella per l'utente johndoe
.
sudo chown -R johndoe:johndoe /var/www/wiki.example.com
Dalla /var/www/wiki.example.com
cartella, eseguire il comando seguente per scaricare e installare Wiki.js.
curl -sSo- https://wiki.js.org/install.sh | bash
Per visualizzare la versione attualmente installata di Wiki.js, è possibile eseguire il comando seguente.
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:3000
per 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.com
e seguire le istruzioni visualizzate. Tutte le impostazioni immesse durante la procedura guidata di configurazione vengono salvate nel config.yml
file. La procedura guidata di configurazione avvierà automaticamente Wiki.js per te.
Installa PM2
Per impostazione predefinita, Wiki.js non si avvia automaticamente dopo il riavvio del sistema. Per avviarlo all'avvio, è necessario impostare 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.
/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup
Infine, salva la configurazione corrente di PM2.
/var/www/wiki.example.com/node_modules/pm2/bin/pm2 save
Wiki.js viene eseguito come processo in background, utilizzando PM2 come gestore dei processi.