Wiki.js:n asentaminen Fedora 28:aan

Wiki.js on ilmainen ja avoimen lähdekoodin moderni wikisovellus, joka on rakennettu Node.js:lle, MongoDB:lle, Gitille ja Markdownille. Wiki.js-lähdekoodia isännöidään julkisesti Githubissa . Tämä opas näyttää, kuinka Wiki.js asennetaan uuteen Fedora 28 Vultr -esiintymään käyttämällä Node.js:ää, MongoDB:tä, PM2:ta, Nginxiä, Gitiä ja Acme.sh:ta.

Vaatimukset

Wiki.js:n suorittamisen vaatimukset ovat seuraavat:

• Node.js-versio 6.9.0 tai uudempi
• MongoDB versio 3.2 tai uudempi
• Verkkopalvelin, kuten Nginx, Apache, IIS, Caddy tai H2O. Tämä opas käyttää Nginxiä
• Git versio 2.7.4 tai uudempi
• Git-yhteensopiva arkisto (julkinen tai yksityinen) Tämä on valinnainen
• Vähintään 768 Mt RAM-muistia
• Verkkotunnuksen nimi A/ AAAAtietueet määritetty

Ennen kuin aloitat

Tarkista käyttöjärjestelmän versio.

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

Luo uusi ei-root-käyttäjätili, jossa on sudo-käyttöoikeus, ja vaihda siihen.

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

HUOMAA: Korvaa johndoekäyttäjätunnuksellasi.

Varmista, että järjestelmäsi on ajan tasalla.

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

Aseta aikavyöhyke.

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

Asenna tarvittavat ja hyödylliset paketit.

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

Yksinkertaisuuden vuoksi poista SELinux ja palomuuri käytöstä.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Asenna Node.js

Wiki.js vaatii Node.js 6.9.0:n tai uudemman, joten meidän on ensin asennettava Node.js.

Asenna Node.js.

sudo dnf install -y nodejs

Tarkista Node.js- ja npm-versiot.

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

Asenna MongoDB

Wiki.js käyttää MongoDB:tä tietokantamoottorina. Sen mukaan meidän on asennettava MongoDB palvelimellemme.

Asenna MongoDB.

sudo dnf install -y mongodb mongodb-server

Tarkista MongoDB-versio.

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

Ota käyttöön ja käynnistä MongoDB.

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

Asenna ja määritä Nginx

Wiki.js voi toimia ilman varsinaista verkkopalvelinta (kuten Nginx tai Apache). On kuitenkin erittäin suositeltavaa asettaa tavallinen verkkopalvelin Wiki.js:n eteen. Tämä varmistaa, että voit käyttää ominaisuuksia, kuten SSL:ää, useita verkkosivustoja, välimuistia ja muita. Käytämme Nginxiä tässä opetusohjelmassa, mutta mikä tahansa muu palvelin käy, sinun on vain määritettävä se oikein.

Asenna Nginx.

sudo dnf install -y nginx

Tarkista versio.

nginx -v
# nginx version: nginx/1.12.1

Ota käyttöön ja käynnistä Nginx.

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

Määritä Nginx käänteiseksi välityspalvelimeksi HTTPtai HTTPS(jos käytät SSL:ää) Wiki.js-sovellukselle.

Suorita sudo vim /etc/nginx/conf.d/wiki.js.confja täytä se alla olevilla käänteisen välityspalvelimen perusmäärityksellä.

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

}

Ainoa asia, jota sinun on muutettava yllä olevassa konfiguraatiossa, on server_namedirektiivi ja mahdollisesti proxy_passdirektiivi, jos päätät määrittää jonkin muun portin kuin 3000. Wiki.js käyttää porttia 3000oletuksena.

Tarkista kokoonpano.

sudo nginx -t

Lataa Nginx uudelleen.

sudo systemctl reload nginx.service

Asenna Acme.sh-asiakas ja hanki Let's Encrypt -sertifikaatti (valinnainen)

Wikin suojaaminen HTTPSei ole välttämätöntä, mutta se on hyvä käytäntö suojata sivustosi liikenne. SSL-sertifikaatin hankkimiseksi Let's Encryptiltä käytämme Acme.sh-asiakasta. Acme.sh on puhdas unix-kuoriohjelmisto SSL-sertifikaattien hankkimiseen Let's Encryptistä ilman riippuvuutta. Tämä tekee siitä erittäin kevyen verrattuna joihinkin muihin ACME-protokollaasiakkaisiin, jotka vaativat paljon riippuvuuksia toimiakseen onnistuneesti.

Lataa ja asenna 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 ~

Tarkista acme.shversio.

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

Hanki RSA- ja ECDSA-sertifikaatit 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 

Yllä olevien komentojen suorittamisen jälkeen varmenteesi ja avaimesi ovat:

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

HUOMAA : Älä unohda korvata wiki.example.comverkkotunnustasi.

Kun olemme saaneet sertifikaatit Let's Encryptiltä, ​​meidän on määritettävä Nginx hyödyntämään niitä.

Suorita sudo vim /etc/nginx/conf.d/wiki.js.confuudelleen ja määritä Nginx HTTPSkäänteiseksi välityspalvelimeksi.

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

}

Tarkista kokoonpano.

sudo nginx -t

Lataa Nginx uudelleen.

sudo systemctl reload nginx.service

Asenna Wiki.js

Luo tyhjä asiakirjan juurikansio, johon Wiki.js tulee asentaa.

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

Siirry asiakirjan juurikansioon.

cd /var/www/wiki.example.com

Vaihda /var/www/wiki.example.comkansion omistajuus käyttäjäksi johndoe.

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

Vuodesta /var/www/wiki.example.comkansioon, suorita seuraava komento lataa ja asentaa Wiki.js.

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

Voit suorittaa seuraavan komennon nähdäksesi tällä hetkellä asennetun Wiki.js-version.

node wiki --version
# 1.0.78

Kun asennus on valmis, sinua kehotetaan suorittamaan ohjattu määritystoiminto.

Käynnistä ohjattu määritystoiminto suorittamalla.

node wiki configure

Tämä kehottaa sinua navigoimaan http://localhost:3000Wiki.js:n määrittämistä varten. Jos sinulla on Nginx Wiki.js:n edessä, se tarkoittaa, että voit avata verkkotunnuksesi (esim. http://wiki.example.com) osoitteen sijaan localhost.

Siirry verkkoselaimella kohtaan http://wiki.example.comja seuraa näytön ohjeita. Kaikki ohjatun konfigurointitoiminnon aikana tehdyt asetukset tallennetaan config.ymltiedostoon. Ohjattu määritystoiminto käynnistää automaattisesti Wiki.js:n puolestasi.

Asenna PM2

Oletusarvoisesti Wiki.js ei käynnisty automaattisesti järjestelmän uudelleenkäynnistyksen jälkeen. Jotta se käynnistyisi käynnistyksen yhteydessä, meidän on asennettava PM2-prosessinhallinta. PM2 toimitetaan Wiki.js:n mukana paikallisena NPM-moduulina, joten meidän ei tarvitse asentaa PM2:ta maailmanlaajuisesti.

Pyydä PM2:ta määrittämään itsensä käynnistyspalveluksi suorittamalla:

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

Lopuksi tallenna nykyinen PM2-kokoonpano suorittamalla komento: /var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

Wiki.js-esiintymäsi toimii taustaprosessina ja käyttää PM2:ta prosessinhallinnanaan.