Requisits
Abans que comencis
Instal·leu Node.js
Instal·leu MongoDB
Instal·leu i configureu Nginx
Instal·leu el client Acme.sh i obteniu el certificat Let's Encrypt (opcional)
Instal·leu Wiki.js
Configuració PM2
Wiki.js és una aplicació wiki moderna de codi obert i gratuïta 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 Fedora 28 Vultr utilitzant 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
- Un servidor web com Nginx, Apache, IIS, Caddy o H2O. Aquesta guia utilitzarà Nginx
- Git versió 2.7.4 o posterior
- Un dipòsit compatible amb Git (públic o privat) Això és opcional
- Un mínim de 768 MB de RAM
- Nom de domini amb
A/ AAAAregistres configurats
Abans que comencis
Comproveu la versió del sistema operatiu.
cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)
Creeu un nou compte d'usuari no root amb accés sudo 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.
Assegureu-vos que el vostre sistema estigui actualitzat.
sudo dnf check-upgrade || sudo dnf upgrade -y
Configura la zona horària.
timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'
Instal·leu els paquets necessaris i útils.
sudo dnf install -y wget vim unzip bash-completion git
Per simplificar, desactiveu SELinux i Firewall.
sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld
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.
sudo dnf install -y nodejs
Comproveu les versions de Node.js i npm.
node -v && npm -v
# v8.11.3
# 5.6.0
Instal·leu MongoDB
Wiki.js utilitza MongoDB com a motor de base de dades. D'acord amb això, haurem d'instal·lar MongoDB al nostre servidor.
Instal·leu MongoDB.
sudo dnf install -y mongodb mongodb-server
Comproveu la versió de MongoDB.
mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.3
# db version v3.6.3
Activeu i inicieu MongoDB.
sudo systemctl enable mongod.service
sudo systemctl start mongod.service
Wiki.js es pot executar sense cap servidor web real (com Nginx o Apache). Tanmateix, é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 altres. Utilitzarem Nginx en aquest tutorial, però qualsevol altre servidor ho farà, només cal que el configureu correctament.
Instal·leu Nginx.
sudo dnf install -y nginx
Comproveu la versió.
nginx -v
# nginx version: nginx/1.12.1
Activeu i inicieu Nginx.
sudo systemctl enable nginx.service
sudo systemctl start nginx.service
Configureu Nginx com a servidor intermediari invers HTTPo HTTPS(si feu servir SSL) per a l'aplicació 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 algun port diferent de 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 el 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 programari shell 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 your_email@example.com
cd ~
Comproveu la acme.shversió.
/etc/letsencrypt/acme.sh --version
# v2.7.9
Obteniu els certificats RSA i ECDSA per a 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 your_email@example.com --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 your_email@example.com --ocsp-must-staple --keylength ec-256
Després d'executar les ordres anteriors, els vostres certificats i claus estaran a:
- 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ó executant-lo.
node wiki configure
Això us avisarà per navegar http://localhost:3000per configurar Wiki.js. Si teniu Nginx davant de Wiki.js, vol dir que 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 introduïts durant l'assistent de configuració es guarden 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 comenci a l'arrencada, hem de configurar el gestor de processos PM2. PM2 ve inclòs amb Wiki.js com a mòdul NPM local, de manera que no necessitem instal·lar PM2 globalment.
Digueu a PM2 que es configure com a servei d'inici executant:
/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.