Захтеви
Пре него што почнете
Инсталирајте Ноде.јс
Инсталирајте МонгоДБ
Инсталирајте и конфигуришите Нгинк
Инсталирајте Ацме.сх клијент и набавите Лет'с Енцрипт сертификат (опционо)
Инсталирајте Вики.јс
Подешавање ПМ2
Вики.јс је бесплатна модерна вики апликација отвореног кода изграђена на Ноде.јс, МонгоДБ, Гит и Маркдовн. Вики.јс изворни код је јавно хостован на Гитхуб-у . Овај водич ће вам показати како да инсталирате Вики.јс на нову Федора 28 Вултр инстанцу користећи Ноде.јс, МонгоДБ, ПМ2, Нгинк, Гит и Ацме.сх.
Захтеви
Захтеви за покретање Вики.јс су следећи:
- Ноде.јс верзија 6.9.0 или новија
- МонгоДБ верзија 3.2 или новија
- Веб сервер као што је Нгинк, Апацхе, ИИС, Цадди или Х2О. Овај водич ће користити Нгинк
- Гит верзија 2.7.4 или новија
- Гит усаглашено спремиште (јавно или приватно) Ово је опционо
- Најмање 768 МБ РАМ-а
- Име домена са
A/ AAAAпостављеним записима
Пре него што почнете
Проверите верзију ОС-а.
cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)
Креирајте нови не-роот кориснички налог са судо приступом и пребаците се на њега.
useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe
НАПОМЕНА: Замените johndoeсвојим корисничким именом.
Уверите се да је ваш систем ажуриран.
sudo dnf check-upgrade || sudo dnf upgrade -y
Подесите временску зону.
timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'
Инсталирајте потребне и корисне пакете.
sudo dnf install -y wget vim unzip bash-completion git
Ради једноставности, онемогућите СЕЛинук и заштитни зид.
sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld
Инсталирајте Ноде.јс
Вики.јс захтева Ноде.јс 6.9.0 или новију верзију, тако да ћемо прво морати да инсталирамо Ноде.јс.
Инсталирајте Ноде.јс.
sudo dnf install -y nodejs
Проверите верзије Ноде.јс и нпм.
node -v && npm -v
# v8.11.3
# 5.6.0
Инсталирајте МонгоДБ
Вики.јс користи МонгоДБ као механизам за базе података. Према томе, мораћемо да инсталирамо МонгоДБ на наш сервер.
Инсталирајте МонгоДБ.
sudo dnf install -y mongodb mongodb-server
Проверите верзију МонгоДБ-а.
mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.3
# db version v3.6.3
Омогућите и покрените МонгоДБ.
sudo systemctl enable mongod.service
sudo systemctl start mongod.service
Вики.јс може да ради без стварног веб сервера (као што је Нгинк или Апацхе). Међутим, препоручљиво је ставити стандардни веб сервер испред Вики.јс. Ово осигурава да можете да користите функције као што су ССЛ, више веб локација, кеширање и друге. Користићемо Нгинк у овом водичу, али било који други сервер ће то учинити, само треба да га правилно конфигуришете.
Инсталирајте Нгинк.
sudo dnf install -y nginx
Проверите верзију.
nginx -v
# nginx version: nginx/1.12.1
Омогућите и покрените Нгинк.
sudo systemctl enable nginx.service
sudo systemctl start nginx.service
Конфигуришите Нгинк као HTTPили HTTPS(ако користите ССЛ) обрнути прокси за апликацију Вики.јс.
Покрените sudo vim /etc/nginx/conf.d/wiki.js.confи попуните га основном конфигурацијом обрнутог проксија у наставку.
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;
}
}
Једина ствар коју треба да промените у горњој конфигурацији је server_nameдиректива, а потенцијално и proxy_passдиректива ако одлучите да конфигуришете неки порт који није 3000. Вики.јс подразумевано користи порт 3000.
Проверите конфигурацију.
sudo nginx -t
Поново учитај Нгинк.
sudo systemctl reload nginx.service
Инсталирајте Ацме.сх клијент и набавите Лет'с Енцрипт сертификат (опционо)
Обезбеђивање вашег вики-ја помоћу HTTPSније неопходно, али је добра пракса да обезбедите саобраћај на сајту. Да бисмо добили ССЛ сертификат од Лет'с Енцрипт, користићемо Ацме.сх клијент. Ацме.сх је чиста уникс схелл софтвер за добијање ССЛ сертификата од Лет'с Енцрипт са нула зависности. То га чини веома лаганим у поређењу са неким другим клијентима АЦМЕ протокола који захтевају много зависности да би се успешно покренули.
Преузети и инсталирати Ацме.сх .
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 ~
Проверите acme.shверзију.
/etc/letsencrypt/acme.sh --version
# v2.7.9
Набавите РСА и ЕЦДСА сертификате за 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
Након покретања горњих команди, ваши сертификати и кључеви ће бити у:
- За РСА:
/etc/letsencrypt/wiki.example.com
- За ЕЦЦ/ЕЦДСА:
/etc/letsencrypt/wiki.example.com_ecc
НАПОМЕНА : Не заборавите да замените wiki.example.comсвојим именом домена.
Након добијања сертификата од Лет'с Енцрипт, морамо да конфигуришемо Нгинк да их искористи.
Покрените sudo vim /etc/nginx/conf.d/wiki.js.confпоново и конфигуришите Нгинк као HTTPSобрнути прокси.
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;
}
}
Проверите конфигурацију.
sudo nginx -t
Поново учитај Нгинк.
sudo systemctl reload nginx.service
Инсталирајте Вики.јс
Направите празан основни фолдер документа, где треба да буде инсталиран Вики.јс.
sudo mkdir -p /var/www/wiki.example.com
Идите до коренске фасцикле документа.
cd /var/www/wiki.example.com
Промените власништво над /var/www/wiki.example.comфолдером на корисника johndoe.
sudo chown -R johndoe:johndoe /var/www/wiki.example.com
Из /var/www/wiki.example.comфасцикле покрените следећу команду да преузмете и инсталирате Вики.јс.
curl -sSo- https://wiki.js.org/install.sh | bash
Можете покренути следећу команду да бисте видели тренутно инсталирану верзију Вики.јс.
node wiki --version
# 1.0.78
Када се инсталација заврши, од вас ће бити затражено да покренете чаробњак за конфигурацију.
Покрените чаробњак за конфигурацију покретањем.
node wiki configure
Ово ће вас обавестити да одете до да http://localhost:3000бисте конфигурисали Вики.јс. Ако имате Нгинк испред Вики.јс, онда то значи да можете да отворите име свог домена (нпр. http://wiki.example.com) уместо да идете на localhost.
Користећи веб прегледач, идите до http://wiki.example.comи пратите упутства на екрану. Сва подешавања унета током конфигурационог чаробњака се чувају у config.ymlдатотеци. Чаробњак за конфигурацију ће аутоматски покренути Вики.јс уместо вас.
Подешавање ПМ2
Подразумевано, Вики.јс се неће аутоматски покренути након поновног покретања система. Да би се покренуо при покретању, морамо да подесимо ПМ2 менаџер процеса. ПМ2 долази у пакету са Вики.јс као локалним НПМ модулом, тако да не морамо да инсталирамо ПМ2 глобално.
Реците ПМ2 да се конфигурише као сервис за покретање тако што ће покренути:
/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup
Коначно, сачувајте тренутну ПМ2 конфигурацију тако што ћете покренути наредбу: /var/www/wiki.example.com/node_modules/pm2/bin/pm2 save
Ваша Вики.јс инстанца ради као позадински процес, користећи ПМ2 као менаџер процеса.