Cum se instalează Wiki.js pe Fedora 28

• cerinţe
• Înainte de a începe
• Instalați Node.js
• Instalați MongoDB
• Instalați și configurați Nginx
• Instalați clientul Acme.sh și obțineți certificatul 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ță Fedora 28 Vultr folosind Node.js, MongoDB, PM2, Nginx, Git și Acme.sh.

cerinţe

Cerințele pentru a rula Wiki.js sunt următoarele:

• Node.js versiunea 6.9.0 sau o versiune ulterioară
• MongoDB versiunea 3.2 sau o versiune ulterioară
• Un server web precum Nginx, Apache, IIS, Caddy sau H2O. Acest ghid va folosi Nginx
• Git versiunea 2.7.4 sau mai recentă
• Un depozit conform Git (public sau privat) Acesta este opțional
• Un minim de 768 MB RAM
• Nume de domeniu cu A/ AAAAînregistrări configurate

Înainte de a începe

Verificați versiunea sistemului de operare.

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

Creați un nou cont de utilizator non-root cu acces sudo și treceți la acesta.

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

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

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

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

Setați fusul orar.

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

Instalați pachetele necesare și utile.

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

Pentru simplitate, dezactivați SELinux și Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Instalați Node.js

Wiki.js necesită Node.js 6.9.0 sau o versiune ulterioară, așa că va trebui mai întâi să instalăm Node.js.

Instalează Node.js.

sudo dnf install -y nodejs

Verificați versiunile Node.js și npm.

node -v && npm -v
# v8.11.3
# 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.

Instalați MongoDB.

sudo dnf install -y mongodb mongodb-server

Verificați versiunea MongoDB.

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

Activați și porniți MongoDB.

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

Instalați și configurați Nginx

Wiki.js poate rula fără niciun server web real (cum ar fi Nginx sau Apache). Cu toate acestea, 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 altele. Vom folosi Nginx în acest tutorial, dar orice alt server o va face, trebuie doar să îl configurați corect.

Instalați Nginx.

sudo dnf install -y nginx

Verificați versiunea.

nginx -v
# nginx version: nginx/1.12.1

Activați și porniți Nginx.

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

Configurează Nginx ca proxy invers HTTPsau HTTPS(dacă folosești 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;
    }

}

Singurul lucru pe care trebuie să îl modificaț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 clientul Acme.sh și obțineți certificatul 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 acme.shversiunea.

/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 

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

• Pentru RSA: /etc/letsencrypt/wiki.example.com
• Pentru ECC / ECDSA: /etc/letsencrypt/wiki.example.com_ecc

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

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

}

Verificați configurația.

sudo nginx -t

Reîncărcați Nginx.

sudo systemctl reload nginx.service

Instalați Wiki.js

Creați un dosar rădăcină document gol, unde 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ă configuram PM2 process manager. 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 rulând:

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

În cele din urmă, salvați configurația curentă PM2 rulând comanda: /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.