Krav
Installer Git
Installer Node.js
Installer MongoDB
Installer og konfigurer Nginx
Installer Acme.sh og få et 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 Debian 9 Vultr-instans ved å bruke Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.
Krav
- Node.js 6.9.0 eller nyere
- MongoDB 3.2 eller nyere
- Nginx
- Git 2.7.4 eller nyere
- Et Git-kompatibelt depot (offentlig eller privat) ( valgfritt )
- Minimum på
768MB RAM
- Domenenavn med
A/ AAAAposter satt opp
Sjekk Debian-versjonen.
lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)
Sørg for at systemet ditt er oppdatert.
apt update && apt upgrade -y
Installer nødvendige pakker.
apt install -y build-essential apt-transport-https sudo curl wget dirmngr sudo
Opprett en ny non-rootbrukerkonto med sudotilgang og bytt til den.
adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe
MERK : Erstatt johndoemed brukernavnet ditt.
Sett opp tidssonen.
sudo dpkg-reconfigure tzdata
Installer Git
Installer Git på Debian.
sudo apt install -y git
Bekreft Git-versjonen.
git --version
# git version 2.11.0
Installer Node.js
Installer Node.js ved å bruke NodeSource APT-depot for Node.js.
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt install -y nodejs
Sjekk Node.js- og npm-versjonene.
node -v && npm -v
# v8.11.2
# 5.6.0
Installer MongoDB
Wiki.js bruker MongoDB som en databasemotor. I følge det må vi installere MongoDB på serveren vår. Vi vil bruke de offisielle MongoDB-depotene for installasjon.
Installer MongoDB Community Edition.
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/3.6 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
sudo apt update
sudo apt install -y mongodb-org
Sjekk versjonen.
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
Det anbefales sterkt å sette en standard webserver foran Wiki.js. Dette sikrer at du kan bruke funksjoner som SSL, flere nettsteder, caching og mer. Vi vil bruke Nginx i denne opplæringen, men enhver annen server vil gjøre det, du trenger bare å konfigurere den riktig.
Installer Nginx.
wget https://nginx.org/keys/nginx_signing.key
sudo apt-key add nginx_signing.key
rm nginx_signing.key
sudo -s
printf "deb https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx
Sjekk versjonen.
sudo 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 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 og få et 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 vil vi bruke 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 versjonen.
/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
MERK : Ikke glem å erstatte wiki.example.commed ditt domenenavn.
Etter å ha kjørt kommandoene ovenfor, vil sertifikatene og nøklene dine være i følgende kataloger.
- For RSA:
/etc/letsencrypt/wiki.example.comkatalog.
- For ECC/ECDSA:
/etc/letsencrypt/wiki.example.com_ecckatalog.
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/example.com.key;
# ECDSA
ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/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-prosessbehandleren. 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.
/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup
Til slutt lagrer du gjeldende PM2-konfigurasjon.
/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. Du kan starte operativsystemet på nytt med sudo rebootog sjekke om Wiki.js starter etter en omstart.