Krav
Før du begynner
Installer Node.js
Installer MongoDB
Installer og konfigurer Nginx
Installer Acme.sh-klienten og få Let's Encrypt-sertifikat (valgfritt)
Installer Wiki.js
Sett opp PM2
Wiki.js er en gratis og åpen kildekode, moderne wiki-app bygget på Node.js, MongoDB, Git og Markdown. Wiki.js kildekode er offentlig vert på Github . Denne guiden viser deg hvordan du installerer Wiki.js på en fersk Fedora 28 Vultr-instans ved å bruke Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.
Krav
Kravene for å kjøre Wiki.js er følgende:
- Node.js versjon 6.9.0 eller nyere
- MongoDB versjon 3.2 eller nyere
- En webserver som Nginx, Apache, IIS, Caddy eller H2O. Denne veiledningen vil bruke Nginx
- Git versjon 2.7.4 eller nyere
- Et Git-kompatibelt depot (offentlig eller privat) Dette er valgfritt
- Minst 768 MB RAM
- Domenenavn med
A/ AAAAposter satt opp
Før du begynner
Sjekk OS-versjonen.
cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)
Opprett en ny ikke-rootbrukerkonto med sudo-tilgang og bytt til den.
useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe
MERK: Erstatt johndoemed brukernavnet ditt.
Sørg for at systemet ditt er oppdatert.
sudo dnf check-upgrade || sudo dnf upgrade -y
Sett opp tidssonen.
timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'
Installer nødvendige og nyttige pakker.
sudo dnf install -y wget vim unzip bash-completion git
For enkelhets skyld, deaktiver SELinux og brannmur.
sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld
Installer Node.js
Wiki.js krever Node.js 6.9.0 eller nyere, så vi må først installere Node.js.
Installer Node.js.
sudo dnf install -y nodejs
Sjekk Node.js og npm versjoner.
node -v && npm -v
# v8.11.3
# 5.6.0
Installer MongoDB
Wiki.js bruker MongoDB som en databasemotor. I følge det må vi installere MongoDB på serveren vår.
Installer MongoDB.
sudo dnf install -y mongodb mongodb-server
Sjekk MongoDB-versjonen.
mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.3
# db version v3.6.3
Aktiver og start MongoDB.
sudo systemctl enable mongod.service
sudo systemctl start mongod.service
Wiki.js kan kjøre uten noen faktisk webserver (som Nginx eller Apache). Det anbefales imidlertid sterkt å sette en standard webserver foran Wiki.js. Dette sikrer at du kan bruke funksjoner som SSL, flere nettsteder, caching og andre. Vi vil bruke Nginx i denne opplæringen, men enhver annen server vil gjøre det, du trenger bare å konfigurere den riktig.
Installer Nginx.
sudo dnf install -y nginx
Sjekk versjonen.
nginx -v
# nginx version: nginx/1.12.1
Aktiver og start Nginx.
sudo systemctl enable nginx.service
sudo systemctl start nginx.service
Konfigurer Nginx som en HTTPeller HTTPS(hvis du bruker SSL) omvendt proxy for Wiki.js-applikasjonen.
Kjør sudo vim /etc/nginx/conf.d/wiki.js.confog fyll den med den grunnleggende omvendte proxy-konfigurasjonen 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 trenger å endre i konfigurasjonen ovenfor er server_namedirektivet, og potensielt proxy_passdirektivet hvis du bestemmer deg for å konfigurere en annen port enn 3000. Wiki.js bruker port 3000som standard.
Sjekk konfigurasjonen.
sudo nginx -t
Last inn Nginx på nytt.
sudo systemctl reload nginx.service
Installer Acme.sh-klienten og få Let's Encrypt-sertifikat (valgfritt)
Det HTTPSer ikke nødvendig å sikre wikien din med , men det er en god praksis å sikre trafikken til nettstedet ditt. For å få et SSL-sertifikat fra Let's Encrypt bruker vi Acme.sh-klienten. Acme.sh er en ren unix-skallprogramvare for å få SSL-sertifikater fra Let's Encrypt med null avhengigheter. Det gjør den veldig lett sammenlignet med noen andre ACME-protokollklienter som krever mange avhengigheter for å kjøre vellykket.
Last ned 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 your_email@example.com
cd ~
Sjekk acme.shversjonen.
/etc/letsencrypt/acme.sh --version
# v2.7.9
Skaff RSA- og ECDSA-sertifikater for wiki.example.com.
# 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 your_email@example.com --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 your_email@example.com --ocsp-must-staple --keylength ec-256
Etter å ha kjørt kommandoene ovenfor, vil sertifikatene og nøklene dine være i:
- For RSA:
/etc/letsencrypt/wiki.example.com
- For ECC/ECDSA:
/etc/letsencrypt/wiki.example.com_ecc
MERK : Ikke glem å erstatte wiki.example.commed ditt domenenavn.
Etter å ha fått sertifikater fra Let's Encrypt, må vi konfigurere Nginx for å dra nytte av dem.
Kjør sudo vim /etc/nginx/conf.d/wiki.js.configjen 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;
}
}
Sjekk konfigurasjonen.
sudo nginx -t
Last inn Nginx på nytt.
sudo systemctl reload nginx.service
Installer Wiki.js
Opprett en tom dokumentrotmappe, der Wiki.js skal installeres.
sudo mkdir -p /var/www/wiki.example.com
Naviger til dokumentrotmappen.
cd /var/www/wiki.example.com
Endre eierskap av /var/www/wiki.example.commappe til bruker johndoe.
sudo chown -R johndoe:johndoe /var/www/wiki.example.com
Fra /var/www/wiki.example.commappen, kjør følgende kommando for å laste ned og installere Wiki.js.
curl -sSo- https://wiki.js.org/install.sh | bash
Du kan kjøre følgende kommando for å se den installerte versjonen av Wiki.js.
node wiki --version
# 1.0.78
Når installasjonen er fullført, vil du bli bedt om å kjøre konfigurasjonsveiviseren.
Start konfigurasjonsveiviseren ved å kjøre.
node wiki configure
Dette vil varsle deg om å navigere til for http://localhost:3000å konfigurere Wiki.js. Hvis du har Nginx foran Wiki.js, betyr det at du kan åpne domenenavnet ditt (f.eks. http://wiki.example.com) i stedet for å gå til localhost.
Bruk nettleseren din, naviger til http://wiki.example.comog følg instruksjonene på skjermen. Alle innstillingene som ble angitt under konfigurasjonsveiviseren, lagres i config.ymlfilen. Konfigurasjonsveiviseren vil automatisk starte Wiki.js for deg.
Sett opp PM2
Som standard vil ikke Wiki.js starte automatisk etter en omstart av systemet. For å få det til å starte ved oppstart, må vi sette opp PM2-prosessbehandler. PM2 kommer sammen med Wiki.js som en lokal NPM-modul, så vi trenger ikke å installere PM2 globalt.
Be PM2 om å konfigurere seg selv som en oppstartstjeneste ved å kjøre:
/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup
Til slutt lagrer du gjeldende PM2-konfigurasjon ved å kjøre kommandoen: /var/www/wiki.example.com/node_modules/pm2/bin/pm2 save
Wiki.js-forekomsten din kjører som en bakgrunnsprosess, og bruker PM2 som prosessbehandler.