Как установить Selfoss RSS Reader на VBS FreeBSD 11 FAMP

• Предпосылки
• Шаг 1: Добавить пользователя Sudo
• Шаг 2. Обновление системы FreeBSD 11
• Шаг 3: Установите веб-сервер Apache
• Шаг 4: Установите PHP 7.1
• Шаг 5: Установите сервер MariaDB (MySQL)
• Шаг 6: Создайте базу данных для Selfoss RSS Reader
• Шаг 7: Установите файлы Selfoss для чтения RSS
• Шаг 8: Установите и запустите Composer
• Шаг 9: Завершите установку Selfoss RSS Reader

Selfoss RSS Reader - это многоцелевой бесплатный веб-ресурс с открытым исходным кодом, многоцелевой трансляцией в реальном времени, гибридами, программами чтения новостей (RSS / Atom) и универсальным агрегатором. Selfoss RSS Reader поддерживает импорт OPML, спокойный JSON API и систему открытых плагинов, которая позволяет легко расширять функциональность по умолчанию, создавая собственные пользовательские соединители данных. Вы можете использовать Selfoss для прямой трансляции и сбора всех своих сообщений, твитов, подкастов и каналов в одном центральном месте, к которому можно легко получить доступ с любого настольного или мобильного устройства.

В этом руководстве мы собираемся установить Selfoss RSS Reader 2.17 на VBS FreeBSD 11 FAMP с использованием веб-сервера Apache, PHP 7.1 и базы данных MariaDB.

Предпосылки

• Чистый экземпляр сервера Vultr FreeBSD 11 с доступом по SSH

Шаг 1: Добавить пользователя Sudo

Мы начнем с добавления нового sudoпользователя.

Сначала войдите на свой сервер как root:

ssh root@YOUR_VULTR_IP_ADDRESS

Команда sudoне устанавливается по умолчанию в экземпляре сервера Vultr FreeBSD 11, поэтому мы сначала установим sudo:

pkg install sudo

Теперь добавьте нового пользователя с именем user1(или предпочитаемое имя пользователя):

adduser user1

Команда adduserзапросит у вас множество деталей для учетной записи пользователя, поэтому просто выберите значения по умолчанию для большинства из них, когда это имеет смысл. Когда вас спросят, нужно ли Invite user1 into any other groups?вам, вы должны войти, wheelчтобы добавить user1в wheelгруппу.

Теперь проверьте /etc/sudoersфайл, чтобы убедиться, что sudoersгруппа включена:

visudo

Посмотрите на раздел, как это:

# %wheel        ALL=(ALL)       ALL

Эта строка говорит нам, что пользователи, которые являются членами wheelгруппы, могут использовать sudoкоманду для получения rootпривилегий. Он будет закомментирован по умолчанию, поэтому вам нужно раскомментировать его, а затем сохранить и выйти из файла.

Мы можем проверить user1членство в группе с помощью groupsкоманды:

groups user1

Если user1вы не wheelявляетесь членом группы, вы можете использовать эту команду для обновления user1членства в группе:

pw group mod wheel -m user1 

Теперь используйте suкоманду для переключения на новую user1учетную запись пользователя sudo :

su - user1

Командная строка обновится, чтобы указать, что вы вошли в user1учетную запись. Вы можете проверить это с помощью whoamiкоманды:

whoami

Теперь перезапустите sshdслужбу, чтобы вы могли войти через sshновую учетную запись пользователя sudo без полномочий root:

sudo /etc/rc.d/sshd restart

Выход из user1аккаунта:

exit

Выйдите из rootучетной записи (которая отключит ваш sshсеанс):

exit

Теперь вы можете sshвойти в экземпляр сервера с локального хоста, используя новую user1учетную запись пользователя sudo без полномочий root :

ssh user1@YOUR_VULTR_IP_ADDRESS

Если вы хотите выполнить sudo без необходимости каждый раз вводить пароль, затем /etc/sudoersснова откройте файл, используя visudo:

sudo visudo

Отредактируйте раздел для wheelгруппы так, чтобы он выглядел так:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Обратите внимание: отключение требования к паролю для пользователя sudo не рекомендуется, но оно включено здесь, поскольку это может сделать настройку сервера гораздо более удобной и менее раздражающей, особенно во время более длительных сеансов системного администрирования. Если вас беспокоят последствия для безопасности, вы всегда можете вернуть изменение конфигурации к исходному после завершения задач администрирования.

