身为 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
- 这里有一个更好(合适)的 Tiny Tiny RSS 映像,来自 mercury_fulltext 的作者:
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 软件会很有帮助,免费的有 Cyberduck、Filezilla ,还有付费的 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 的欢迎页面:
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 的安装页面,分别填入相应参数:
测试,一切无误的话就可以「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.php
或update_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 RSS 和 Latest 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