Wiki.js:n asentaminen Debian 9:ään

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 Debian 9 Vultr -esiintymään käyttämällä Node.js:ää, MongoDB:tä, PM2:ta, Nginxiä, Gitiä ja Acme.sh:ta.

Vaatimukset

• Node.js 6.9.0 tai uudempi
• MongoDB 3.2 tai uudempi
• Nginx
• Git 2.7.4 tai uudempi
• Git-yhteensopiva arkisto (julkinen tai yksityinen) ( valinnainen )
• Vähintään 768MB RAM
• Verkkotunnuksen nimi A/ AAAAtietueet määritetty

Tarkista Debian-versio.

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

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

apt update && apt upgrade -y

Asenna tarvittavat paketit.

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

Luo uusi non-rootkäyttäjätili sudoja vaihda siihen.

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

HUOMAA : Korvaa johndoekäyttäjätunnuksellasi.

Aseta aikavyöhyke.

sudo dpkg-reconfigure tzdata

Asenna Git

Asenna Git Debianiin.

sudo apt install -y git

Tarkista Git-versio.

git --version
# git version 2.11.0

Asenna Node.js

Asenna Node.js käyttämällä Node.js:n NodeSource APT -varastoa.

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

Tarkista Node.js- ja npm-versiot.

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

Asenna MongoDB

Wiki.js käyttää MongoDB:tä tietokantamoottorina. Sen mukaan meidän on asennettava MongoDB palvelimellemme. Käytämme asennuksessa virallisia MongoDB-tietovarastoja .

Asenna 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

Tarkista versio.

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

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

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

Asenna ja määritä Nginx

On 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 paljon muuta. Käytämme Nginxiä tässä opetusohjelmassa, mutta mikä tahansa muu palvelin käy, sinun on vain määritettävä se oikein.

Asenna 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

Tarkista versio.

sudo nginx -v
# nginx version: nginx/1.15.0

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

}

Ainoat asiat, joita sinun on muutettava yllä olevassa konfiguraatiossa, on server_namedirektiivi ja mahdollisesti myös 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 ja hanki Let's Encrypt -sertifikaatti (valinnainen)

Securing your wiki with HTTPS is not necessary, but it is a good practice to secure your site traffic. In order to obtain an SSL certificate from Let's Encrypt we will use the Acme.sh client. Acme.sh is a pure unix shell software for obtaining SSL certificates from Let's Encrypt with zero dependencies. That makes it very lightweight in comparison to some other ACME protocol clients that require a lot of dependencies to run successfully.

Download and install 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 ~

Check the version.

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

Obtain RSA and ECDSA certificates for 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 

NOTE: Don't forget to replace wiki.example.com with your domain name.

After running the above commands, your certificates and keys will be in the following directories.

• For RSA: /etc/letsencrypt/wiki.example.com directory.
• ECC/ECDSA: /etc/letsencrypt/wiki.example.com_ecchakemisto.

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

}

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 määritettävä 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.

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

Tallenna lopuksi nykyinen PM2-kokoonpano.

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

Wiki.js-esiintymäsi toimii taustaprosessina ja käyttää PM2:ta prosessinhallinnanaan. Voit käynnistää käyttöjärjestelmän uudelleen sudo rebootja tarkistaa, käynnistyykö Wiki.js uudelleenkäynnistyksen jälkeen.