x86dev/docker-ttrss

#已弃用 - 请使用Github上的最新镜像：[***]

docker-ttrss镜像概述

本镜像用于部署开源RSS/Atom阅读器Tiny Tiny RSS（TT-RSS），让用户自主托管feed历史，可通过桌面、移动浏览器或第三方应用访问。镜像基于Alpine和s6进程管理工具，轻量高效且集成多种实用功能。

核心功能与特性

• 专用Postgres数据库数据卷存储
• 新增集成Feedly-ish主题并在启动时自动重新应用（解决主题损坏问题）
• 基于Alpine和s6进程管理，镜像大小<100MB
• 使用PHP7，支持每日自动更新TT-RSS及插件
• 兼容jwilder/nginx-proxy，支持Let’s Encrypt SSL证书
• 集成Feedly主题、FeedIron插件（修改feed内容）、Mobilize插件（Readability等服务）
• 可选自签名4096位RSA TLS证书
• 支持Postgres和MySQL数据库

使用场景

• 个人RSS阅读器：自主管理feed数据，避免依赖第三方服务
• 多设备访问：通过浏览器或应用随时随地查看RSS内容
• 安全需求：需SSL加密或反向代理集成的场景

详细使用方法

注意事项

所有命令需以root用户执行！

快速启动

1. 创建数据库卷：

bash
docker volume create ttrss-db

2. 启动Postgres数据库实例：

bash
DB=$(docker run -d --restart=always --name ttrss-db -v ttrss-db:/var/lib/postgresql/data -e POSTGRES_PASSWORD=password postgres:alpine)

3. 启动TT-RSS容器：

bash
docker run -d --link $DB:db -e TTRSS_PORT=8080 --name ttrss x86dev/docker-ttrss

访问TT-RSS

• 默认地址：http://localhost:8080
• 默认凭据：用户名admin，密码password（建议立即修改）

启用SSL/TLS（自签名证书）

添加环境变量和端口映射：

bash
docker run -d --link ttrss-db:db -e TTRSS_WITH_SELFSIGNED_CERT=1 -p443:4443 --name ttrss x86dev/docker-ttrss

访问地址：https://<你的主机地址>

反向代理支持

结合jwilder/nginx-proxy可将TT-RSS集成到现有域名（如https://ttrss.yourdomain.tld），配合Let’s Encrypt证书可获得高安全评级。

安装步骤详解

启动数据库实例

镜像不含数据库，需单独启动Postgres/MySQL。示例（Postgres）：

bash
docker volume create ttrss-db
docker run -d --restart=always --name=ttrss-db -v ttrss-db:/var/lib/postgresql/data -e POSTGRES_PASSWORD=<密码> postgres:alpine

前台测试运行

首次启动建议前台运行以查看错误：

bash
docker run -it -e TTRSS_PORT=8080 --link ttrss-db:db --name ttrss x86dev/docker-ttrss

数据库配置

可通过环境变量修改默认配置：

• DB_NAME: 数据库名（默认ttrss）
• DB_USER: 用户名（默认ttrss）
• DB_PASS: 密码（默认ttrss）
• DB_TYPE: 数据库类型（默认postgres，可选mysql）

后台运行

确认前台正常后，改用-d参数后台启动：

bash
docker run -d --link ttrss-db:db --name ttrss x86dev/docker-ttrss

实用信息

单用户模式

若通过带基础认证的代理访问，设置TTRSS_SINGLEUSER=true可跳过TT-RSS自身认证。

备份与迁移

1. 停止旧服务器TT-RSS容器
2. 备份ttrss-db卷并复制到新服务器
3. 在新服务器重复创建数据库和TT-RSS容器（使用旧卷数据）

自动更新

镜像每日自动检查更新，可修改root/etc/services.d/ttrss-updater/run中的--wait-exit 24h调整间隔（h=小时，m=分钟，s=秒）。

贡献

欢迎通过https://github.com/x86dev/docker-ttrss%E6%8F%90%E4%BA%A4PR%EF%BC%8C%E8%B4%A1%E7%8C%AE%E5%8A%9F%E8%83%BD%E6%88%96%E4%BF%AE%E5%A4%8Dbug%E3%80%82