Wiki.js:n asentaminen CentOS 7:ää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 CentOS 7 Vultr -esiintymään Node.js:n, MongoDB:n, PM2:n, Nginxin, Gitin ja Acme.sh:n avulla.

Vaatimukset

Wiki.js:n suorittamisen vaatimukset ovat seuraavat:

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

Tarkista CentOS-versio.

cat /etc/centos-release
# CentOS Linux release 7.5.1804 (Core)

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

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

HUOMAA : Korvaa johndoekäyttäjätunnuksellasi .

Aseta aikavyöhyke.

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

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

sudo yum update -y

Viimeistele tämä opetusohjelma asentamalla tarvittavat paketit.

sudo yum install -y wget curl vim zip unzip bash-completion

Poista SELinux ja palomuuri käytöstä.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Ota EPEL-arkisto käyttöön.

sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

Asenna Git

CentOS-arkistot tarjoavat erittäin vanhentuneen version Gitistä, joten meidän on rakennettava Git lähteestä.

Asenna Git rakentamalla se lähdekoodista.

# Remove existing git package if installed: 
sudo yum remove -y git
sudo yum groupinstall -y "Development Tools"
sudo yum install -y gettext-devel openssl-devel perl-CPAN perl-devel zlib-devel curl-devel
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.17.1.tar.gz && tar zxvf git-2.17.1.tar.gz
rm git-2.17.1.tar.gz
cd git-2.17.1
make configure
./configure
make prefix=/usr/local all
sudo make prefix=/usr/local install
cd ~

# Confirm this command returns /usr/local/bin/git:
which git

Tarkista versio.

git --version
# git version 2.17.1

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 käyttämällä Node.js:n NodeSource YUM -varastoa.

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
sudo yum 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. Käytämme virallisia MongoDB-tietovarastoja , jotka sisältävät uusimmat suuret ja pienet MongoDB-julkaisut.

Asenna MongoDB Community Edition.

sudo vim /etc/yum.repos.d/mongodb-org-3.6.repo

# Copy/paste this
[mongodb-org-3.6]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.6/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.6.asc

sudo yum 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.

Asenna Nginx.

sudo vim /etc/yum.repos.d/nginx_mainline.repo

# Copy/paste this
[nginx]
name=nginx repo
baseurl=https://nginx.org/packages/mainline/centos/7/$basearch/
gpgcheck=1
enabled=1

wget https://nginx.org/keys/nginx_signing.key
sudo rpm --import nginx_signing.key
rm nginx_signing.key

sudo yum install -y nginx

Tarkista versio.

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 Wiki.js:n välityspalvelimeksi HTTPtai HTTPSkäänteiseksi välityspalvelimeksi.

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 kokoonpanossa, 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)

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 Acme.sh client. Acme.sh is a pure UNIX shell script 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 your domain/hostname.

# 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 

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

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

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

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.

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ä, 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 määritystoiminnon aikana tehdyt asetukset on tallennettu 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.

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 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. Voit käynnistää käyttöjärjestelmän uudelleen sudo rebootja varmistaa, että Wiki.js käynnistyy uudelleenkäynnistyksen jälkeen.