Zahtjevi
Prije nego što počneš
Instalirajte Node.js
Instalirajte MongoDB
Instalirajte Acme.sh i pribavite certifikat Let's Encrypt (opcionalno)
Instalirajte i konfigurirajte Nginx
Instalirajte Wiki.js
Instalirajte i postavite PM2 upravitelja procesa
Wiki.js je besplatna i moderna wiki aplikacija otvorenog koda izgrađena na Node.js, MongoDB, Git i Markdown. Izvorni kod Wiki.js javno se nalazi na Githubu . Ovaj vodič će vam pokazati kako instalirati Wiki.js na novu instancu FreeBSD 11 Vultr koristeći Node.js, MongoDB, PM2, Nginx, Git i Acme.sh.
Zahtjevi
Zahtjevi za pokretanje Wiki.js su sljedeći:
- Node.js verzija 6.11.1 ili novija
- MongoDB verzija 3.2 ili novija
- Git verzija 2.7.4 ili novija
- Web poslužitelj kao što je Nginx, Apache, IIS, Caddy ili H2O. Ovaj vodič će koristiti Nginx.
- Git-kompatibilno spremište (javno ili privatno) Ovo nije obavezno
- Minimalno 512 MB RAM-a. Preporučljivo je koristiti stroj s najmanje 1 GB RAM-a.
- Ime domene sa
A/ AAAApostavljenim zapisima. U ovom vodiču koristit ćemo wiki.example.comkao primjer domene.
Prije nego što počneš
Provjerite verziju FreeBSD-a.
uname -ro
# FreeBSD 11.2-RELEASE
Provjerite je li vaš FreeBSD sustav ažuriran.
freebsd-update fetch install
pkg update && pkg upgrade -y
Instalirajte sudo, vim, unzip, wget, git, bashi socatpakete ako nisu prisutni na vašem sustavu.
pkg install -y sudo vim unzip wget git bash socat
Izradite novi korisnički račun sa svojim željenim korisničkim imenom (koristit ćemo 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!
Pokrenite visudonaredbu i dekomentirajte %wheel ALL=(ALL) ALLredak kako biste omogućili članovima wheelgrupe da izvrše bilo koju naredbu.
# Uncomment by removing the hash (#) sign
%wheel ALL=(ALL) ALL
Sada se prebacite na svog novostvorenog korisnika.
su - johndoe
NAPOMENA: Zamijenite johndoesvojim korisničkim imenom.
Postavite vremensku zonu.
sudo tzsetup
Instalirajte Node.js
Wiki.js zahtijeva Node.js 6.11.1 ili noviju, pa ćemo prvo morati instalirati odgovarajuću verziju Node.js.
Instalirajte Node.js i NPM.
sudo pkg install -y node8 npm-node8
Provjerite verzije.
node -v && npm -v
# v8.12.0
# 6.4.1
Instalirajte MongoDB
Wiki.js koristi MongoDB kao motor baze podataka.
Instalirajte MongoDB.
sudo pkg install -y mongodb36
Provjerite verziju.
mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.6
# db version v3.6.6
Omogućite i pokrenite MongoDB.
sudo sysrc mongod_enable=yes
sudo service mongod start
Instalirajte Acme.sh i pribavite certifikat Let's Encrypt ( opcionalno )
Osiguravanje vašeg wikija HTTPS-om nije potrebno, ali je dobra praksa osigurati promet na web-lokaciji. Za dobivanje SSL certifikata od Let's Encrypt koristit ćemo Acme.sh klijent. Acme.sh je čista unix shell softver za dobivanje SSL certifikata od Let's Encrypt s nula ovisnosti. To ga čini vrlo laganim u usporedbi s nekim drugim klijentima Acme protokola koji zahtijevaju puno ovisnosti za uspješno izvođenje.
Preuzmite i instalirajte 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 ~
Provjerite acme.shverziju.
/etc/letsencrypt/acme.sh --version
# v2.8.0
Dobiti RSA i ECDSA certifikate za 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
Nakon pokretanja gornjih naredbi, vaši će certifikati i ključevi biti u sljedećim direktorijima:
- RSA:
/etc/letsencrypt/wiki.example.com
- ECC/ECDSA:
/etc/letsencrypt/wiki.example.com_ecc
NAPOMENA: Ne zaboravite zamijeniti wiki.example.comimenom svoje domene.
Nakon što smo dobili certifikate od Let's Encrypt, moramo konfigurirati Nginx da ih iskoristi.
Wiki.js može raditi bez ikakvog stvarnog web poslužitelja, no preporučljivo je staviti standardni web poslužitelj ispred njega. To osigurava da možete koristiti značajke kao što su SSL, više web-mjesta, predmemorija i druge. Koristit ćemo Nginx u ovom vodiču, ali bilo koji drugi poslužitelj će učiniti, samo ga trebate pravilno konfigurirati.
Instalirajte Nginx.
sudo pkg install -y nginx
Provjerite verziju.
nginx -v
# nginx version: nginx/1.14.0
Omogućite i pokrenite Nginx.
sudo sysrc nginx_enable=yes
sudo service nginx start
Konfigurirajte Nginx kao HTTPS (ako koristite SSL) obrnuti proxy za aplikaciju Wiki.js.
Pokrenite ga sudo vim /usr/local/etc/nginx/wiki.js.confi popunite ga osnovnom konfiguracijom obrnutog proxyja u nastavku.
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;
}
}
Jedina stvar koju trebate promijeniti u gornjoj konfiguraciji je server_namedirektiva, a potencijalno i proxy_passdirektiva ako odlučite konfigurirati neki port koji nije 3000. Wiki.js 3000prema zadanim postavkama koristi port . Spremite datoteku i izađite s :+ W+Q
Sada moramo uključiti wiki.js.confdatoteku u glavnu nginx.confdatoteku.
Pokrenite sudo vim /usr/local/etc/nginx/nginx.confi dodajte sljedeći redak u http {}blok.
include wiki.js.conf;
Provjerite konfiguraciju.
sudo nginx -t
Ponovno učitajte Nginx.
sudo service nginx reload
Instalirajte Wiki.js
Napravite praznu korijensku mapu dokumenta u koju će biti instaliran Wiki.js.
sudo mkdir -p /usr/local/www/wiki.example.com
Idite do korijenske mape dokumenta.
cd /usr/local/www/wiki.example.com
Promijenite vlasništvo nad /usr/local/www/wiki.example.commapom na korisnika johndoe.
sudo chown -R johndoe:johndoe /usr/local/www/wiki.example.com
Iz /usr/local/www/wiki.example.commape pokrenite sljedeće naredbe za preuzimanje i instaliranje 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
Možete pokrenuti sljedeću naredbu kako biste vidjeli trenutno instaliranu verziju Wiki.js.
node wiki --version
# 1.0.102
Nakon dovršetka instalacije, od vas će se tražiti da pokrenete čarobnjak za konfiguraciju.
Pokrenite čarobnjak za konfiguraciju pokretanjem.
node wiki configure
Ovo će vas obavijestiti da http://localhost:3000prijeđete na konfiguraciju Wiki.js. Ako imate Nginx ispred Wiki.js, onda to znači da možete otvoriti naziv svoje domene (npr. http://wiki.example.com) umjesto da idete na localhost.
Koristeći svoj web preglednik, idite do http://wiki.example.comi slijedite upute na zaslonu. Sve postavke unesene tijekom čarobnjaka za konfiguraciju spremaju se u config.ymldatoteku. Čarobnjak za konfiguraciju automatski će pokrenuti Wiki.js umjesto vas.
Instalirajte i postavite PM2 upravitelja procesa
Prema zadanim postavkama, Wiki.js se neće automatski pokrenuti nakon ponovnog pokretanja sustava. Da bi se pokrenuo pri pokretanju, moramo instalirati i postaviti PM2 upravitelj procesa.
Instalirajte PM2 globalno putem npm.
sudo npm install -g pm2
Provjerite verziju.
pm2 -v
# 3.2.2
Dođite do korijenske mape dokumenta ako već niste tamo i zaustavite Wiki.js.
cd /usr/local/www/wiki.example.com
node wiki stop
Pokrenite Wiki.js putem PM2.
pm2 start server/index.js --name "Wiki.js"
Proces popisa kojim upravlja PM2.
pm2 list
Recite PM2 da se konfigurira kao servis za pokretanje tako što će pokrenuti:
pm2 startup
Konačno, spremite trenutnu PM2 konfiguraciju pokretanjem naredbe:
pm2 save
Vaša Wiki.js instanca sada radi kao pozadinski proces, koristeći PM2 kao upravitelj procesa.