Kaip įdiegti Wiki.js „Fedora 28“.

Wiki.js yra nemokama atvirojo kodo moderni wiki programa, sukurta naudojant Node.js, MongoDB, Git ir Markdown. Wiki.js šaltinio kodas viešai priglobtas Github . Šiame vadove bus parodyta, kaip įdiegti Wiki.js naujame Fedora 28 Vultr egzemplioriuje naudojant Node.js, MongoDB, PM2, Nginx, Git ir Acme.sh.

Reikalavimai

Reikalavimai norint paleisti Wiki.js yra šie:

• Node.js 6.9.0 arba naujesnė versija
• MongoDB 3.2 ar naujesnė versija
• Žiniatinklio serveris, pvz., Nginx, Apache, IIS, Caddy arba H2O. Šiame vadove bus naudojamas Nginx
• Git versija 2.7.4 arba naujesnė
• Su Git suderinama saugykla (vieša arba privati) Tai neprivaloma
• Mažiausiai 768 MB RAM
• Domeno vardas su nustatyta A/ AAAAįrašais

Prieš tau pradedant

Patikrinkite OS versiją.

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

Sukurkite naują ne root vartotojo paskyrą su sudo prieiga ir perjunkite į ją.

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

PASTABA: pakeiskite johndoesavo vartotojo vardu.

Įsitikinkite, kad jūsų sistema yra atnaujinta.

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

Nustatykite laiko juostą.

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

Įdiekite reikalingus ir naudingus paketus.

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

Kad būtų paprasčiau, išjunkite SELinux ir ugniasienę.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Įdiekite Node.js

Wiki.js reikalinga Node.js 6.9.0 arba naujesnė versija, todėl pirmiausia turėsime įdiegti Node.js.

Įdiekite Node.js.

sudo dnf install -y nodejs

Patikrinkite Node.js ir npm versijas.

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

Įdiekite MongoDB

Wiki.js naudoja MongoDB kaip duomenų bazės variklį. Atsižvelgiant į tai, savo serveryje turėsime įdiegti MongoDB.

Įdiekite MongoDB.

sudo dnf install -y mongodb mongodb-server

Patikrinkite MongoDB versiją.

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

Įgalinkite ir paleiskite MongoDB.

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

Įdiekite ir sukonfigūruokite „Nginx“.

Wiki.js gali veikti be jokio tikrojo žiniatinklio serverio (pvz., Nginx ar Apache). Tačiau labai rekomenduojama prieš Wiki.js įdėti standartinį žiniatinklio serverį. Tai užtikrina, kad galite naudoti tokias funkcijas kaip SSL, kelios svetainės, talpyklos kaupimas ir kt. Šioje pamokoje naudosime Nginx, bet tiks bet kuris kitas serveris, tereikia jį tinkamai sukonfigūruoti.

Įdiekite „Nginx“.

sudo dnf install -y nginx

Patikrinkite versiją.

nginx -v
# nginx version: nginx/1.12.1

Įgalinkite ir paleiskite „Nginx“.

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

Sukonfigūruokite „Nginx“ kaip „Wiki.js“ programos atvirkštinį tarpinį serverį HTTParba HTTPS(jei naudojate SSL).

Paleiskite sudo vim /etc/nginx/conf.d/wiki.js.confir užpildykite jį naudodami toliau pateiktą pagrindinę atvirkštinio tarpinio serverio konfigūraciją.

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

}

Vienintelis dalykas, kurį reikia pakeisti aukščiau pateiktoje konfigūracijoje, yra server_namedirektyva ir galbūt proxy_passdirektyva, jei nuspręsite sukonfigūruoti kitą prievadą nei 3000. Wiki.js 3000pagal numatytuosius nustatymus naudoja prievadą .

Patikrinkite konfigūraciją.

sudo nginx -t

Iš naujo įkelti Nginx.

sudo systemctl reload nginx.service

Įdiekite Acme.sh klientą ir gaukite Let's Encrypt sertifikatą (neprivaloma)

Apsaugoti savo wiki HTTPSnebūtina, tačiau tai yra gera praktika siekiant apsaugoti svetainės srautą. Norėdami gauti SSL sertifikatą iš Let's Encrypt, naudosime Acme.sh klientą. Acme.sh yra gryna unix apvalkalo programinė įranga, skirta gauti SSL sertifikatus iš Let's Encrypt be jokių priklausomybių. Dėl to jis labai lengvas, palyginti su kai kuriais kitais ACME protokolo klientais, kuriems norint sėkmingai veikti, reikia daug priklausomybių.

Atsisiųskite ir įdiekite 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 ~

Patikrinkite acme.shversiją.

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

Gaukite RSA ir ECDSA sertifikatus 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 [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 

Paleidus aukščiau nurodytas komandas, jūsų sertifikatai ir raktai bus:

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

PASTABA : nepamirškite pakeisti wiki.example.comsavo domeno pavadinimu.

Gavę sertifikatus iš Let's Encrypt, turime sukonfigūruoti Nginx, kad galėtume jais pasinaudoti.

Paleiskite sudo vim /etc/nginx/conf.d/wiki.js.confdar kartą ir sukonfigūruokite „Nginx“ kaip HTTPSatvirkštinį tarpinį serverį.

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

}

Patikrinkite konfigūraciją.

sudo nginx -t

Iš naujo įkelti Nginx.

sudo systemctl reload nginx.service

Įdiekite Wiki.js

Sukurkite tuščią dokumento šakninį aplanką, kuriame turėtų būti įdiegtas Wiki.js.

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

Eikite į dokumento šakninį aplanką.

cd /var/www/wiki.example.com

Pakeiskite /var/www/wiki.example.comaplanko nuosavybės teisę į vartotoją johndoe.

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

Iš /var/www/wiki.example.comaplanko paleiskite šią komandą, kad atsisiųstumėte ir įdiegtumėte Wiki.js.

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

Norėdami peržiūrėti šiuo metu įdiegtą Wiki.js versiją, galite paleisti šią komandą.

node wiki --version
# 1.0.78

Kai diegimas bus baigtas, būsite paraginti paleisti konfigūracijos vedlį.

Paleiskite konfigūracijos vedlį paleisdami.

node wiki configure

Tai jums praneš, kad reikia pereiti prie http://localhost:3000Wiki.js konfigūravimo. Jei turite Nginx prieš Wiki.js, tai reiškia, kad galite atidaryti savo domeno pavadinimą (pvz., http://wiki.example.com), o ne eiti į localhost.

Naudodami žiniatinklio naršyklę eikite į http://wiki.example.comir vykdykite ekrane pateikiamas instrukcijas. Visi konfigūracijos vedlio metu įvesti nustatymai išsaugomi config.ymlfaile. Konfigūracijos vedlys automatiškai paleis Wiki.js už jus.

Nustatykite PM2

Pagal numatytuosius nustatymus Wiki.js nebus paleistas automatiškai po sistemos perkrovimo. Kad jis prasidėtų įkrovos metu, turime nustatyti PM2 proceso tvarkyklę. PM2 pateikiamas kartu su Wiki.js kaip vietiniu NPM moduliu, todėl mums nereikia diegti PM2 visame pasaulyje.

Nurodykite PM2 konfigūruoti save kaip paleisties paslaugą, paleisdami:

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

Galiausiai išsaugokite dabartinę PM2 konfigūraciją vykdydami komandą: /var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

Jūsų Wiki.js egzempliorius veikia kaip foninis procesas, naudojant PM2 kaip proceso tvarkyklę.