Како инсталирати Вики.јс на Федора 28

Вики.јс је бесплатна модерна вики апликација отвореног кода изграђена на Ноде.јс, МонгоДБ, Гит и Маркдовн. Вики.јс изворни код је јавно хостован на Гитхуб-у . Овај водич ће вам показати како да инсталирате Вики.јс на нову Федора 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 [email protected]
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 [email protected] --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 [email protected] --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 као менаџер процеса.