Cum se instalează Wiki.js pe Debian 9

• cerinţe
• Instalați Git
• Instalați Node.js
• Instalați MongoDB
• Instalați și configurați Nginx
• Instalați Acme.sh și obțineți un certificat Let's Encrypt (opțional)
• Instalați Wiki.js
• Configurare PM2

Wiki.js este o aplicație wiki modernă, gratuită și deschisă, construită pe Node.js, MongoDB, Git și Markdown. Codul sursă Wiki.js este găzduit public pe GitHub . Acest ghid vă va arăta cum să instalați Wiki.js pe o nouă instanță Debian 9 Vultr folosind Node.js, MongoDB, PM2, Nginx, Git și Acme.sh.

cerinţe

• Node.js 6.9.0 sau o versiune ulterioară
• MongoDB 3.2 sau o versiune ulterioară
• Nginx
• Git 2.7.4 sau mai recent
• Un depozit conform Git (public sau privat) ( opțional )
• Minim de 768MB RAM
• Nume de domeniu cu A/ AAAAînregistrări configurate

Verificați versiunea Debian.

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

Asigurați-vă că sistemul dvs. este actualizat.

apt update && apt upgrade -y

Instalați pachetele necesare.

apt install -y build-essential apt-transport-https sudo curl wget dirmngr sudo

Creați un non-rootcont de utilizator nou cu sudoacces și treceți la acesta.

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

NOTĂ : Înlocuiți johndoecu numele de utilizator.

Setați fusul orar.

sudo dpkg-reconfigure tzdata

Instalați Git

Instalați Git pe Debian.

sudo apt install -y git

Verificați versiunea Git.

git --version
# git version 2.11.0

Instalați Node.js

Instalați Node.js folosind depozitul NodeSource APT pentru Node.js.

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt install -y nodejs

Verificați versiunile Node.js și npm.

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

Instalați MongoDB

Wiki.js folosește MongoDB ca motor de bază de date. Conform acestui fapt, va trebui să instalăm MongoDB pe serverul nostru. Vom folosi depozitele oficiale MongoDB pentru instalare.

Instalează MongoDB Community Edition.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/3.6 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
sudo apt update
sudo apt install -y mongodb-org

Verificați versiunea.

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

Activați și porniți MongoDB.

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

Instalați și configurați Nginx

Este foarte recomandat să puneți un server web standard în fața Wiki.js. Acest lucru vă asigură că puteți utiliza funcții precum SSL, mai multe site-uri web, memorie în cache și multe altele. Vom folosi Nginx în acest tutorial, dar orice alt server o va face, trebuie doar să îl configurați corect.

Instalați 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/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx

Verificați versiunea.

sudo nginx -v
# nginx version: nginx/1.15.0

Activați și porniți Nginx.

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

Configurați Nginx ca proxy invers HTTPsau HTTPS(dacă utilizați SSL) pentru aplicația Wiki.js.

Rulați sudo vim /etc/nginx/conf.d/wiki.js.confși populați-l cu configurația de bază a proxy-ului invers de mai jos.

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

}

Singurele lucruri pe care trebuie să le schimbați în configurația de mai sus este server_namedirectiva și, eventual, proxy_passdirectiva dacă decideți să configurați un alt port decât 3000. Wiki.js utilizează 3000implicit portul .

Verificați configurația.

sudo nginx -t

Reîncărcați Nginx.

sudo systemctl reload nginx.service

Instalați Acme.sh și obțineți un certificat Let's Encrypt (opțional)

Securizarea wiki-ului dvs. HTTPSnu este necesară, dar este o practică bună pentru a vă asigura traficul site-ului. Pentru a obține un certificat SSL de la Let's Encrypt vom folosi clientul Acme.sh. Acme.sh este un software pur shell unix pentru obținerea certificatelor SSL de la Let's Encrypt cu zero dependențe. Acest lucru îl face foarte ușor în comparație cu alți clienți ai protocolului ACME care necesită multe dependențe pentru a rula cu succes.

Descărcați și instalați 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 ~

Verificați versiunea.

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

Obțineți certificate RSA și ECDSA pentru 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 

NOTĂ : Nu uitați să înlocuiți wiki.example.comcu numele dvs. de domeniu.

După executarea comenzilor de mai sus, certificatele și cheile dvs. vor fi în următoarele directoare.

• Pentru RSA: /etc/letsencrypt/wiki.example.comdirector.
• Pentru ECC / ECDSA: /etc/letsencrypt/wiki.example.com_eccdirector.

După obținerea certificatelor de la Let's Encrypt, trebuie să configuram Nginx pentru a profita de ele.

Rulați sudo vim /etc/nginx/conf.d/wiki.js.confdin nou și configurați Nginx ca HTTPSproxy 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/example.com.key;
    # ECDSA
    ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/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;
    }

}

Verificați configurația.

sudo nginx -t

Reîncărcați Nginx.

sudo systemctl reload nginx.service

Instalați Wiki.js

Creați un folder rădăcină de document gol în care ar trebui instalat Wiki.js.

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

Navigați la folderul rădăcină al documentului.

cd /var/www/wiki.example.com

Schimbați proprietatea /var/www/wiki.example.comfolderului în utilizator johndoe.

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

Din /var/www/wiki.example.comfolder, executați următoarea comandă pentru a descărca și instala Wiki.js.

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

Puteți rula următoarea comandă pentru a vizualiza versiunea actuală instalată de Wiki.js.

node wiki --version
# 1.0.78

După terminarea instalării, vi se va solicita să executați asistentul de configurare.

Porniți asistentul de configurare rulând.

node wiki configure

Acest lucru vă va notifica să navigați pentru http://localhost:3000a configura Wiki.js. Dacă aveți Nginx în fața Wiki.js, atunci înseamnă că puteți deschide numele de domeniu (de exemplu http://wiki.example.com) în loc să mergeți la localhost.

Utilizând browserul dvs. web, navigați la http://wiki.example.comși urmați instrucțiunile de pe ecran. Toate setările introduse în timpul asistentului de configurare sunt salvate în config.ymlfișier. Expertul de configurare va porni automat Wiki.js pentru dvs.

Configurare PM2

În mod implicit, Wiki.js nu va porni automat după repornirea sistemului. Pentru a porni la pornire, trebuie să configurați managerul de proces PM2. PM2 vine în pachet cu Wiki.js ca un modul NPM local, deci nu trebuie să instalăm PM2 la nivel global.

Spuneți PM2 să se configureze ca serviciu de pornire.

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

În cele din urmă, salvați configurația curentă PM2.

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

Instanta dvs. Wiki.js rulează ca proces de fundal, folosind PM2 ca manager de proces. Puteți reporni sistemul de operare cu sudo rebootși verifica dacă Wiki.js începe după o repornire.