Jak nainstalovat Wiki.js na CentOS 7

Wiki.js je bezplatná a open source, moderní wiki aplikace postavená na Node.js, MongoDB, Git a Markdown. Zdrojový kód Wiki.js je veřejně hostován na Github . Tato příručka vám ukáže, jak nainstalovat Wiki.js na novou instanci CentOS 7 Vultr pomocí Node.js, MongoDB, PM2, Nginx, Git a Acme.sh.

Požadavky

Požadavky pro spuštění Wiki.js jsou následující:

• Node.js verze 6.9.0 nebo novější
• MongoDB verze 3.2 nebo novější
• Nginx
• Git verze 2.7.4 nebo novější
• Úložiště kompatibilní s Git (veřejné nebo soukromé) ( volitelné )
• Minimálně 768 MB RAM
• Název domény s nastavenými záznamy A/AAAA

Zkontrolujte verzi CentOS.

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

Vytvořte nový non-rootuživatelský účet s sudopřístupem a přepněte na něj.

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

POZNÁMKA : Nahraďte johndoesvým uživatelským jménem .

Nastavte časové pásmo.

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

Ujistěte se, že váš systém je aktuální.

sudo yum update -y

Nainstalujte potřebné balíčky k dokončení tohoto kurzu.

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

Vypněte SELinux a firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Povolte úložiště EPEL.

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

Nainstalujte Git

Úložiště CentOS poskytují velmi zastaralou verzi Git, takže budeme muset Git sestavit ze zdroje.

Nainstalujte Git vytvořením ze 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

Ověřte verzi.

git --version
# git version 2.17.1

Nainstalujte Node.js

Wiki.js vyžaduje Node.js 6.9.0 nebo novější, takže nejprve budeme muset nainstalovat Node.js.

Nainstalujte Node.js pomocí úložiště NodeSource YUM pro Node.js.

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

Zkontrolujte verze Node.js a NPM.

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

Nainstalujte MongoDB

Wiki.js používá MongoDB jako databázový stroj. Použijeme oficiální úložiště MongoDB , která obsahují nejnovější hlavní a menší vydání MongoDB.

Nainstalujte 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

Zkontrolujte verzi.

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

Povolte a spusťte MongoDB.

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

Nainstalujte a nakonfigurujte Nginx

Důrazně se doporučuje umístit před Wiki.js standardní webový server. To zajišťuje, že můžete používat funkce jako SSL, více webových stránek, ukládání do mezipaměti a další.

Nainstalujte 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

Zkontrolujte verzi.

nginx -v
# nginx version: nginx/1.15.0

Povolte a spusťte Nginx.

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

Nakonfigurujte Nginx jako HTTPnebo HTTPSreverzní proxy pro Wiki.js.

Spusťte sudo vim /etc/nginx/conf.d/wiki.js.confa naplňte jej základní konfigurací reverzního proxy níže.

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

}

Jediná věc, kterou musíte ve výše uvedené konfiguraci změnit, je server_namedirektiva a případně proxy_passdirektiva, pokud se rozhodnete nakonfigurovat jakýkoli jiný port než 3000. Wiki.js standardně používá port 3000.

Zkontrolujte konfiguraci.

sudo nginx -t

Znovu načtěte Nginx.

sudo systemctl reload nginx.service

Nainstalujte klienta Acme.sh a získejte certifikát Let's Encrypt (volitelné)

Zabezpečení vaší wiki HTTPSnení nutné, ale je dobrým zvykem, jak zabezpečit návštěvnost vašeho webu. K získání SSL certifikátu od Let's Encrypt použijeme klienta Acme.sh. Acme.sh je čistý unixový shell skript pro získávání SSL certifikátů z Let's Encrypt s nulovými závislostmi. Díky tomu je velmi lehký ve srovnání s některými jinými klienty protokolu Acme, kteří k úspěšnému spuštění vyžadují mnoho závislostí.

Stahovat a instalovat 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 ~

Zkontrolujte verzi.

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

Získejte certifikáty RSA a ECDSA pro svou doménu/název hostitele.

# 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 

Po spuštění výše uvedených příkazů budou vaše certifikáty a klíče v následujících adresářích:

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

POZNÁMKA : Nezapomeňte nahradit wiki.example.comnázvem vaší domény.

Po získání certifikátů z Let's Encrypt musíme nakonfigurovat Nginx, abychom je mohli využívat.

Spusťte sudo vim /etc/nginx/conf.d/wiki.js.confznovu a nakonfigurujte Nginx jako 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;
    }

}

Zkontrolujte konfiguraci.

sudo nginx -t

Znovu načtěte Nginx.

sudo systemctl reload nginx.service

Nainstalujte Wiki.js

Vytvořte prázdnou kořenovou složku dokumentů, kam by měla být nainstalována Wiki.js.

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

Přejděte do kořenové složky dokumentu.

cd /var/www/wiki.example.com

Změnit vlastnictví /var/www/wiki.example.comsložky na uživatele johndoe.

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

Ze /var/www/wiki.example.comsložky spusťte následující příkaz ke stažení a instalaci Wiki.js.

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

Chcete-li zobrazit aktuálně nainstalovanou verzi Wiki.js, můžete spustit následující příkaz.

node wiki --version
# 1.0.78

Po dokončení instalace budete vyzváni ke spuštění průvodce konfigurací.

Spusťte průvodce konfigurací.

node wiki configure

To vás upozorní, abyste http://localhost:3000přešli na a nakonfigurovali Wiki.js. Pokud máte Nginx před Wiki.js, můžete otevřít název své domény (např. http://wiki.example.com) namísto přechodu na localhost.

Pomocí webového prohlížeče přejděte na http://wiki.example.compokyny na obrazovce a postupujte podle nich. Všechna nastavení, která byla zadána během průvodce konfigurací, byla uložena do config.ymlsouboru. Průvodce konfigurací za vás automaticky spustí Wiki.js.

Nastavení PM2

Ve výchozím nastavení se Wiki.js nespustí automaticky po restartu systému. Aby se to spustilo při bootování, musíme nastavit správce procesů PM2.

Řekněte PM2, aby se nakonfiguroval jako spouštěcí služba.

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

Nakonec uložte aktuální konfiguraci PM2 spuštěním příkazu.

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

Vaše instance Wiki.js běží jako proces na pozadí a jako správce procesů používá PM2. Svůj operační systém můžete restartovat sudo reboota zajistit, aby se Wiki.js po restartu spustil.