Requisits
Instal·leu Git
Instal·leu Node.js
Instal·leu MongoDB
Instal·leu i configureu Nginx
Instal·leu el client Acme.sh i obteniu un certificat Let's Encrypt (opcional)
Instal·leu Wiki.js
Instal·leu PM2
Wiki.js és una aplicació wiki moderna, gratuïta i de codi obert, construïda a Node.js , 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 Vultr d'Ubuntu 18.04 LTS mitjançant Node.js, MongoDB, PM2, Nginx, Git i Acme.sh.
Requisits
Els requisits per executar Wiki.js i acabar aquesta guia 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
- Mínim de 768 MB de RAM
- Nom de domini amb
A/ AAAAregistres configurats
Comproveu la versió d'Ubuntu.
lsb_release -ds
# Ubuntu 18.04.4 LTS
Creeu un non-rootcompte d'usuari nou amb sudoaccés i canvieu-hi.
adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe
NOTA : Substituïu-lo johndoepel vostre nom d'usuari.
Configura la zona horària.
sudo dpkg-reconfigure tzdata
Assegureu-vos que el vostre sistema estigui actualitzat.
sudo apt update && sudo apt upgrade -y
Instal·leu els paquets necessaris.
sudo apt install -y build-essential apt-transport-https
Instal·leu Git
Git 2.7.4 ve preinstal·lat a l'edició del servidor Ubuntu, de manera que no cal que l'instal·lem. Si voleu instal·lar una versió més nova, podeu utilitzar PPA de tercers o compilar la darrera versió de Git des de la font.
Podeu verificar la versió de Git instal·lada actualment executant:
git --version
# git version 2.7.4
Si voleu instal·lar una versió més nova del programari Git, podeu utilitzar el següent.
# 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 versió de Git.
git --version
# git version 2.17.0
Instal·leu Node.js
Instal·leu Node.js utilitzant el dipòsit APT de NodeSource per a Node.js.
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt install -y nodejs
Comproveu les versions de Node.js i NPM.
node -v && npm -v
# v8.11.2
# 5.6.0
Instal·leu MongoDB
Utilitzarem els dipòsits oficials de MongoDB , que es mantenen actualitzats amb les versions més recents i menors de MongoDB.
Instal·leu MongoDB Community Edition.
sudo apt install -y mongodb
Comproveu la versió.
mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.3
# db version v3.6.3
Instal·leu 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
Comproveu la versió.
sudo 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 invers 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 qualsevol altre port a més 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ò assegurarà el trànsit del vostre lloc. Acme.sh és un programari shell Unix pur per obtenir certificats SSL de Let's Encrypt amb zero dependències.
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 versió.
/etc/letsencrypt/acme.sh --version
Obteniu certificats RSA i ECDSA per a wiki.example.comdomini/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 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: el
/etc/letsencrypt/wiki.example.comdirectori.
- Per a ECC/ECDSA: el
/etc/letsencrypt/wiki.example.com_eccdirectori.
Després d'obtenir els certificats de Let's Encrypt, hem de configurar Nginx per utilitzar-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 l'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
Per veure la versió instal·lada actualment de Wiki.js, podeu executar l'ordre següent.
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 introduïts durant l'assistent de configuració es desaran al config.ymlfitxer. L'assistent de configuració iniciarà automàticament el Wiki.js.
Instal·leu 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 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.
/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup
Finalment, deseu la configuració actual del PM2.
/var/www/wiki.example.com/node_modules/pm2/bin/pm2 save
Wiki.js s'executa com a procés en segon pla, utilitzant PM2 com a gestor de processos.