Kako instalirati Wiki.js na CentOS 7

Zahtjevi

Instalirajte Git

Instalirajte Node.js

Instalirajte MongoDB

Instalirajte i konfigurirajte Nginx

Instalirajte Acme.sh klijent i pribavite certifikat Let's Encrypt (opcionalno)

Instalirajte Wiki.js

Postavljanje PM2

Wiki.js je besplatna moderna wiki aplikacija otvorenog koda izgrađena na Node.js, MongoDB, Git i Markdown. Izvorni kod Wiki.js javno se nalazi na Githubu . Ovaj vodič će vam pokazati kako instalirati Wiki.js na novu instancu CentOS 7 Vultr koristeći Node.js, MongoDB, PM2, Nginx, Git i Acme.sh.

Zahtjevi

Zahtjevi za pokretanje Wiki.js su sljedeći:

• Node.js verzija 6.9.0 ili novija
• MongoDB verzija 3.2 ili novija
• Nginx
• Git verzija 2.7.4 ili novija
• Git-kompatibilno spremište (javno ili privatno) ( opcionalno )
• Najmanje 768 MB RAM-a
• Ime domene sa A/ AAAApostavljenim zapisima

Provjerite verziju CentOS-a.

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

Napravite novi non-rootkorisnički račun s sudopristupom i prebacite se na njega.

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

NAPOMENA : Zamijenite johndoesvojim korisničkim imenom .

Postavite vremensku zonu.

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

Provjerite je li vaš sustav ažuriran.

sudo yum update -y

Instalirajte potrebne pakete da završite ovaj vodič.

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

Onemogućite SELinux i vatrozid.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Omogućite EPEL spremište.

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

Instalirajte Git

Repozitoriji CentOS-a pružaju vrlo zastarjelu verziju Gita, tako da ćemo morati izgraditi Git iz izvora.

Instalirajte Git tako da ga napravite iz izvornog koda.

# 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

Provjerite verziju.

git --version
# git version 2.17.1

Instalirajte Node.js

Wiki.js zahtijeva Node.js 6.9.0 ili noviji, pa ćemo prvo morati instalirati Node.js.

Instalirajte Node.js korištenjem NodeSource YUM spremišta za Node.js.

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
sudo yum install -y nodejs

Provjerite verzije Node.js i NPM.

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

Instalirajte MongoDB

Wiki.js koristi MongoDB kao motor baze podataka. Koristit ćemo službena MongoDB repozitorija , koja sadrže najnovija glavna i manja MongoDB izdanja.

Instalirajte 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

Provjerite verziju.

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

Omogućite i pokrenite MongoDB.

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

Instalirajte i konfigurirajte Nginx

Preporučljivo je staviti standardni web poslužitelj ispred Wiki.js. To osigurava da možete koristiti značajke kao što su SSL, više web-mjesta, predmemorija i još mnogo toga.

Instalirajte 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

Provjerite verziju.

nginx -v
# nginx version: nginx/1.15.0

Omogućite i pokrenite Nginx.

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

Konfigurirajte Nginx kao HTTPili HTTPSobrnuti proxy za Wiki.js.

Pokrenite ga sudo vim /etc/nginx/conf.d/wiki.js.confi popunite ga osnovnom konfiguracijom obrnutog proxyja u nastavku.

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

}

Jedina stvar koju trebate promijeniti u gornjoj konfiguraciji je server_namedirektiva, a potencijalno i proxy_passdirektiva ako odlučite konfigurirati bilo koji drugi port osim 3000. Wiki.js 3000prema zadanim postavkama koristi port .

Provjerite konfiguraciju.

sudo nginx -t

Ponovno učitajte Nginx.

sudo systemctl reload nginx.service

Instalirajte Acme.sh klijent i pribavite certifikat Let's Encrypt (opcionalno)

Osiguravanje vašeg wikija pomoću HTTPSnije potrebno, ali je dobra praksa osigurati promet na vašoj web-lokaciji. Kako bismo dobili SSL certifikat od Let's Encrypta, koristit ćemo Acme.sh klijent. Acme.sh je čista UNIX shell skripta za dobivanje SSL certifikata od Let's Encrypt s nula ovisnosti. To ga čini vrlo laganim u usporedbi s nekim drugim klijentima Acme protokola koji zahtijevaju puno ovisnosti za uspješno izvođenje.

Preuzmite i instalirajte 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 your_email@example.com
cd ~

Provjerite verziju.

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

Nabavite RSA i ECDSA certifikate za svoju domenu/naziv hosta.

# 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 your_email@example.com --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 your_email@example.com --ocsp-must-staple --keylength ec-256 

Nakon izvođenja gornjih naredbi, vaši će certifikati i ključevi biti u sljedećim direktorijima:

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

NAPOMENA : Ne zaboravite zamijeniti wiki.example.comimenom svoje domene.

Nakon što smo dobili certifikate od Let's Encrypt, moramo konfigurirati Nginx da ih iskoristi.

Pokrenite sudo vim /etc/nginx/conf.d/wiki.js.confponovno i konfigurirajte Nginx kao HTTPSobrnuti proxy.

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

}

Provjerite konfiguraciju.

sudo nginx -t

Ponovno učitajte Nginx.

sudo systemctl reload nginx.service

Instalirajte Wiki.js

Napravite praznu korijensku mapu dokumenta u koju bi trebao biti instaliran Wiki.js.

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

Idite do korijenske mape dokumenta.

cd /var/www/wiki.example.com

Promijenite vlasništvo nad /var/www/wiki.example.commapom na korisnika johndoe.

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

Iz /var/www/wiki.example.commape pokrenite sljedeću naredbu da preuzmete i instalirate Wiki.js.

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

Možete pokrenuti sljedeću naredbu kako biste vidjeli trenutno instaliranu verziju Wiki.js.

node wiki --version
# 1.0.78

Nakon dovršetka instalacije, od vas će se tražiti da pokrenete čarobnjak za konfiguraciju.

Pokrenite čarobnjak za konfiguraciju.

node wiki configure

Ovo će vas obavijestiti da http://localhost:3000prijeđete na konfiguraciju Wiki.js. Ako imate Nginx ispred Wiki.js, možete otvoriti naziv svoje domene (npr. http://wiki.example.com) umjesto da idete na localhost.

Koristeći svoj web preglednik, idite do http://wiki.example.comi slijedite upute na zaslonu. Sve postavke koje su unesene tijekom konfiguracijskog čarobnjaka spremljene su u config.ymldatoteci. Čarobnjak za konfiguraciju automatski će pokrenuti Wiki.js umjesto vas.

Postavljanje PM2

Prema zadanim postavkama, Wiki.js se neće automatski pokrenuti nakon ponovnog pokretanja sustava. Da bi se pokrenuo pri pokretanju, moramo postaviti PM2 upravitelj procesa.

Recite PM2 da se konfigurira kao servis za pokretanje.

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

Konačno, spremite trenutnu PM2 konfiguraciju pokretanjem naredbe.

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

Vaša Wiki.js instanca radi kao pozadinski proces, koristeći PM2 kao upravitelj procesa. Možete ponovno pokrenuti svoj OS sudo rebooti osigurati da se Wiki.js pokrene nakon ponovnog pokretanja.