Sådan installeres Wiki.js på CentOS 7

Wiki.js er en gratis og open source, moderne wiki-applikation bygget på Node.js, MongoDB, Git og Markdown. Wiki.js kildekode er offentligt hostet på Github . Denne guide viser dig, hvordan du installerer Wiki.js på en frisk CentOS 7 Vultr-instans ved hjælp af Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.

Krav

Kravene for at køre Wiki.js er følgende:

• Node.js version 6.9.0 eller nyere
• MongoDB version 3.2 eller nyere
• Nginx
• Git version 2.7.4 eller nyere
• Et Git-kompatibelt lager (offentligt eller privat) ( valgfrit )
• Minimum 768 MB RAM
• Domænenavn med A/ AAAArecords opsat

Tjek CentOS-versionen.

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

Opret en ny non-rootbrugerkonto med sudoadgang og skift til den.

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

BEMÆRK : Erstat johndoemed dit brugernavn .

Indstil tidszonen.

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

Sørg for, at dit system er opdateret.

sudo yum update -y

Installer nødvendige pakker for at afslutte denne øvelse.

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

Deaktiver SELinux og Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Aktiver EPEL-lageret.

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

Installer Git

CentOS repositories giver en meget forældet version af Git, så vi bliver nødt til at bygge Git fra kilden.

Installer Git ved at bygge det fra kildekoden.

# 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

Bekræft versionen.

git --version
# git version 2.17.1

Installer Node.js

Wiki.js kræver Node.js 6.9.0 eller nyere, så vi skal først installere Node.js.

Installer Node.js ved at bruge NodeSource YUM-lageret til Node.js.

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

Tjek Node.js- og NPM-versionerne.

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

Installer MongoDB

Wiki.js bruger MongoDB som en databasemotor. Vi vil bruge de officielle MongoDB-depoter , som indeholder de seneste større og mindre MongoDB-udgivelser.

Installer 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

Tjek versionen.

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

Aktiver og start MongoDB.

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

Installer og konfigurer Nginx

Det anbefales stærkt at sætte en standard webserver foran Wiki.js. Dette sikrer, at du kan bruge funktioner som SSL, flere websteder, caching og mere.

Installer 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

Tjek versionen.

nginx -v
# nginx version: nginx/1.15.0

Aktiver og start Nginx.

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

Konfigurer Nginx som en HTTPeller HTTPSomvendt proxy for Wiki.js.

Kør sudo vim /etc/nginx/conf.d/wiki.js.confog udfyld den med den grundlæggende reverse proxy-konfiguration nedenfor.

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 eneste du skal ændre i ovenstående konfiguration er server_namedirektiv og potentielt proxy_passdirektiv hvis du beslutter dig for at konfigurere en anden port end 3000. Wiki.js bruger port 3000som standard.

Tjek konfigurationen.

sudo nginx -t

Genindlæs Nginx.

sudo systemctl reload nginx.service

Installer Acme.sh-klienten og få et Let's Encrypt-certifikat (valgfrit)

Det HTTPSer ikke nødvendigt at sikre din wiki , men det er en god praksis at sikre trafikken på dit websted. For at få et SSL-certifikat fra Let's Encrypt, vil vi bruge Acme.sh klient. Acme.sh er et rent UNIX-shell-script til at opnå SSL-certifikater fra Let's Encrypt med nul afhængigheder. Det gør det meget let i forhold til nogle andre Acme-protokolklienter, der kræver en masse afhængigheder for at køre med succes.

Hent og installer 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 ~

Tjek versionen.

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

Få RSA- og ECDSA-certifikater for dit domæne/værtsnavn.

# 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 at have kørt ovenstående kommandoer, vil dine certifikater og nøgler være i følgende mapper:

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

BEMÆRK : Glem ikke at erstatte wiki.example.commed dit domænenavn.

Efter at have fået certifikater fra Let's Encrypt, skal vi konfigurere Nginx til at drage fordel af dem.

Kør sudo vim /etc/nginx/conf.d/wiki.js.configen og konfigurer Nginx som en HTTPSomvendt 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;
    }

}

Tjek konfigurationen.

sudo nginx -t

Genindlæs Nginx.

sudo systemctl reload nginx.service

Installer Wiki.js

Opret en tom dokumentrodmappe, hvor Wiki.js skal installeres.

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

Naviger til dokumentets rodmapp.

cd /var/www/wiki.example.com

Skift ejerskab af /var/www/wiki.example.commappen til bruger johndoe.

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

/var/www/wiki.example.comKør følgende kommando fra mappen for at downloade og installere Wiki.js.

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

Du kan køre følgende kommando for at se den aktuelt installerede version af Wiki.js.

node wiki --version
# 1.0.78

Når installationen er fuldført, bliver du bedt om at køre konfigurationsguiden.

Start konfigurationsguiden.

node wiki configure

Dette vil give dig besked om at navigere til for http://localhost:3000at konfigurere Wiki.js. Hvis du har Nginx foran Wiki.js, kan du åbne dit domænenavn (f.eks. http://wiki.example.com) i stedet for at gå til localhost.

Brug din webbrowser til at navigere til http://wiki.example.comog følge instruktionerne på skærmen. Alle de indstillinger, der blev indtastet under konfigurationsguiden, er blevet gemt i config.ymlfilen. Konfigurationsguiden starter automatisk Wiki.js for dig.

Opsætning af PM2

Som standard starter Wiki.js ikke automatisk efter en systemgenstart. For at få det til at starte ved opstart, skal vi konfigurere PM2-procesmanageren.

Bed PM2 om at konfigurere sig selv som en opstartstjeneste.

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

Gem endelig den aktuelle PM2-konfiguration ved at køre kommandoen.

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

Din Wiki.js-instans kører som en baggrundsproces ved at bruge PM2 som sin procesmanager. Du kan genstarte dit OS med sudo rebootog sikre, at Wiki.js starter efter en genstart.