Hoe Wiki.js op CentOS 7 te installeren

• Vereisten
• Installeer Git
• Installeer Node.js
• Installeer MongoDB
• Installeer en configureer Nginx
• Installeer de Acme.sh-client en verkrijg een Let's Encrypt-certificaat (optioneel)
• Installeer Wiki.js
• PM2 instellen

Wiki.js is een gratis en open source, moderne wiki-applicatie gebouwd op Node.js, MongoDB, Git en Markdown. De broncode van Wiki.js wordt openbaar gehost op Github . Deze handleiding laat zien hoe je Wiki.js installeert op een nieuwe CentOS 7 Vultr-instantie met Node.js, MongoDB, PM2, Nginx, Git en Acme.sh.

Vereisten

Vereisten om Wiki.js uit te voeren zijn de volgende:

• Node.js versie 6.9.0 of hoger
• MongoDB versie 3.2 of hoger
• Nginx
• Git versie 2.7.4 of hoger
• Een Git-compatibele repository (openbaar of privé) ( optioneel )
• Minimaal 768 MB RAM
• Domeinnaam met A/ AAAArecords ingesteld

Controleer de CentOS-versie.

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

Maak een nieuw non-rootgebruikersaccount aan met sudotoegang en schakel ernaar.

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

OPMERKING : vervang johndoedoor uw gebruikersnaam .

Stel de tijdzone in.

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

Zorg ervoor dat uw systeem up-to-date is.

sudo yum update -y

Installeer de benodigde pakketten om deze tutorial te voltooien.

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

Schakel SELinux en Firewall uit.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Schakel de EPEL-repository in.

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

Installeer Git

CentOS-opslagplaatsen bieden een zeer verouderde versie van Git, dus we zullen Git vanaf de bron moeten bouwen.

Installeer Git door het te bouwen vanuit de broncode.

# 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

Controleer de versie.

git --version
# git version 2.17.1

Installeer Node.js

Wiki.js vereist Node.js 6.9.0 of hoger, dus we zullen eerst Node.js. moeten installeren

Installeer Node.js met behulp van de NodeSource YUM-repository voor Node.js.

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

Controleer de versies Node.js en NPM.

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

Installeer MongoDB

Wiki.js gebruikt MongoDB als database-engine. We zullen de officiële MongoDB-repository's gebruiken , die de meest recente grote en kleine MongoDB-releases bevatten.

Installeer 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

Controleer de versie.

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

Schakel MongoDB in en start het.

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

Installeer en configureer Nginx

Het wordt sterk aanbevolen om een ​​standaard webserver voor Wiki.js. te plaatsen. Dit zorgt ervoor dat u functies zoals SSL, meerdere websites, caching en meer kunt gebruiken.

Installeer 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

Controleer de versie.

nginx -v
# nginx version: nginx/1.15.0

Schakel Nginx in en start het.

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

Configureer Nginx als een HTTPof HTTPSomgekeerde proxy voor Wiki.js.

Voer het uit sudo vim /etc/nginx/conf.d/wiki.js.confen vul het in met de basis omgekeerde proxyconfiguratie hieronder.

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

}

Het enige dat u in de bovenstaande configuratie moet wijzigen, is server_namerichtlijn en mogelijk proxy_passrichtlijn als u besluit een andere poort dan te configureren 3000. Wiki.js gebruikt 3000standaard poort .

Controleer de configuratie.

sudo nginx -t

Herlaad Nginx.

sudo systemctl reload nginx.service

Installeer de Acme.sh-client en verkrijg een Let's Encrypt-certificaat (optioneel)

Het beveiligen van uw wiki met HTTPSis niet nodig, maar het is een goede gewoonte om uw siteverkeer te beveiligen. Om een ​​SSL-certificaat van Let's Encrypt te verkrijgen, gebruiken we de Acme.sh-client. Acme.sh is een puur UNIX-shellscript voor het verkrijgen van SSL-certificaten van Let's Encrypt zonder afhankelijkheden. Dat maakt het zeer licht in vergelijking met sommige andere Acme-protocolclients die veel afhankelijkheden vereisen om succesvol te kunnen werken.

Download en installeer 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 ~

Controleer de versie.

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

Verkrijg RSA- en ECDSA-certificaten voor uw domein / hostnaam.

# 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 

Na het uitvoeren van de bovenstaande opdrachten, bevinden uw certificaten en sleutels zich in de volgende mappen:

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

OPMERKING : vergeet niet te vervangen wiki.example.comdoor uw domeinnaam.

Na het verkrijgen van certificaten van Let's Encrypt, moeten we Nginx configureren om hiervan te profiteren.

Voer sudo vim /etc/nginx/conf.d/wiki.js.confopnieuw uit en configureer Nginx als een HTTPSreverse 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;
    }

}

Controleer de configuratie.

sudo nginx -t

Herlaad Nginx.

sudo systemctl reload nginx.service

Installeer Wiki.js

Maak een lege documenthoofdmap waar Wiki.js moet worden geïnstalleerd.

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

Navigeer naar de hoofdmap van het document.

cd /var/www/wiki.example.com

Verander het eigendom van de /var/www/wiki.example.commap in gebruiker johndoe.

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

/var/www/wiki.example.comVoer vanuit de map de volgende opdracht uit om Wiki.js. te downloaden en te installeren

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

U kunt de volgende opdracht uitvoeren om de momenteel geïnstalleerde versie van Wiki.js. te bekijken.

node wiki --version
# 1.0.78

Zodra de installatie is voltooid, wordt u gevraagd de configuratiewizard uit te voeren.

Start de configuratiewizard.

node wiki configure

Dit zal je informeren om naar te navigeren om http://localhost:3000Wiki.js. te configureren Als je Nginx voor Wiki.js hebt staan, kun je je domeinnaam (bijv. http://wiki.example.com) Openen in plaats van naar te gaan localhost.

Navigeer met uw webbrowser naar http://wiki.example.comen volg de instructies op het scherm. Alle instellingen die tijdens de configuratiewizard zijn ingevoerd, zijn in het config.ymlbestand opgeslagen . De configuratiewizard start automatisch Wiki.js voor u.

PM2 instellen

Standaard zal Wiki.js niet automatisch starten nadat het systeem opnieuw is opgestart. Om het bij het opstarten te laten starten, moeten we de PM2-procesmanager instellen.

Vraag PM2 om zichzelf te configureren als opstartservice.

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

Sla ten slotte de huidige PM2-configuratie op door de opdracht uit te voeren.

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

Uw Wiki.js-exemplaar wordt uitgevoerd als een achtergrondproces, met PM2 als procesmanager. U kunt uw besturingssysteem opnieuw opstarten met sudo rebooten ervoor zorgen dat Wiki.js start na een herstart.