johngong/tt-rss

群晖NAS自用的TTRSS镜像，集成PostgreSQL数据库(14.1)、mercury-parser-api、opencc-api及多个常用插件，支持自动更新、中文搜索，方便快速部署个人RSS阅读器。

24 收藏0 次下载activejohngong镜像

TTRSS 群晖NAS自用Docker镜像

镜像概述

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

感谢项目

tt-rss
postgres
mercury-parser-api
OpenCC.henry.wang
ttrss_opencc
mercury_fulltext
ttrss_plugin-feediron
tinytinyrss-fever-plugin
ttrss-af-readability
freshapi
tt-rss-feedly-theme

版本信息

名称	版本	说明
ttrss	plugins-25.09-b369bf81	支持amd64、arm64v8、arm32v7架构，集成PostgreSQL-14.1、mercury-parser-api、opencc-api及常用插件

版本升级注意事项

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内容，支持简繁转换和中文搜索
希望一站式部署，减少多服务配置复杂度

数据库导入导出

群晖操作步骤

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

注意事项

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

导入导出命令

标题	命令	举例
导出	`pg_dump -U PostgreSQL用户名 -f /config/db.sql -d PostgreSQL数据库名称`	`pg_dump -U ttrss -f /config/db.sql -d ttrss`
导入	`psql -d PostgreSQL数据库名称 -f /config/db.sql -U PostgreSQL用户名`	`psql -d ttrss -f /config/db.sql -U ttrss`

Docker命令行部署

1. 下载镜像

镜像源	命令
DockerHub	`docker pull johngong/tt-rss:latest`
GitHub Container Registry	`docker pull ghcr.io/gshang2017/tt-rss:latest`

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. 卷配置

参数	说明
`本地文件夹1:/config`	tt-rss配置文件存储位置
`本地文件夹2:/var/lib/postgresql/data`	PostgreSQL数据存储位置

2. 端口配置

参数	说明
`本地端口1:80`	tt-rss Web访问端口（默认用户名：admin，密码：password）
`本地端口2:3000`	mercury-parser-api服务端口
`本地端口3:4000`	opencc-api服务端口（默认关闭）
`本地端口4:5432`	PostgreSQL数据库服务端口

3. 环境变量配置

参数	说明	默认值
`UID`	用户ID，不支持0	1000
`GID`	用户组ID，不支持0	1000
`POSTGRES_UID`	PostgreSQL用户ID，默认与UID一致	$UID
`POSTGRES_GID`	PostgreSQL用户组ID，默认与GID一致	$GID
`POSTGRES_DB`	PostgreSQL数据库名称	ttrss
`POSTGRES_USER`	PostgreSQL用户名	ttrss
`POSTGRES_PASSWORD`	PostgreSQL密码	ttrss
`TTRSS_DB_NAME`	ttrss使用的数据库名称（同POSTGRES_DB）	ttrss
`TTRSS_DB_USER`	ttrss数据库用户名（同POSTGRES_USER）	ttrss
`TTRSS_DB_PASS`	ttrss数据库密码（同POSTGRES_PASSWORD）	ttrss
`TTRSS_DB_TYPE`	数据库类型	pgsql
`TTRSS_DB_PORT`	数据库端口	5432
`TTRSS_DB_HOST`	数据库IP地址	0.0.0.0
`TTRSS_SELF_URL_PATH`	ttrss访问地址，需改为实际IP/域名+Web端口	http://localhost:80/
`TTRSS_PLUGINS`	默认启用插件列表	auth_internal,fever,mercury_fulltext,af_readability
`TZ`	系统时区	Asia/Shanghai
`TTRSS_ALLOW_PORTS`	允许订阅的端口，多个用逗号分隔	80,443
`TTRSS_UPDATE_AUTO`	是否自动更新tt-rss（true/false）	true
`TTRSS_CADDY_PORT`	Caddy服务端口	80
`ENABLE_MERCURY`	是否启用mercury-parser-api（true/false）	true
`MERCURY_PORT`	mercury-parser-api监听端口	3000
`ENABLE_OPENCC`	是否启用opencc-api（true/false）	false
`OPENCC_PORT`	opencc-api监听端口	4000
`PGPORT`	PostgreSQL监听端口	5432
`PHP_LISTEN_PORT`	PHP监听端口	9000
`POSTGRES_DB_DUMP`	是否备份数据库（true/false），仅启动时执行，不可与还原同时使用	false
`POSTGRES_DB_RESTORE`	是否还原数据库（true/false），仅启动时执行，不可与备份同时使用	false

插件设置

mercury_fulltext插件

登录ttrss，进入偏好设置→插件，启用mercury_fulltext
在供稿栏的Mercury Fulltext settings中填入[***]（如[***]）

opencc插件

环境变量设置ENABLE_OPENCC=true并重启容器
登录ttrss，进入偏好设置→插件，启用opencc
在供稿栏的opencc settings中填入[***]（如[***]）

中文搜索设置

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

标题	命令	举例
添加zhparser扩展	`psql -U PostgreSQL用户名 -d PostgreSQL数据库名称 -a -f /docker-entrypoint-initdb.d/install_extension.sql`	`psql -U ttrss -d ttrss -a -f /docker-entrypoint-initdb.d/install_extension.sql`
更新旧数据库（可选）	`psql -U PostgreSQL用户名 -d PostgreSQL数据库名称 -c "update ttrss_entries set tsvector_combined = to_tsvector( 'chinese_simplified' , content)"`	`psql -U ttrss -d ttrss -c "update ttrss_entries set tsvector_combined = to_tsvector( 'chinese_simplified' , content)"`

常见问题

HTTPS反代问题

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