Как да инсталирате Wiki.js на FreeBSD 11

Wiki.js е безплатно и модерно уики приложение с отворен код, изградено на Node.js, MongoDB, Git и Markdown. Изходният код на Wiki.js се хоства публично на Github . Това ръководство ще ви покаже как да инсталирате Wiki.js на нов екземпляр на FreeBSD 11 Vultr, като използвате Node.js, MongoDB, PM2, Nginx, Git и Acme.sh.

Изисквания

Изискванията за стартиране на Wiki.js са както следва:

• Node.js версия 6.11.1 или по-нова
• MongoDB версия 3.2 или по-нова
• Git версия 2.7.4 или по-нова
• Уеб сървър като Nginx, Apache, IIS, Caddy или H2O. Това ръководство ще използва Nginx.
• Git-съвместимо хранилище (публично или частно) Това е по избор
• Минимум 512MB RAM. Силно препоръчително е да използвате машина с поне 1GB RAM.
• Име на домейн с A/ AAAAнастроени записи. В това ръководство ще използваме wiki.example.comкато примерен домейн.

Преди да започнеш

Проверете версията на FreeBSD.

uname -ro
# FreeBSD 11.2-RELEASE

Уверете се, че вашата FreeBSD система е актуална.

freebsd-update fetch install
pkg update && pkg upgrade -y

Инсталирайте sudo, vim, unzip, wget, git, bashи socatпакети, ако те не присъстват във вашата система.

pkg install -y sudo vim unzip wget git bash socat

Създайте нов потребителски акаунт с предпочитаното от вас потребителско име (ние ще използваме 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!

Изпълнете visudoкомандата и разкоментирайте %wheel ALL=(ALL) ALLреда, за да позволите на членовете на wheelгрупата да изпълнят всяка команда.

# Uncomment by removing the hash (#) sign
%wheel ALL=(ALL) ALL

Сега превключете към новосъздадения си потребител.

su - johndoe

ЗАБЕЛЕЖКА: Заменете johndoeс вашето потребителско име.

Настройте часовата зона.

sudo tzsetup

Инсталирайте Node.js

Wiki.js изисква Node.js 6.11.1 или по-нова версия, така че първо ще трябва да инсталираме подходящата версия на Node.js.

Инсталирайте Node.js и NPM.

sudo pkg install -y node8 npm-node8

Проверете версиите.

node -v && npm -v
# v8.12.0
# 6.4.1

Инсталирайте MongoDB

Wiki.js използва MongoDB като машина за база данни.

Инсталирайте MongoDB.

sudo pkg install -y mongodb36

Проверете версията.

mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.6
# db version v3.6.6

Активирайте и стартирайте MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Инсталирайте Acme.sh и получете сертификат Let's Encrypt ( по избор )

Защитата на вашето уики с HTTPS не е необходима, но е добра практика да защитите трафика на вашия сайт. За да получим SSL сертификат от Let's Encrypt, ще използваме Acme.sh клиент. Acme.sh е чист софтуер за unix обвивка за получаване на SSL сертификати от Let's Encrypt с нулеви зависимости. Това го прави много лек в сравнение с някои други клиенти на протокола Acme, които изискват много зависимости, за да работят успешно.

Изтеглете и инсталирайте 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 [email protected]
cd ~

Проверете acme.shверсията.

/etc/letsencrypt/acme.sh --version
# v2.8.0

Получете RSA и ECDSA сертификати за 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

След като изпълните командите по-горе, вашите сертификати и ключове ще бъдат в следните директории:

• RSA: /etc/letsencrypt/wiki.example.com
• ECC/ECDSA: /etc/letsencrypt/wiki.example.com_ecc

ЗАБЕЛЕЖКА: Не забравяйте да замените wiki.example.comс името на вашия домейн.

След като получим сертификати от Let's Encrypt, трябва да конфигурираме Nginx, за да се възползваме от тях.

Инсталирайте и конфигурирайте Nginx

Wiki.js може да работи без реален уеб сървър, но силно се препоръчва да поставите стандартен уеб сървър пред него. Това гарантира, че можете да използвате функции като SSL, множество уебсайтове, кеширане и други. Ще използваме Nginx в този урок, но всеки друг сървър ще свърши работа, просто трябва да го конфигурирате правилно.

Инсталирайте Nginx.

sudo pkg install -y nginx

Проверете версията.

nginx -v
# nginx version: nginx/1.14.0

Активирайте и стартирайте Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Конфигурирайте Nginx като HTTPS (ако използвате SSL) обратен прокси за приложението Wiki.js.

Стартирайте sudo vim /usr/local/etc/nginx/wiki.js.confи го попълнете с основната конфигурация за обратен прокси по-долу.

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;
  }

}

