johngong/tt-rss

TTRSS 群晖NAS自用Docker镜像

镜像概述

本镜像为群晖NAS用户提供Tiny Tiny RSS(TTRSS)的一站式部署方案，集成PostgreSQL数据库、mercury-parser-api、opencc-api及多种实用插件，简化RSS阅读器的搭建流程，支持中文内容处理、全文搜索等功能。

感谢项目

• tt-rss
• https://github.com/docker-library/postgres
• https://github.com/HenryQW/mercury-parser-api
• https://github.com/HenryQW/OpenCC.henry.wang
• https://github.com/HenryQW/ttrss_opencc
• https://github.com/HenryQW/mercury_fulltext
• https://github.com/feediron/ttrss_plugin-feediron
• https://github.com/DigitalDJ/tinytinyrss-fever-plugin
• ttrss-af-readability
• https://github.com/eric-pierce/freshapi
• https://github.com/levito/tt-rss-feedly-theme

版本信息

版本升级注意事项

• 22.01版本：升级PostgreSQL至14.1，新增自动更新tt-rss及数据库导入导出脚本
• 21.02版本起：不再支持旧配置文件，需使用环境变量重新设置，更新前请备份数据并清空tt-rss配置文件夹
• 20.09版本起：不再支持非80及443端口订阅
• plugins-19.8版本：需重新导入导出数据库（旧数据库不兼容），移除themes.local文件夹（feedly旧主题不兼容）

核心功能与特性

• 集成PostgreSQL 14.1数据库，无需额外部署
• 内置mercury-parser-api服务，支持文章全文提取
• 可选opencc-api服务，提供中文简繁转换
• 预装多种实用插件：fever、mercury_fulltext、af_readability、feediron等
• 支持自动更新tt-rss核心程序
• 内置zhparser扩展，支持简体中文全文搜索
• 兼容多架构（amd64、arm64v8、arm32v7），适配不同群晖设备

使用场景

• 群晖NAS用户搭建个人RSS阅读器
• 需要处理中文RSS内容，支持简繁转换和中文搜索
• 希望一站式部署，减少多服务配置复杂度

数据库导入导出

群晖操作步骤

1. 导出数据库：在旧版ttrss容器终端执行导出命令，导出文件db.sql将保存至/config目录
2. 准备新数据库目录：清空或重命名原PostgreSQL数据目录（如postgre→postgre.bak），新建同名目录
3. 创建新版容器：配置与旧版一致，需暂时修改环境变量TTRSS_DB_PORT=5432防止初始化冲突
4. 导入数据库：待PostgreSQL初始化完成（新目录生成内容）后，在容器终端执行导入命令
5. 恢复配置并重启：改回TTRSS_DB_PORT=5432，重启容器，登录ttrss按提示更新数据库

注意事项

• db.sql为数据库导出/导入文件，不同PostgreSQL版本不兼容
• 导入数据库后全新安装时，ttrss配置界面需选择Skip initialization

导入导出命令

Docker命令行部署

1. 下载镜像

2. 创建容器

bash
docker create  \
   --name=ttrss  \
   -p 80:80 \
   -p 5432:5432 \
   -p 3000:3000 \
   -p 4000:4000 \
   -v /本地配置文件位置:/config  \
   -v /本地PostgreSQL数据位置:/var/lib/postgresql/data  \
   -e UID=1000  \
   -e GID=1000  \
   -e POSTGRES_DB=ttrss   \
   -e POSTGRES_USER=ttrss   \
   -e POSTGRES_PASSWORD=ttrss   \
   -e TTRSS_DB_NAME=ttrss   \
   -e TTRSS_DB_USER=ttrss   \
   -e TTRSS_DB_PASS=ttrss   \
   -e TTRSS_SELF_URL_PATH=http://localhost:80/   \
   --restart unless-stopped  \
   johngong/tt-rss:latest

3. 容器管理命令

• 启动容器：docker start ttrss
• 停止容器：docker stop ttrss
• 删除容器：docker rm ttrss
• 删除镜像：docker image rm johngong/tt-rss:latest

群晖Docker设置

1. 卷配置

2. 端口配置

3. 环境变量配置

插件设置

mercury_fulltext插件

1. 登录ttrss，进入偏好设置→插件，启用mercury_fulltext
2. 在供稿栏的Mercury Fulltext settings中填入http://IP:本地端口2（如http://192.168.1.100:3000）

opencc插件

1. 环境变量设置ENABLE_OPENCC=true并重启容器
2. 登录ttrss，进入偏好设置→插件，启用opencc
3. 在供稿栏的opencc settings中填入http://IP:本地端口3（如http://192.168.1.100:4000）

中文搜索设置

1. 进入ttrss偏好设置→信息源→默认语言，选择Chinese_simplified
2. （旧数据升级需手动添加zhparser扩展）执行以下命令：

常见问题

HTTPS反代问题

问题：提示Please set SELF_URL_PATH to the correct value detected for your server: http://domain.com (you're using: https://domain.com)
解决方法：在/config目录下的config.php中添加$_SERVER['HTTP_X_FORWARDED_PROTO'] = 'https';

推荐客户端软件

参考链接

• 项目GitHub：https://github.com/gshang2017/docker
• TTRSS官方网站：[***]