Всякий раз, когда вы хотите войти в rootучетную запись пользователя из sudoучетной записи пользователя, вы можете использовать одну из следующих команд:

sudo -i
sudo su -

Вы можете выйти из rootучетной записи и вернуться к своей sudoучетной записи в любое время:

exit

Шаг 2. Обновление системы FreeBSD 11

Перед установкой любых пакетов на экземпляр сервера FreeBSD мы сначала обновим систему.

Убедитесь, что вы вошли на сервер с помощью пользователя sudo без полномочий root и выполните следующие команды:

sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade

Шаг 3: Установите веб-сервер Apache

Установите веб-сервер Apache:

sudo pkg install apache24

Введите, yкогда будет предложено.

Теперь используйте sysrcкоманду, чтобы включить автоматический запуск службы Apache во время загрузки:

sudo sysrc apache24_enable=yes

Команда sysrcобновляет /etc/rc.confфайл конфигурации, поэтому, если вы хотите проверить обновление конфигурации вручную, вы можете просто открыть /etc/rc.confфайл в вашем любимом редакторе терминала:

vi /etc/rc.conf

Теперь запустите сервис Apache:

sudo service apache24 start

Вы можете быстро проверить, работает ли Apache, посетив IP-адрес или домен экземпляра сервера в вашем браузере:

http://YOUR_VULTR_IP_ADDRESS/

Вы увидите страницу Apache FreeBSD по умолчанию с текстом:

It works!

Проверьте файл конфигурации Apache по умолчанию, чтобы убедиться, что DocumentRootдиректива указывает на правильный каталог:

sudo vi /usr/local/etc/apache24/httpd.conf

Опция DocumentRootконфигурации будет выглядеть так:

DocumentRoot "/usr/local/www/apache24/data"

Теперь нам нужно включить mod_rewriteмодуль Apache. Мы можем сделать это, выполнив поиск по умолчанию в файле конфигурации Apache mod_rewrite.

По умолчанию mod_rewriteмодуль Apache будет закомментирован (что означает, что он отключен). Строка конфигурации на чистом экземпляре Vultr FreeBSD 11 будет выглядеть так:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Просто удалите символ хеша, чтобы раскомментировать строку и загрузить модуль. Это, конечно, относится и к любым другим необходимым модулям Apache:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Кроме того, необходимо включить mod_authz_codeи mod_headersмодули, поэтому убедитесь , что они оба раскомментирована тоже:

LoadModule authz_core_module libexec/apache24/mod_authz_core.so
LoadModule headers_module libexec/apache24/mod_headers.so

Теперь нам нужно отредактировать Directoryдирективу Apache в том же файле конфигурации, чтобы mod_rewriteона корректно работала с Selfoss RSS Reader.

Найдите раздел файла конфигурации, который начинается с, <Directory "/usr/local/www/apache24/data">и измените AllowOverride noneна AllowOverride All. Конечный результат (со всеми удаленными комментариями) будет выглядеть примерно так:

<Directory "/var/www/html">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

Теперь сохраните и выйдите из файла конфигурации Apache.

Мы перезапустим Apache в конце этого руководства, но регулярный перезапуск Apache во время установки и настройки, безусловно, является хорошей привычкой, поэтому давайте сделаем это сейчас:

sudo service apache24 restart

Шаг 4: Установите PHP 7.1

Теперь мы можем установить PHP 7.1 вместе со всеми необходимыми модулями PHP, необходимыми для Selfoss RSS Reader:

sudo pkg install php71 mod_php71 php71-gd php71-mbstring php71-mysqli php71-xml php71-curl php71-ctype php71-tokenizer php71-simplexml php71-dom php71-session php71-iconv php71-hash php71-json php71-fileinfo php71-pdo php71-pdo_mysql php71-zlib php71-openssl php71-zip php71-phar

FreeBSD 11 дает нам возможность использовать разработку php.iniили производство php.ini. Поскольку мы собираемся установить Selfoss на общедоступном веб-сервере, мы будем использовать рабочую версию. Сначала сделайте резервную копию php.ini-production:

sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini-production.backup

Тогда софт-ссылка php.ini-productionна php.ini:

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

Нам нужно настроить Apache для фактического использования PHP, поэтому давайте создадим новый файл с именем php.confв Includesкаталоге Apache :

sudo vi /usr/local/etc/apache24/Includes/php.conf

Введите следующий текст во вновь созданный файл:

<IfModule dir_module>
    DirectoryIndex index.php index.html
    <FilesMatch "\.php$">
        SetHandler application/x-httpd-php
    </FilesMatch>
    <FilesMatch "\.phps$">
        SetHandler application/x-httpd-php-source
    </FilesMatch>
</IfModule>

Сохраните и выйдите из файла.

Теперь давайте перезапустим Apache, чтобы он мог перезагрузить изменения конфигурации:

sudo service apache24 restart

Шаг 5: Установите сервер MariaDB (MySQL)

FreeBSD 11 по умолчанию использует сервер базы данных MariaDB, который представляет собой расширенную, полностью открытую, разработанную сообществом замену сервера MySQL.

Установите последнюю версию сервера базы данных MariaDB:

sudo pkg install mariadb102-server mariadb102-client

Запустите и включите сервер MariaDB для автоматического запуска во время загрузки:

sudo sysrc mysql_enable="yes"
sudo service mysql-server start

Защитите установку сервера MariaDB:

sudo mysql_secure_installation

Когда будет предложено создать пользователя MariaDB / MySQL root, выберите «Y» (для «да») и введите безопасный rootпароль. Просто ответьте «Y» на все остальные вопросы «да / нет», так как предложения по умолчанию являются наиболее безопасными.

Шаг 6: Создайте базу данных для Selfoss RSS Reader

Войдите в оболочку MariaDB как rootпользователь MariaDB , выполнив следующую команду:

sudo mysql -u root -p

Чтобы получить доступ к командной строке MariaDB, просто введите rootпароль MariaDB при появлении запроса.

Выполните следующие запросы, чтобы создать базу данных MariaDB и пользователя базы данных для Selfoss RSS Reader:

CREATE DATABASE selfoss_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'selfoss_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON selfoss_db.* TO 'selfoss_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Вы можете заменить имя базы данных selfoss_dbи имя пользователя selfoss_userна что-то более по своему вкусу, если хотите. Также убедитесь, что вы заменили «UltraSecurePassword» на действительно надежный пароль.

Шаг 7: Установите файлы Selfoss для чтения RSS

Измените ваш текущий рабочий каталог на веб-каталог по умолчанию:

cd /usr/local/www/apache24/data

Ваш текущий рабочий каталог теперь будет: /usr/local/www/apache24/data. Вы можете проверить это с помощью команды pwd(напечатать рабочий каталог):

pwd

Теперь используйте wgetдля загрузки установочного пакета Selfoss RSS Reader:

sudo wget --content-disposition https://github.com/SSilence/selfoss/archive/2.17.zip

Обратите внимание: Вы обязательно должны проверить самую последнюю версию, посетив страницу загрузки Selfoss RSS Reader .

Перечислите текущий каталог, чтобы убедиться, что вы успешно загрузили файл:

ls -la

Удалить index.html:

sudo rm index.html

Теперь распакуйте архив zip:

sudo unzip selfoss-2.17.zip

Переместите все установочные файлы в корневой веб-каталог:

