身为 RSS 重度用户的我,被 Platy Hsu 同学的文章种草了 Tiny Tiny RSS 后,决定自己动手。不过 Platy 的文章是基于 Docker,因为一些原因我准备基于官方文档,使用「传统」的方式部署。

此外,如果你和 Platy 一样使用 Docker 进行部署,这里有一些改进:

  • 安装 PostgreSQL 镜像时,在 docker run 之后添加 --restart=always 参数来保证每次重启系统之后 container 能自动运行:
docker run -d --restart=always --name ttrssdb nornagon/postgres
docker run -it --name ttrss --restart=always \
--link ttrssdb:db  \
-e SELF_URL_PATH=http://example.org/ttrss  \
-e DB_USER=ttrss  \
-e DB_PASS=ttrss  \
-p 80:80  \
-d wangqiru/ttrss

这个映像中已经内置了mercury_fulltext 这个RSS 全文输出插件、Fever 模拟插件Feedly 主题,能够减少很多工作。

  • 改动了容器内的插件和主题文件后,记得 docker commit 一下保存变动。

因为官方文档中的安装说明十分简略,同时产品小众,网上的相关文章很少,已有的也年古失修,亟待更新。我希望这篇文章能涵盖到安装过程中大部分可能遇到的种种问题,同时能作为 VPS 新人的入门文章,也作为我将来维护时的笔记。

这篇文章将讲述如何安装 Tiny Tiny RSS,使用 PostgreSQL 作为数据库,Nginx 作为服务器,基于 Ubuntu 或者 Debian 系统。如果你还未配置好 VPS 或者不熟悉基本操作,Linode 社区的这篇教程很棒。过程中涉及到了很多文件操作和文本编辑工作,对于文件操作一个 SFTP 软件会很有帮助,免费的有 CyberduckFilezilla ,还有付费的 ForkLift 3 Transmit 5 可选择;文本编辑我会避免 Vim 而使用 nano。

准备

首先更新一下软件依赖,同时为服务器设置正确的时间

sudo apt-get update
sudo apt-get install ntp

PHP

Tiny Tiny RSS 是使用 PHP 构建的,使用 Tiny Tiny RSS 需先安装 PHP:

sudo apt-get install php php-fpm php-curl php-pgsql php-gd php-mcrypt php-cli

因为数据量比较小,将 TCP Socket 改为 Unix Socket:

sudo nano /etc/php/7.0/fpm/pool.d/www.conf

listen = 127.0.0.1:9000

改为

listen = /run/php/php7.0-fpm.sock

重启 PHP:

sudo /etc/init.d/php7.0-fpm restart

##Tiny Tiny RSS

Tiny Tiny RSS 的程序文件,可放到 /usr/share/nginx 这个共享目录下,也可以放到 /var/www/这个常用的放置网站的目录,这里选择后者。

cd /var/www/
git clone https://tt-rss.org/git/tt-rss.git ttrss

定位到 /var/www/,使用 Git 将整个 Tiny Tiny RSS 代码克隆到 ttrss 文件夹中,然后更改下权限:

cd /var/www/
sudo chown -R www-data:www-data ttrss

Nginx

建议先阅读 SkyCai 的这篇文章,讲解了 Nginx 的一些基本知识,能够帮助理解接下来所做的事情,当然,Nginx 的官方文档也是十分详尽的。

安装 Nginx:

sudo apt-get install nginx
sudo service nginx start

其中 service 命令启动了 nginx 这个位于 etc/init.d/ 下的 System V 初始化脚本,使 Nginx 能够自动运行。

这个时候通过浏览器访问你的 VPS 主机 IP 或域名,应该能看的 Nginx 的欢迎页面:

null

Nginx 网站配置文件:

使用 apt-get 安装的 Nginx 配置文件位于 /etc/nginx/中:

cd /etc/nginx/sites-available
sudo nano ttrss

写入配置文件:

# Tiny Tiny RSS Configuration

server {
    listen 80;
    server_name [替换为你的域名或 IP];

    root /var/www/ttrss;
    index index.php;

    error_log /var/log/nginx/ttrss.error.log;
    access_log /var/log/nginx/ttrss.access.log;

    location / {
        try_files $uri $uri/ /index.php;
    }

    location ~ \.php$ {
        include fastcgi.conf; # don't use fastcgi_params
        fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
        fastcgi_index index.php;
    }
}

这个配置文件的作用是:

  • listen: 收听 80 端口,即 http 的默认端口。
  • servername: 主机的 FQDN 正式域名
  • root: 站点文件的根目录所在位置
  • index: 网站的 index 文件。 对于 Tiny Tiny RSS 是 index.php,其他的情况可能是 index.html 等。
  • error_log: 错误日志的存放处。
  • access_log: 访问日志的存放处。
  • try_files: 其作用是按顺序检查文件是否存在,返回第一个找到的文件或文件夹(结尾加斜线表示为文件夹),如果所有的文件或文件夹都找不到,会进行一个内部重定向到最后一个参数。这里其实可有可无。
  • include fastcgi.conf: 原本 Nginx 只有「fastcgi_params」,后来发现很多人在定义「SCRIPT_FILENAME」时使用了硬编码的方式,于是为了规范用法便引入了「fastcgi.conf」。参考

