Tiny Tiny RSS 部署流程 2019.10.22更新

admin


本文最后更新于 2020年08月13日

前言

本教程主要来自https://ttrss.henry.wang/zh/#通过-docker-部署

我添加了一些解释和注释,以及修改了部分内容

简介

Tiny Tiny RSS 是一款基于 PHP 的免费开源 RSS 聚合阅读器。? Awesome TTRSS 旨在提供一个 「一站式容器化」 的 Tiny Tiny RSS 解决方案,通过提供简易的部署方式以及一些额外插件,以提升用户体验。

通过 docker-compose 部署


docker-compose.yml
 包含了 4 个镜像:

  1. TTRSS

  2. PostgreSQL

  3. Mercury Parser API

  4. OpenCC API

步骤

  1. 下载 docker-compose.yml 至任意目录。

  2. 更改 docker-compose.yml 中的设置,请务必更改 postgres 用户密码。

  3. 通过终端在同目录下运行 docker-compose up -d 后等待部署完成。

  4. 默认通过 181 端口访问 TTRSS,默认账户:admin 密码:password,请第一时间更改。

  5. wangqiru/mercury-parser-api 及 wangqiru/opencc-api-server 为支持高级功能而加入的可选服务类容器,删除不会影响 TTRSS 基础功能

编辑docker-compose.yml 按如图位置修改

支持的环境变量列表

  • SELF_URL_PATH: TTRSS 实例地址

  • DB_HOST: 数据库地址

  • DB_PORT: 数据库端口

  • DB_NAME: 数据库名字

  • DB_USER: 数据库用户名

  • DB_PASS: 数据库密码

  • ENABLE_PLUGINS: 在系统层面启用的插件名称,其中 auth_internal 为必须启用的登录插件

  • SESSION_COOKIE_LIFETIME: 使用网页版登陆时 cookie 过期时间,单位为小时,默认为 24 小时

配置 HTTPS

示例代码
Code example
1
2
3
4
5
6
7
8
9
10
11
server {
    listen 80;
    server_name 你的域名;      
    location / {
                proxy_pass http://ttrss的IP;
                proxy_redirect off;
                proxy_set_header        Host    $host;
                proxy_set_header        X-Real-IP       $remote_addr;
                proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
        }
}

插件

#Mercury 全文获取

全文内容提取插件,配合单独的 Mercury Parser API 服务器使用。样例 docker-compose 中已经包含了 HenryQW/mercury-parser-api 服务器。

#设置步骤

  1. 在设置中启用 mercury-fulltext 插件 

  • 在设置中填入 Mercury 容器名字,默认即可

#Fever API

提供 Fever API 支持。

该插件默认作为系统插件启用。

#设置步骤

  1. 在设置中启用 API。 

  2. 在插件设置中设置 Fever 密码。 

  3. 在支持 Fever 的阅读器用,使用 https://[你的地址]/plugins/fever 作为服务器地址。使用你的账号和步骤 2 中的密码登录。

  4. 由于该插件使用未加盐的 MD5 加密密码进行通信,强烈建议开启 HTTPS

#OpenCC 繁简转换

使用 OpenCC 为 TTRSS 提供中文繁转简的插件,需要配合单独的 OpenCC API 服务器使用。样例 docker-compose 中已经包含了 HenryQW/OpenCC.henry.wang 服务器。

#设置步骤

  1. 在设置中启用 opencc 插件 

  2. 在设置中填入 OpenCC API 地址 

Demo 服务器,可用性不做任何保证:https://opencc.henry.wang or http://opencc2.henry.wang

#FeedReader API

提供 FeedReader API 支持。

系统插件,将 api_feedreader 添加到 ENABLE_PLUGINS 环境变量中以启用。

使用指南见 FeedReader API

#News+ API

为 Android App News+ 和 iOS App Fiery Feeds 提供更快的同步速度。

系统插件,将 api_newsplus 添加到 ENABLE_PLUGINS 环境变量中以启用。

使用指南见 News+ API

#Feediron

提供文章 DOM 操控能力的插件。

使用指南见 Feediron

#主题

#Feedly

#RSSHub

#使用建议

总结

感谢HenryQW/Awesome-TTRSS项目,让我们可以用最简单的方式配置好ttrss

tttrss有一个缺点,就是不支持一个源同时存在多个文件夹,这就非常难受了,fever API在reeder中不支持添加修改删除源能忍,这个问题就难以接受了,虽然他可以高度定制,完全可控,拉取速度快,但是我还是换成了inoreader



1.330763s