Единственото нещо, което трябва да промените в конфигурацията по-горе, е server_nameдирективата и евентуално proxy_passдирективата, ако решите да конфигурирате някакъв порт, различен от 3000. Wiki.js използва порт 3000по подразбиране. Запазете файла и излезте с :+ W+Q

Сега трябва да включим wiki.js.confфайла в основния nginx.confфайл.

Изпълнете sudo vim /usr/local/etc/nginx/nginx.confи добавете следния ред към http {}блока.

include wiki.js.conf;

Проверете конфигурацията.

sudo nginx -t

Презаредете Nginx.

sudo service nginx reload

Инсталирайте Wiki.js

Създайте празна основна папка на документа, където ще бъде инсталиран Wiki.js.

sudo mkdir -p /usr/local/www/wiki.example.com

Придвижете се до главната папка на документа.

cd /usr/local/www/wiki.example.com

Промяна на собствеността върху /usr/local/www/wiki.example.comпапката на потребител johndoe.

sudo chown -R johndoe:johndoe /usr/local/www/wiki.example.com

От /usr/local/www/wiki.example.comпапката изпълнете следните команди, за да изтеглите и инсталирате 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

Можете да изпълните следната команда, за да видите текущо инсталираната версия на Wiki.js.

node wiki --version
# 1.0.102

След като инсталацията приключи, ще бъдете подканени да стартирате съветника за конфигурация.

Стартирайте съветника за конфигурация, като стартирате.

node wiki configure

Това ще ви уведоми да отидете до, за http://localhost:3000да конфигурирате Wiki.js. Ако имате Nginx пред Wiki.js, това означава, че можете да отворите името на вашия домейн (напр. http://wiki.example.com), вместо да отидете на localhost.

С помощта на вашия уеб браузър отидете http://wiki.example.comи следвайте инструкциите на екрана. Всички настройки, въведени по време на съветника за конфигурация, се записват във config.ymlфайла. Съветникът за конфигурация автоматично ще стартира Wiki.js вместо вас.

Инсталирайте и настройте PM2 процесния мениджър

По подразбиране Wiki.js няма да се стартира автоматично след рестартиране на системата. За да го накараме да стартира при стартиране, трябва да инсталираме и настроим PM2 процесния мениджър.

Инсталирайте PM2 глобално чрез npm.

sudo npm install -g pm2

Проверете версията.

pm2 -v
# 3.2.2

Придвижете се до основната папка на вашия документ, ако все още не сте там и спрете Wiki.js.

cd /usr/local/www/wiki.example.com
node wiki stop

Стартирайте Wiki.js чрез PM2.

pm2 start server/index.js --name "Wiki.js"

Списък процес, управляван от PM2.

pm2 list

Кажете на PM2 да се конфигурира като стартираща услуга, като изпълни:

pm2 startup

Накрая запазете текущата конфигурация на PM2, като изпълните командата:

pm2 save

Вашият екземпляр на Wiki.js вече работи като фонов процес, използвайки PM2 като мениджър на процеси.