/etc/nginx/sites-available 文件夹在你需要建立和管理多个站点的时候非常有用,可以帮助你更好的组织不同的项目。但是只有在 sites-enabled 目录下的配置文件才能够真正被用户访问,一般在会将sites-available下的相关文件链接到sites-enabled下:

cd /etc/nginx/sites-enabled
sudo rm default
sudo ln -s ../sites-available/ttrss ttrss

你也可以在其他地方保存 Nginx 网站配置文件,然后将其路径添加到 /etc/nginx/nginx.conf 的 http 下,如:

# Nginx Configuration

user nginx nginx;
worker_processes auto; # optimal value is number of cpu cores
…
http {
…
    include ttrss.conf;
…
}
…

重启 Nginx:

sudo service nginx restart

Postgres SQL

Tiny Tiny RSS 官方强烈建议使用 PostgreSQL 而不是 MySQL,尽管兼容后者。阮一峰的 PostgreSQL 入门教程很不错。

安装:

sudo apt-get install postgresql

安装完成后,会默认生成一个名为 postgres 的数据库和名为 postgres 的数据库用户和名为 postgres 的Linux系统用户。

sudo -u postgres psql

切换到 postgres 用户并使用 psql 登陆 Postgres SQL 控制台:

CREATE USER "www-data" WITH PASSWORD '你的密码';
CREATE DATABASE ttrss WITH OWNER "www-data";
\q

启动 Postgres SQL:

sudo service postgresql restart

Tiny Tiny RSS 配置

如果配置正确的话,这个时候访问你的服务器的域名或者 IP 就能看到 Tiny Tiny RSS 的安装页面,分别填入相应参数:

null

测试,一切无误的话就可以「Initialize database」初始化数据库了。

如果此处遇到了 Peer authentication failed for user "ttrss" 错误,你需要:

sudo nano/etc/postgresql/9.5/main/pg_hba.conf

将其中的:

# TYPE DATABASE USER ADDRESS METHOD
local  all      all          peer

改为

# TYPE DATABASE USER ADDRESS METHOD
local  all      all          md5

peer 的含义是只允许某个确认的 Unix 用户访问,无须密码。

md5 的含义是所有的知道密码的用户都可以访问。

如果不能直接保存配置,那么复制配置文件文本数据,然后修改 ttrss 配置:

sudo nano /var/www/ttrss/config.php

粘贴并保存。刷新网页,你应该会看到一个 Tiny Tiny RSS 的登陆界面,默认用户名 admin,密码 password

按照官方文档的指引,接下来需要配置 Tiny Tiny RSS 自动更新,这里使用文档中第二种方法,即 crontab 方式:这里需要注意的是更新脚本文件update.phpupdate_daemon2.php不能由root用户来执行,可以通过apache或者Nginx的运行用户来执行,如apache或者www-data等:

crontab -u www-data -e

添加如下内容:

*/30 * * * * www-data /usr/bin/php /var/www/ttrss/update.php --feeds --quiet

含义为:

  • 通过 crontab,可以在固定的时间间隔执行系统指令或者 Shell 脚本,-u 指定某个用户用户的 corntab 服务,-e:编辑某个用户的crontab文件内容。
  • crontab的文件格式:分 时 日 月 星期 要运行的命令

这样每隔 30 分钟会执行一次 update.php 更新脚本。

>

或者不使用 crontab,使用 screen, 效果一样:

screen -d -m php ./update_daemon2.php

基本使用

大部分可参考 Platy 的文章第三节之后的部分,这里有一些补充:

  • 架设好的 Tiny Tiny RSS 本质上是一个独立的系统,初次使用用户名 admin,密码 password登陆后,立即在【 操作】-【 prefernese】-【prefernese 】-【 Personal Data/ Authentication】更改掉 admin 的密码,随后在【Users】下新建用户,日后使用这个新建的用户进行订阅等操作。同时也可以建多个用户分享给朋友使用。
  • Plugins - Tiny Tiny RSS, Themes - Tiny Tiny RSSLatest Themes and Plugins topics 有一些插件和主题资源可作为补充。不同的是,因为不是使用的 Docker,相关插件和主题直接复制到 /var/www/themes//var/www/plugins/下即是。
  • 之前 mercury_fulltext 与 PHP7 兼容有点问题,作者在1月16日已经解决了这个问题。

目前我还同时持有 Inoreader Plus 的订阅,就我的需求来说,目前 Tiny Tiny RSS 能够胜任大部分 Inoreader 的工作,部分甚至做的更好,长期替代 Inoreader 的话会节省一笔可观的开支(Inoreader Plus 订阅费为 30 美元每年)。

但是 Tiny Tiny RSS 作为一个社区并不是很活跃开源项目,整个部署过程带给我我一种强烈的「摇摇欲坠」感,是选择更新积极、客服支持的商业项目,还是花时间、精力 maintain 自己服务器上的替代品,at your own risk。

Credit:

用 Tiny Tiny RSS 自建 RSS 服务 · Neverland

参考链接:

Tiny Tiny RSS–Google Reader的替代 - 为程序员服务

How To Install TTRSS with Nginx for Debian 7 on a VPS | DigitalOcean