johngong/tt-rss Docker 镜像 - 轩辕镜像
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. 创建容器
bashdocker 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';
推荐客户端软件
| 平台 | 推荐软件 |
|---|---|
| Android | feedme、ttrss |
| Linux | NewsFlash、fluent-reader |
| macOS | fluent-reader |
| Windows | fluent-reader |
参考链接
- 项目GitHub：[***]
- TTRSS官方网站：[***]
johngong/baidunetdisk
by johngong
需要提醒的是，百度网盘官方并未推出过“VNC版”客户端，此类非官方版本可能存在安全风险，如信息泄露、恶意程序植入等，且使用非官方软件可能违反相关服务协议。建议您通过百度网盘官方渠道下载和使用正版客户端，以保障账号和数据安全。
2261M+ pulls
上次更新：3 个月前
johngong/calibre-web
by johngong
calibre-web:0.6.25是一款功能实用的电子书管理工具，它不仅支持对个人电子书库进行便捷的分类、整理与阅读管理，还集成了ebook-convert转换功能，能够实现EPUB、MOBI、PDF等多种主流电子书格式之间的快速相互转换，帮助用户轻松适配不同阅读设备的格式需求，有效提升电子书资源的管理与利用效率。
180500K+ pulls
上次更新：4 个月前
johngong/anki-sync-server
by johngong
Anki同步服务器镜像（版本25.09.2），支持amd64和arm64v8架构，提供Anki内置同步服务，用于搭建私人Anki同步服务器，实现卡片数据同步。
1650K+ pulls
上次更新：3 个月前
johngong/syncthing-relay-discosrv
by johngong
包含relaysrv:2.0.10和discosrv:2.0.10组件，为syncthing同步工具提供中继连接与节点发现服务的服务器镜像。
1010K+ pulls
上次更新：1 个月前
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
登录仓库拉取
通过 Docker 登录认证访问私有仓库
Linux
在 Linux 系统配置镜像服务
Windows/Mac
在 Docker Desktop 配置镜像
Docker Compose
Docker Compose 项目配置
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
宝塔面板
在宝塔面板一键配置镜像
群晖
Synology 群晖 NAS 配置
飞牛
飞牛 fnOS 系统配置镜像
极空间
极空间 NAS 系统配置服务
爱快路由
爱快 iKuai 路由系统配置
绿联
绿联 NAS 系统配置镜像
威联通
QNAP 威联通 NAS 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
专属域名拉取
无需登录使用专属域名
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
轩辕镜像免费版与专业版有什么区别？
免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。
轩辕镜像支持哪些镜像仓库？
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。
流量耗尽错误提示
当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。
410 错误问题
通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。
manifest unknown 错误
先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。
镜像拉取成功后，如何去掉轩辕镜像域名前缀？
使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"