如何在FreeBSD 11 FAMP VPS上安装Selfoss RSS阅读器

• 先决条件
• 步骤1：添加Sudo用户
• 步骤2：更新FreeBSD 11系统
• 步骤3：安装Apache Web服务器
• 步骤4：安装PHP 7.1
• 步骤5：安装MariaDB（MySQL）服务器
• 步骤6：为Selfoss RSS阅读器创建数据库
• 步骤7：安装Selfoss RSS阅读器文件
• 步骤8：安装并运行Composer
• 步骤9：完成Selfoss RSS阅读器安装

Selfoss RSS Reader是一个免费的开放源代码，自托管的基于Web的多功能，实时流，mashup，新闻提要（RSS / Atom）阅读器和通用聚合器。Selfoss RSS Reader具有OPML导入功能，宁静的JSON API，其开放式插件系统使您可以通过编写自己的自定义数据连接器轻松扩展默认功能。您可以使用Selfoss在一个中央位置实时流式传输和收集所有帖子，推文，播客和feed，您可以从任何台式机或移动设备轻松访问它们。

在本教程中，我们将使用Apache Web服务器，PHP 7.1和M​​ariaDB数据库在FreeBSD 11 FAMP VPS上安装Selfoss RSS Reader 2.17。

先决条件

• 具有SSH访问权限的干净Vultr FreeBSD 11服务器实例

步骤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命令切换到新的sudo用户user1帐户：

su - user1

命令提示符将更新以指示您现在已经登录到该user1帐户。您可以使用以下whoami命令进行验证：

whoami

现在重新启动sshd服务，以便您可以ssh使用刚刚创建的新的非root sudo用户帐户登录：

sudo /etc/rc.d/sshd restart

退出user1帐户：

exit

退出root帐户（这将断开您的ssh会话）：

exit

现在，您可以ssh使用新的非root用户sudo用户user1帐户从本地主机进入服务器实例：

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服务器实例上安装任何软件包之前，我们将首先更新系统。

确保您使用非root用户sudo登录到服务器，并运行以下命令：

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

步骤3：安装Apache Web服务器

安装Apache Web服务器：

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

您可以通过在浏览器中访问服务器实例的IP地址或域来快速检查apache是​​否正在运行：

http://YOUR_VULTR_IP_ADDRESS/

您将看到默认的FreeBSD Apache页面显示以下文本：

It works!

检查您的Apache默认配置文件，以确保该DocumentRoot指令指向正确的目录：

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

该DocumentRoot配置选项会是这样的：

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

现在，我们需要启用mod_rewriteApache模块。为此，我们可以在默认的Apache配置文件中搜索术语mod_rewrite。

默认情况下，mod_rewriteApache模块将被注释掉（这意味着它被禁用了）。干净的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以及Selfoss RSS Reader所需的所有必需的PHP模块：

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。由于我们将在公共Web服务器上安装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在Apache Includes目录中创建一个新文件：

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用户时，选择“是”（代表“是”），然后输入安全root密码。只需对其他所有是/否问题回答“是”，因为默认建议是最安全的选择。

步骤6：为Selfoss RSS阅读器创建数据库

root通过运行以下命令，以MariaDB 用户身份登录MariaDB shell ：

sudo mysql -u root -p

要访问MariaDB命令提示符，只需root在出现提示时输入MariaDB 密码即可。

运行以下查询为Selfoss RSS Reader创建MariaDB数据库和数据库用户：

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阅读器文件

将当前工作目录更改为默认Web目录：

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阅读器下载页面检查最新版本。

列出当前目录以检查是否已成功下载文件：

ls -la

移除index.html：

sudo rm index.html

现在解压缩zip存档：

sudo unzip selfoss-2.17.zip

将所有安装文件移至Web根目录：

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

更改Web文件的所有权，以避免任何权限问题：

sudo chown -R www:www * ./

再次重新启动Apache：

sudo service apache24 restart

步骤8：安装并运行Composer

Selfoss RSS Reader要求我们使用composer下载一些插件，因此让我们安装composer。不幸的是，FreeBSD软件包系统信息库中composer的预构建二进制版本与PHP 7.1不兼容。因此，composer与其使用pkg命令进行安装，不如从源代码进行编译。

首先，让我们将FreeBSD 11系统配置为使用PHP版本7.1（而不是默认版本5.6）来编译PHP软件。

在/etc/名为的目录中创建一个新文件make.conf：

sudo vi /etc/make.conf

在文件中输入以下文本：

DEFAULT_VERSIONS+= php=7.1

现在保存并关闭文件。

接下来，我们需要使用以下portsnap命令下载FreeBSD ports集合：

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

使用www用户运行作曲家：

sudo -u www composer install

您将看到一些composer关于无法写入缓存的警告消息，但不要太担心，因为一切仍然可以正常安装。

现在，我们可以继续进行最后一步了。

步骤9：完成Selfoss RSS阅读器安装

1. 我们首先需要config.ini使用正确的数据库设置更新Selfoss RSS Reader配置文件，因此请确保您仍在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文件中的password选项，那么password部分现在看起来像这样：

   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证书现在免费提供时，大多数现代浏览器都会发出警告。

无论如何，如果您愿意的话，现在您可以自由地开始添加提要并进一步自定义阅读器。