sudo mv -v selfoss-2.17/* selfoss-2.17/.* /usr/local/www/apache24/data 2>/dev/null

Измените владельца веб-файлов, чтобы избежать проблем с разрешениями:

sudo chown -R www:www * ./

Перезапустите Apache снова:

sudo service apache24 restart

Шаг 8: Установите и запустите Composer

Selfoss RSS Reader требует от нас, чтобы composerзагрузить некоторые плагины, поэтому давайте установим composer. К сожалению, версия предварительно созданной двоичной версии composer в репозиториях пакетов FreeBSD не совместима с PHP 7.1. Поэтому вместо установки composerс помощью pkgкоманды мы скомпилируем ее из исходного кода.

Во-первых, давайте настроим систему FreeBSD 11 для компиляции программного обеспечения PHP с использованием PHP версии 7.1 вместо версии 5.6 по умолчанию.

Создайте новый файл в /etc/каталоге с именем make.conf:

sudo vi /etc/make.conf

Введите следующий текст в файл:

DEFAULT_VERSIONS+= php=7.1

Теперь сохраните и закройте файл.

Далее нам нужно скачать коллекцию портов FreeBSD с помощью portsnapкоманды:

sudo portsnap fetch extract update

После завершения portsnapкоманды перейдите в php-composerкаталог с исходным кодом:

cd /usr/ports/devel/php-composer/

Теперь запустите php-composerкомпиляцию и установку с помощью makeкоманды:

sudo make install clean BATCH=yes

Когда компиляция завершится, перейдите в каталог webroot:

cd /usr/local/www/apache24/data

Запустите composer, используя wwwпользователя:

sudo -u www composer install

Вы увидите несколько предупреждающих сообщений composerо невозможности записи в кэш, но не слишком переживайте по этому поводу, поскольку все будет работать нормально.

Теперь мы готовы перейти к последнему этапу.

Шаг 9: Завершите установку Selfoss RSS Reader

1. Сначала нам нужно обновить файл конф��гурации Selfoss RSS Reader, указав config.iniправильные настройки базы данных, поэтому убедитесь, что вы все еще находитесь в каталоге webroot, и скопируйте defaults.iniв config.ini:

   sudo cp -iv defaults.ini config.ini
   

2. Затем откройте config.iniфайл конфигурации и добавьте следующие значения базы данных:

   [globals]
   db_type=mysql
   db_host=localhost
   db_database=selfoss_db
   db_username=selfoss_user
   db_password=UltraSecurePassword
   db_port=3306
   

3. Теперь нам нужно добавить хеш пароля config.ini, но сначала нам нужно его сгенерировать, поэтому перейдите по следующему URL в вашем браузере:

   http://YOUR_VULTR_IP_ADDRESS/password
   

   Затем введите желаемый пароль в Passwordполе и нажмите Generate.

   Просто скопируйте полученное значение хеша в опцию пароля в config.iniфайле, чтобы секция паролей теперь выглядела примерно так:

   username=admin
   password=b729a37c34ff9648c33d67de3b289b58b7486dd71236343a6c2c275c2cc0477bd1d254eb92248bfa753169547d4bd2e81c2c9e460ba5bba822af1e87722dd12a
   salt=<long string of random chracters>
   

   Примечание. Ваш хэш пароля, очевидно, будет отличаться от хэша, показанного выше, и вы можете выбрать другое имя пользователя.

4. Удалите все остальные неотредактированные параметры из config.iniфайла, чтобы ваш файл конфигурации выглядел примерно так:

   [globals]
   db_type=mysql
   db_host=localhost
   db_database=db1
   db_username=u1
   db_password=usecpass1
   db_port=3306
   username=admin
   password=b729a37c34ff9648c33d67de3b289b58b7486dd71236343a6c2c275c2cc0477bd1d254eb92248bfa753169547d4bd2e81c2c9e460ba5bba822af1e87722dd12a
   salt=<long string of random chracters>
   

   Примечание. Если вы хотите изменить какой-либо из defaults.iniпараметров, вы можете просто добавить их в список параметров выше.

   Когда вы закончите редактирование файла конфигурации, вы можете сохранить и выйти из файла.

5. Теперь вы можете войти в Selfoss RSS Reader, посетив домашнюю страницу и введя свое имя пользователя и пароль:

    http://YOUR_VULTR_IP_ADDRESS/
   

6. Если вы хотите, чтобы читатель автоматически обновлял ваши фиды (а вы почти наверняка), вам нужно отредактировать ваш crontab:

   sudo crontab -e
   

   Добавьте следующую строку, чтобы обновлять свои каналы каждый час:

   0 * * * * www cd /usr/local/www/apache24/data && php cliupdate.php
   

Если вы еще не настроили свои настройки Vultr DNS, вы можете сделать это с помощью панели управления Vultr DNS.

Также желательно настроить ваш сайт для использования SSL, так как большинство современных браузеров будут предупреждать, когда на сайтах не включена поддержка SSL, а сертификаты SSL теперь доступны бесплатно.

В любом случае, теперь вы можете свободно добавлять свои каналы и настраивать читателя, если хотите.