Ako nainštalovať Wiki.js na CentOS 7

Wiki.js je bezplatná a open source moderná wiki aplikácia postavená na Node.js, MongoDB, Git a Markdown. Zdrojový kód Wiki.js je verejne hosťovaný na serveri Github . Táto príručka vám ukáže, ako nainštalovať Wiki.js na novú inštanciu CentOS 7 Vultr pomocou Node.js, MongoDB, PM2, Nginx, Git a Acme.sh.

Požiadavky

Požiadavky na spustenie Wiki.js sú nasledovné:

• Node.js verzie 6.9.0 alebo novšej
• MongoDB verzia 3.2 alebo novšia
• Nginx
• Git verzia 2.7.4 alebo novšia
• Úložisko kompatibilné s Git (verejné alebo súkromné) ( voliteľné )
• Minimálne 768 MB RAM
• Názov domény s nastavenými záznamami A/AAAA

Skontrolujte verziu CentOS.

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

Vytvorte si nový non-rootpoužívateľský účet s sudoprístupom a prepnite sa naň.

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

POZNÁMKA : Nahraďte johndoesvojim užívateľským menom .

Nastavte časové pásmo.

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

Uistite sa, že váš systém je aktuálny.

sudo yum update -y

Nainštalujte potrebné balíčky na dokončenie tohto tutoriálu.

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

Vypnite SELinux a Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Povoľte úložisko EPEL.

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

Nainštalujte Git

Repozitáre CentOS poskytujú veľmi zastaranú verziu Git, takže Git budeme musieť zostaviť zo zdroja.

Nainštalujte Git tak, že ho vytvoríte zo zdrojového kódu.

# 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

Overte verziu.

git --version
# git version 2.17.1

Nainštalujte Node.js

Wiki.js vyžaduje Node.js 6.9.0 alebo novší, takže najprv budeme musieť nainštalovať Node.js.

Nainštalujte Node.js pomocou repozitára NodeSource YUM pre Node.js.

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

Skontrolujte verzie Node.js a NPM.

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

Nainštalujte MongoDB

Wiki.js používa MongoDB ako databázový stroj. Budeme používať oficiálne úložiská MongoDB , ktoré obsahujú najnovšie veľké a menšie vydania MongoDB.

Nainštalujte si 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

Skontrolujte verziu.

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

Povoliť a spustiť MongoDB.

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

Nainštalujte a nakonfigurujte Nginx

It is highly recommended to put a standard web server in front of Wiki.js. This ensures you can use features like SSL, multiple websites, caching and more.

Install 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

Check the version.

nginx -v
# nginx version: nginx/1.15.0

Enable and start Nginx.

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

Configure Nginx as an HTTP or HTTPS reverse proxy for Wiki.js.

Run sudo vim /etc/nginx/conf.d/wiki.js.conf and populate it with the basic reverse proxy configuration below.

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

}

The only thing you need to change in the above configuration is server_name directive, and potentially proxy_pass directive if you decide to configure any other port than 3000. Wiki.js uses port 3000 by default.

Check the configuration.

sudo nginx -t

Reload Nginx.

sudo systemctl reload nginx.service

Install the Acme.sh client and obtain a Let's Encrypt certificate (optional)

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.

Po získaní certifikátov od Let's Encrypt musíme nakonfigurovať Nginx, aby sme ich využili.

Spustite sudo vim /etc/nginx/conf.d/wiki.js.confznova a nakonfigurujte Nginx ako HTTPSreverzný 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;
    }

}

Skontrolujte konfiguráciu.

sudo nginx -t

Znova načítať Nginx.

sudo systemctl reload nginx.service

Nainštalujte si Wiki.js

Vytvorte prázdny koreňový priečinok dokumentov, kde by mala byť nainštalovaná Wiki.js.

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

Prejdite do koreňového priečinka dokumentu.

cd /var/www/wiki.example.com

Zmeňte vlastníctvo /var/www/wiki.example.compriečinka na používateľa johndoe.

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

Z /var/www/wiki.example.compriečinka spustite nasledujúci príkaz na stiahnutie a inštaláciu Wiki.js.

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

Ak chcete zobraziť aktuálne nainštalovanú verziu Wiki.js, môžete spustiť nasledujúci príkaz.

node wiki --version
# 1.0.78

Po dokončení inštalácie sa zobrazí výzva na spustenie sprievodcu konfiguráciou.

Spustite sprievodcu konfiguráciou.

node wiki configure

Toto vás upozorní, aby ste prešli http://localhost:3000na konfiguráciu Wiki.js. Ak máte pred Wiki.js Nginx, môžete si http://wiki.example.comnamiesto prechodu na stránku otvoriť názov svojej domény (napr. ) localhost.

Pomocou webového prehliadača prejdite na http://wiki.example.compokyny na obrazovke a postupujte podľa nich. Všetky nastavenia, ktoré boli zadané počas sprievodcu konfiguráciou, boli uložené do config.ymlsúboru. Sprievodca konfiguráciou automaticky spustí Wiki.js.

Nastavenie PM2

V predvolenom nastavení sa Wiki.js nespustí automaticky po reštarte systému. Aby sa to spustilo pri zavádzaní, musíme nastaviť správcu procesov PM2.

Povedzte PM2, aby sa nakonfiguroval ako spúšťacia služba.

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

Nakoniec uložte aktuálnu konfiguráciu PM2 spustením príkazu.

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

Vaša inštancia Wiki.js beží ako proces na pozadí a používa PM2 ako svojho správcu procesov. Môžete reštartovať operačný systém pomocou sudo reboota zabezpečiť, aby sa Wiki.js po reštarte spustil.