Krav
Installer Git
Installer Node.js
Installer MongoDB
Installer og konfigurer Nginx
Installer Acme.sh-klienten og få et Let's Encrypt-sertifikat (valgfritt)
Installer Wiki.js
Installer PM2
Wiki.js er en gratis og åpen kildekode, moderne wiki-app bygget på Node.js , Git og Markdown . Wiki.js kildekode er offentlig vert på Github . Denne guiden viser deg hvordan du installerer Wiki.js på en fersk Ubuntu 18.04 LTS Vultr-forekomst ved å bruke Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.
Krav
Kravene for å kjøre Wiki.js og fullføre denne veiledningen er som følger:
- Node.js versjon 6.9.0 eller nyere
- MongoDB versjon 3.2 eller nyere
- Nginx
- Git versjon 2.7.4 eller nyere
- Minimum 768 MB RAM
- Domenenavn med
A/ AAAAposter satt opp
Sjekk Ubuntu-versjonen.
lsb_release -ds
# Ubuntu 18.04.4 LTS
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
Sørg for at systemet ditt er oppdatert.
sudo apt update && sudo apt upgrade -y
Installer nødvendige pakker.
sudo apt install -y build-essential apt-transport-https
Installer Git
Git 2.7.4 kommer forhåndsinstallert på Ubuntu server edition, så vi trenger ikke å installere den. Hvis du vil installere en nyere versjon, kan du bruke tredjeparts PPAer eller kompilere den siste utgivelsen av Git fra kilden.
Du kan bekrefte den installerte versjonen av Git ved å kjøre:
git --version
# git version 2.7.4
Hvis du vil installere en nyere versjon av Git-programvaren, kan du bruke følgende.
# Remove existing git package
sudo apt remove -y git
sudo apt-get install software-properties-common
sudo add-apt-repository -y ppa:git-core/ppa
sudo apt update && sudo apt upgrade -y
sudo apt install -y git
Bekreft Git-versjonen.
git --version
# git version 2.17.0
Installer Node.js
Installer Node.js ved å bruke NodeSource APT-depotet 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
Vi vil bruke de offisielle MongoDB-repositoriene , som holdes oppdatert med de siste store og mindre MongoDB-utgivelsene.
Installer MongoDB Community Edition.
sudo apt install -y mongodb
Sjekk versjonen.
mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.3
# db version v3.6.3
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/ubuntu/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/ubuntu/ $(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 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 i tillegg 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å et Let's Encrypt-sertifikat (valgfritt)
Å sikre wikien din med HTTPSer ikke nødvendig, men det vil sikre nettstedets trafikk. Acme.sh er en ren unix-skallprogramvare for å få SSL-sertifikater fra Let's Encrypt med null avhengigheter.
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
Skaff RSA- og ECDSA-sertifikater for wiki.example.comdomene/vertsnavn.
# 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.comkatalogen.
- For ECC/ECDSA:
/etc/letsencrypt/wiki.example.com_ecckatalogen.
Etter å ha fått sertifikater fra Let's Encrypt, må vi konfigurere Nginx til å bruke 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.commappen til brukeren 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
For å se den installerte versjonen av Wiki.js, kan du kjøre følgende kommando.
node wiki --version
# 1.0.78
Når installasjonen er fullført, vil du bli bedt om å kjøre konfigurasjonsveiviseren.
Start konfigurasjonsveiviseren.
node wiki configure
Dette vil varsle deg om å bla til for http://localhost:3000å konfigurere Wiki.js. Hvis du har Nginx foran Wiki.js, kan du å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 innstillinger som ble angitt under konfigurasjonsveiviseren, lagres i config.ymlfilen. Konfigurasjonsveiviseren vil automatisk starte Wiki.js for deg.
Installer 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. 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 kjører som en bakgrunnsprosess, og bruker PM2 som prosessbehandler.