Krav
Før du begynner
Installer Node.js
Installer MongoDB
Installer Acme.sh og få et Let's Encrypt-sertifikat (valgfritt)
Installer og konfigurer Nginx
Installer Wiki.js
Installer og konfigurer PM2-prosessbehandler
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 FreeBSD 11 Vultr-instans ved å bruke Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.
Krav
Kravene for å kjøre Wiki.js er som følger:
- Node.js versjon 6.11.1 eller nyere
- MongoDB versjon 3.2 eller nyere
- Git versjon 2.7.4 eller nyere
- En webserver som Nginx, Apache, IIS, Caddy eller H2O. Denne veiledningen vil bruke Nginx.
- Et Git-kompatibelt depot (offentlig eller privat) Dette er valgfritt
- Minst 512 MB RAM. Det anbefales sterkt å bruke en maskin med minst 1 GB RAM.
- Domenenavn med
A/ AAAAposter satt opp. I denne guiden vil vi bruke wiki.example.comsom eksempeldomene.
Før du begynner
Sjekk FreeBSD-versjonen.
uname -ro
# FreeBSD 11.2-RELEASE
Sørg for at ditt FreeBSD-system er oppdatert.
freebsd-update fetch install
pkg update && pkg upgrade -y
Installer sudo, vim, unzip, wget, git, bashog socatpakker hvis de ikke finnes på systemet.
pkg install -y sudo vim unzip wget git bash socat
Opprett en ny brukerkonto med ditt foretrukne brukernavn (vi bruker johndoe).
adduser
# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!
Kjør visudokommandoen og fjern kommentarfeltet for %wheel ALL=(ALL) ALLå la medlemmer av wheelgruppen utføre en hvilken som helst kommando.
# Uncomment by removing the hash (#) sign
%wheel ALL=(ALL) ALL
Nå bytter du til den nyopprettede brukeren.
su - johndoe
MERK: Erstatt johndoemed brukernavnet ditt.
Sett opp tidssonen.
sudo tzsetup
Installer Node.js
Wiki.js krever Node.js 6.11.1 eller nyere, så vi må først installere riktig versjon av Node.js.
Installer Node.js og NPM.
sudo pkg install -y node8 npm-node8
Sjekk versjonene.
node -v && npm -v
# v8.12.0
# 6.4.1
Installer MongoDB
Wiki.js bruker MongoDB som en databasemotor.
Installer MongoDB.
sudo pkg install -y mongodb36
Sjekk versjonen.
mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.6
# db version v3.6.6
Aktiver og start MongoDB.
sudo sysrc mongod_enable=yes
sudo service mongod start
Installer Acme.sh og få et Let's Encrypt-sertifikat ( valgfritt )
Det er ikke nødvendig å sikre wikien din med HTTPS, 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.8.0
Skaff RSA- og ECDSA-sertifikater for wiki.example.com.
# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength ec-256
Etter å ha kjørt kommandoene ovenfor, vil sertifikatene og nøklene dine være i følgende kataloger:
- RSA:
/etc/letsencrypt/wiki.example.com
- 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.
Wiki.js kan kjøre uten noen faktisk webserver, men det anbefales sterkt å sette en standard webserver foran den. 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 pkg install -y nginx
Sjekk versjonen.
nginx -v
# nginx version: nginx/1.14.0
Aktiver og start Nginx.
sudo sysrc nginx_enable=yes
sudo service nginx start
Konfigurer Nginx som en HTTPS (hvis du bruker SSL) omvendt proxy for Wiki.js-applikasjonen.
Kjør sudo vim /usr/local/etc/nginx/wiki.js.confog fyll den med den grunnleggende omvendte proxy-konfigurasjonen nedenfor.
server {
listen [::]:443 ssl http2;
listen 443 ssl http2;
listen [::]:80;
listen 80;
server_name wiki.example.com;
charset utf-8;
client_max_body_size 50M;
# 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;
}
}
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. Lagre filen og avslutt med :+ W+Q
Nå må vi inkludere wiki.js.conffilen i hovedfilen nginx.conf.
Kjør sudo vim /usr/local/etc/nginx/nginx.confog legg til følgende linje i http {}blokken.
include wiki.js.conf;
Sjekk konfigurasjonen.
sudo nginx -t
Last inn Nginx på nytt.
sudo service nginx reload
Installer Wiki.js
Opprett en tom dokumentrotmappe der Wiki.js skal installeres.
sudo mkdir -p /usr/local/www/wiki.example.com
Naviger til dokumentrotmappen.
cd /usr/local/www/wiki.example.com
Endre eierskap av /usr/local/www/wiki.example.commappe til bruker johndoe.
sudo chown -R johndoe:johndoe /usr/local/www/wiki.example.com
/usr/local/www/wiki.example.comKjør følgende kommandoer fra mappen for å laste ned og installere Wiki.js.
curl -sSo- https://wiki.js.org/install.sh | bash
VERSION=$(curl -L -s -S https://beta.requarks.io/api/version/stable)
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/wiki-js.tar.gz | tar -f - -xz -C .
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/node_modules.tar.gz | tar -f - -xz -C .
cp -n config.sample.yml config.yml
Du kan kjøre følgende kommando for å se den installerte versjonen av Wiki.js.
node wiki --version
# 1.0.102
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.
Installer og konfigurer PM2-prosessbehandler
Som standard vil ikke Wiki.js starte automatisk etter en omstart av systemet. For å få det til å starte ved oppstart, må vi installere og konfigurere PM2-prosessbehandling.
Installer PM2 globalt via npm.
sudo npm install -g pm2
Sjekk versjonen.
pm2 -v
# 3.2.2
Naviger til dokumentrotmappen din hvis du ikke allerede er der, og stopp Wiki.js.
cd /usr/local/www/wiki.example.com
node wiki stop
Start Wiki.js via PM2.
pm2 start server/index.js --name "Wiki.js"
Listeprosess administrert av PM2.
pm2 list
Be PM2 om å konfigurere seg selv som en oppstartstjeneste ved å kjøre:
pm2 startup
Til slutt lagrer du gjeldende PM2-konfigurasjon ved å kjøre kommandoen:
pm2 save
Wiki.js-forekomsten din kjører nå som en bakgrunnsprosess, og bruker PM2 som prosessbehandler.