Kuidas installida Wiki.js versiooni Debian 9

Wiki.js on tasuta avatud lähtekoodiga kaasaegne vikirakendus, mis on üles ehitatud Node.js-ile, MongoDB-le, Gitile ja Markdownile. Wiki.js lähtekoodi majutatakse avalikult GitHubis . See juhend näitab teile, kuidas installida Wiki.js värskele Debian 9 Vultr eksemplarile, kasutades Node.js, MongoDB, PM2, Nginx, Git ja Acme.sh.

Nõuded

• Node.js 6.9.0 või uuem
• MongoDB 3.2 või uuem
• Nginx
• Git 2.7.4 või uuem
• Gitiga ühilduv hoidla (avalik või privaatne) ( valikuline )
• Minimaalselt 768MB RAM
• Domeeninimi A/ AAAAkirjetega seadistatud

Kontrollige Debiani versiooni.

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

Veenduge, et teie süsteem on ajakohane.

apt update && apt upgrade -y

Installige vajalikud paketid.

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

Looge uus juurdepääsuga non-rootkasutajakonto sudoja lülituge sellele.

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

MÄRKUS . Asendage johndoeoma kasutajanimega.

Seadistage ajavöönd.

sudo dpkg-reconfigure tzdata

Installige Git

Installige Git Debiani.

sudo apt install -y git

Kontrollige Giti versiooni.

git --version
# git version 2.11.0

Installige Node.js

Installige Node.js, kasutades Node.js jaoks NodeSource APT hoidlat.

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

Kontrollige Node.js ja npm versioone.

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

Installige MongoDB

Wiki.js kasutab andmebaasimootorina MongoDB-d. Vastavalt sellele peame installima oma serverisse MongoDB. Paigaldamiseks kasutame ametlikke MongoDB hoidlaid .

Installige 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

Kontrolli versiooni.

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

Lubage ja käivitage MongoDB.

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

Installige ja konfigureerige Nginx

Soovitatav on panna Wiki.js-i ette tavaline veebiserver. See tagab, et saate kasutada selliseid funktsioone nagu SSL, mitu veebisaiti, vahemällu salvestamine ja palju muud. Me kasutame selles õpetuses Nginxit, kuid iga teine ​​server teeb seda, peate selle lihtsalt õigesti konfigureerima.

Installige 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

Kontrolli versiooni.

sudo nginx -v
# nginx version: nginx/1.15.0

Lubage ja käivitage Nginx.

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

Seadistage Nginx rakenduse Wiki.js jaoks pöördpuhverserverina HTTPvõi HTTPS(kui kasutate SSL-i) pöördpuhverserverina.

Käivitage sudo vim /etc/nginx/conf.d/wiki.js.confja sisestage see alloleva pöördpuhverserveri põhikonfiguratsiooniga.

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

}

Ainsad asjad, mida peate ülaltoodud konfiguratsioonis muutma, on server_namedirektiiv ja potentsiaalselt ka proxy_passdirektiiv, kui otsustate seadistada mõne muu pordi peale 3000. Wiki.js kasutab 3000vaikimisi porti .

Kontrollige konfiguratsiooni.

sudo nginx -t

Laadige Nginx uuesti.

sudo systemctl reload nginx.service

Installige Acme.sh ja hankige Let's Encrypt sertifikaat (valikuline)

Viki turvalisus HTTPSpole vajalik, kuid see on hea tava saidi liikluse turvamiseks. Let's Encrypti SSL-sertifikaadi saamiseks kasutame Acme.sh klienti. Acme.sh on puhas unixi kestatarkvara, mis võimaldab hankida Let's Encrypt SSL-sertifikaate ilma sõltuvusteta. See muudab selle väga kergeks võrreldes mõne teise ACME protokolli kliendiga, mis nõuavad edukaks töötamiseks palju sõltuvusi.

Laadige alla ja installige 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 ~

Kontrolli versiooni.

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

Hankige RSA ja ECDSA sertifikaadid 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 

MÄRKUS . Ärge unustage asendada wiki.example.comoma domeeninimega.

Pärast ülaltoodud käskude käivitamist asuvad teie sertifikaadid ja võtmed järgmistes kataloogides.

• RSA jaoks: /etc/letsencrypt/wiki.example.comkataloog.
• ECC/ECDSA jaoks: /etc/letsencrypt/wiki.example.com_ecckataloog.

Pärast Let's Encrypti sertifikaatide saamist peame Nginxi konfigureerima, et neid ära kasutada.

Käivitage sudo vim /etc/nginx/conf.d/wiki.js.confuuesti ja konfigureerige Nginx pöördpuhverserverina HTTPS.

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

}

Kontrollige konfiguratsiooni.

sudo nginx -t

Laadige Nginx uuesti.

sudo systemctl reload nginx.service

Installige Wiki.js

Looge tühi dokumendi juurkaust, kuhu tuleks installida Wiki.js.

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

Liikuge dokumendi juurkausta.

cd /var/www/wiki.example.com

Muutke /var/www/wiki.example.comkausta omandiõigus kasutajaks johndoe.

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

Alates /var/www/wiki.example.comkausta, käivitage järgmine käsk alla laadida ja installida Wiki.js.

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

Praegu installitud Wiki.js-i versiooni vaatamiseks saate käivitada järgmise käsu.

node wiki --version
# 1.0.78

Kui installimine on lõpetatud, palutakse teil käivitada konfiguratsiooniviisard.

Käivitage konfiguratsiooniviisard käivitades.

node wiki configure

See teavitab teid, et http://localhost:3000peaksite Wiki.js-i seadistamiseks navigeerima. Kui teil on Wiki.js-i ees Nginx, tähendab see, et saate avada oma domeeninime (nt http://wiki.example.com), selle asemel, et minna localhost.

Liikuge oma veebibrauseriga lehele http://wiki.example.comja järgige ekraanil kuvatavaid juhiseid. Kõik konfiguratsiooniviisardi käigus sisestatud seaded salvestatakse config.ymlfaili. Konfiguratsiooniviisard käivitab teie eest automaatselt Wiki.js'i.

PM2 seadistamine

Vaikimisi ei käivitu Wiki.js automaatselt pärast süsteemi taaskäivitamist. Selle käivitamiseks alglaadimisel peame seadistama PM2 protsessihalduri. PM2 on kohaliku NPM-moodulina komplektis Wiki.js-iga, nii et me ei pea PM2 globaalselt installima.

Öelge PM2-le, et ta konfigureeriks end käivitusteenusena.

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

Lõpuks salvestage praegune PM2 konfiguratsioon.

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

Teie Wiki.js-i eksemplar töötab taustprotsessina, kasutades protsessihaldurina PM2. Saate oma OS-i taaskäivitada sudo rebootja kontrollida, kas Wiki.js käivitub pärast taaskäivitamist.