如何在FreeBSD 11 FAMP VPS上安装Reader Self 3.5 RSS Reader

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

Reader Self 3.5是一个简单，灵活，免费和开放源代码，自托管的RSS阅读器和Google Reader替代产品。Reader Self支持来自Google Reader的主要键盘快捷键，OPML导入，内置身份验证，HTTPS图像代理（以下载HTTP图像），将加星标项与Pinboard同步，能够在主要社交网络上共享，Elastic Search集成，并且功能精美跨台式机，平板电脑和移动设备响应。

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

先决条件

• 具有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

现在，我们需要Directory在同一配置文件中编辑Apache指令，以便可以mod_rewrite与Reader Self一起正常使用。

找到配置文件中以开头的部分，<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以及Reader Self所需的所有必需的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服务器上安装Reader Self，因此我们将使用正式版。首先，备份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：为读者自己创建数据库

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

sudo mysql -u root -p

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

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

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

如果愿意，您可以根据自己的喜好替换数据库名称self_db和用户名self_user。另外，请确保将“ UltraSecurePassword”替换为实际安全的密码。

步骤7：安装阅读器自身文件

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

cd /usr/local/www/apache24/data

您当前的工作目录将是： /usr/local/www/apache24/data。您可以使用pwd（打印工作目录）命令检查此内容：

pwd

现在用于wget下载Reader Self安装包：

sudo wget --content-disposition https://github.com/readerself/readerself/archive/3.5.6.zip

请注意： 您绝对应该通过访问Reader Self下载页面来检查最新版本。

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

ls -la

移除index.html：

sudo rm index.html

现在解压缩zip存档：

sudo unzip readerself-3.5.6.zip

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

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

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

sudo chown -R www:www * ./

再次重新启动Apache：

sudo service apache24 restart

现在我们准备进入最后一步。

步骤8：完成阅读器自我安装

现在是时候在浏览器中访问服务器实例的IP地址了，或者如果您已经配置了Vultr DNS设置（并且有足够的时间来传播），则可以直接访问您的域。

要访问Reader Self安装页面，请在浏览器地址栏中输入您的Vultr实例IP地址，然后输入/setup/：

http://YOUR_VULTR_IP_ADDRESS/setup/

1. 您会Pre-Installation Check在页面顶部看到，因此请确保一切正常，然后继续下一步。

2. Database在安装页面的部分中输入以下数据库值：

   Database Type:              MySQL (improved version)
   Hostname:                   localhost
   Username:                   self_user
   Password:                   UltraSecurePassword
   Database Name:              self_db
   

3. 输入以下User详细信息：

   Email:                  <your email address>
   Password:               <a secure password>
   

4. 检查完所有上述详细信息之后，只需单击页面左下方的对勾图标即可完成安装。

您将被重定向至显示的确认Installation successful。

要进一步配置Reader Self，请单击右上角的菜单，然后选择settings。

如果您希望读者自动更新供稿（几乎可以肯定），则需要编辑crontab：

sudo crontab -e

添加以下行以每小时刷新一次提要：

0 * * * * www cd /usr/local/www/apache24/data && php index.php refresh items

如果尚未配置Vultr DNS设置，则可以使用Vultr DNS控制面板进行配置。

建议您将网站配置为使用SSL，因为当网站未启用SSL并且SSL证书现在免费提供时，大多数现代浏览器都会发出警告。

无论如何，您现在都可以开始添加供稿，并进一步自定义阅读器的外观和功能。