Hur man installerar Wiki.js på CentOS 7

Wiki.js är en gratis och öppen källkod, modern wikiapplikation byggd på Node.js, MongoDB, Git och Markdown. Wiki.js källkod är offentligt värd på Github . Den här guiden visar dig hur du installerar Wiki.js på en ny CentOS 7 Vultr-instans med Node.js, MongoDB, PM2, Nginx, Git och Acme.sh.

Krav

Krav för att köra Wiki.js är följande:

• Node.js version 6.9.0 eller senare
• MongoDB version 3.2 eller senare
• Nginx
• Git version 2.7.4 eller senare
• Ett Git-kompatibelt arkiv (offentligt eller privat) ( valfritt )
• Minst 768MB RAM
• Domännamn med A/ AAAAposter inställda

Kontrollera CentOS-versionen.

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

Skapa ett nytt non-rootanvändarkonto med sudoåtkomst och byt till det.

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

OBS : Ersätt johndoemed ditt användarnamn .

Ställ in tidszonen.

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

Se till att ditt system är uppdaterat.

sudo yum update -y

Installera nödvändiga paket för att slutföra denna handledning.

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

Inaktivera SELinux och brandvägg.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Aktivera EPEL-förvaret.

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

Installera Git

CentOS repositories tillhandahåller en mycket föråldrad version av Git, så vi måste bygga Git från källkod.

Installera Git genom att bygga det från källkoden.

# 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

Verifiera versionen.

git --version
# git version 2.17.1

Installera Node.js

Wiki.js kräver Node.js 6.9.0 eller senare, så vi måste först installera Node.js.

Installera Node.js genom att använda NodeSource YUM-förvaret för Node.js.

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

Kontrollera versionerna av Node.js och NPM.

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

Installera MongoDB

Wiki.js använder MongoDB som en databasmotor. Vi kommer att använda de officiella MongoDB-förråden , som innehåller de senaste större och mindre MongoDB-utgåvorna.

Installera 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

Kontrollera versionen.

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

Aktivera och starta MongoDB.

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

Installera och konfigurera Nginx

Det rekommenderas starkt att sätta en standard webbserver framför Wiki.js. Detta säkerställer att du kan använda funktioner som SSL, flera webbplatser, cachning och mer.

Installera 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

Kontrollera versionen.

nginx -v
# nginx version: nginx/1.15.0

Aktivera och starta Nginx.

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

Konfigurera Nginx som en HTTPeller HTTPSomvänd proxy för Wiki.js.

Kör sudo vim /etc/nginx/conf.d/wiki.js.confoch fyll i den med den grundläggande omvända proxykonfigurationen nedan.

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

}

Det enda du behöver ändra i ovanstående konfiguration är server_namedirektiv, och potentiellt proxy_passdirektiv om du bestämmer dig för att konfigurera någon annan port än 3000. Wiki.js använder port som 3000standard.

Kontrollera konfigurationen.

sudo nginx -t

Ladda om Nginx.

sudo systemctl reload nginx.service

Installera Acme.sh-klienten och skaffa ett Let's Encrypt-certifikat (valfritt)

Att säkra din wiki med HTTPSär inte nödvändigt, men det är en god praxis att säkra din webbplatstrafik. För att få ett SSL-certifikat från Let's Encrypt kommer vi att använda Acme.sh-klienten. Acme.sh är ett rent UNIX-skalskript för att erhålla SSL-certifikat från Let's Encrypt med noll beroenden. Det gör den väldigt lätt i jämförelse med vissa andra Acme-protokollklienter som kräver många beroenden för att fungera framgångsrikt.

Ladda ner och installera 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 ~

Kontrollera versionen.

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

Skaffa RSA- och ECDSA-certifikat för din domän/värdnamn.

# 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 

Efter att ha kört ovanstående kommandon kommer dina certifikat och nycklar att finnas i följande kataloger:

• För RSA: /etc/letsencrypt/wiki.example.com
• För ECC/ECDSA: /etc/letsencrypt/wiki.example.com_ecc

OBS : Glöm inte att ersätta wiki.example.commed ditt domännamn.

Efter att ha erhållit certifikat från Let's Encrypt måste vi konfigurera Nginx för att dra fördel av dem.

Kör sudo vim /etc/nginx/conf.d/wiki.js.configen och konfigurera Nginx som en HTTPSomvänd 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;
    }

}

Kontrollera konfigurationen.

sudo nginx -t

Ladda om Nginx.

sudo systemctl reload nginx.service

Installera Wiki.js

Skapa en tom dokumentrotmapp där Wiki.js ska installeras.

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

Navigera till dokumentets rotmapp.

cd /var/www/wiki.example.com

Ändra ägande av /var/www/wiki.example.commappen till användare johndoe.

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

/var/www/wiki.example.comKör följande kommando från mappen för att ladda ner och installera Wiki.js.

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

Du kan köra följande kommando för att se den för närvarande installerade versionen av Wiki.js.

node wiki --version
# 1.0.78

När installationen är klar kommer du att uppmanas att köra konfigurationsguiden.

Starta konfigurationsguiden.

node wiki configure

Detta kommer att meddela dig att navigera till för http://localhost:3000att konfigurera Wiki.js. Om du har Nginx framför Wiki.js kan du öppna ditt domännamn (t.ex. http://wiki.example.com) istället för att gå till localhost.

Använd din webbläsare, navigera till http://wiki.example.comoch följ instruktionerna på skärmen. Alla inställningar som angavs under konfigurationsguiden har sparats i config.ymlfilen. Konfigurationsguiden startar automatiskt Wiki.js åt dig.

Ställ in PM2

Som standard startar inte Wiki.js automatiskt efter en omstart av systemet. För att få det att starta vid uppstart måste vi konfigurera PM2 processhanteraren.

Be PM2 att konfigurera sig själv som en starttjänst.

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

Slutligen, spara den aktuella PM2-konfigurationen genom att köra kommandot.

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

Din Wiki.js-instans körs som en bakgrundsprocess med PM2 som processhanterare. Du kan starta om ditt operativsystem med sudo rebootoch se till att Wiki.js startar efter en omstart.