supahgreg/tt-rss

Tiny Tiny RSS (TT-RSS) Docker镜像文档

镜像概述与主要用途

Tiny Tiny RSS (简称TT-RSS) 是一款开源自托管的RSS/Atom订阅内容聚合器。作为Docker镜像，它提供了便捷的部署方式，使用户能够快速搭建个人或团队专属的RSS阅读系统，替代第三方RSS服务，实现数据本地化存储与完全自主管理。其核心价值在于赋予用户对订阅数据的绝对控制权，避免依赖外部服务导致的内容审查或访问限制。

核心功能与特性

• 自托管架构：数据存储于用户自有服务器，无需依赖第三方平台，保障数据主权。
• 多协议支持：兼容RSS 0.9x/1.0/2.0及Atom 0.3/1.0标准订阅源。
• 数据持久化：订阅内容本地存储，支持历史内容检索与归档。
• 跨设备同步：通过Web界面实现多终端（PC、移动设备）内容同步与阅读进度保存。
• 自定义扩展：支持主题切换、插件安装（如阅读模式优化、内容过滤）及API集成。
• 内容管理：提供订阅源分类、标签管理、未读/星标标记等组织工具。
• 隐私保护：无第三方数据收集，支持HTTPS加密访问，保护用户订阅偏好与阅读记录。

使用场景与适用范围

• 个人用户：管理大量博客、新闻、技术文档等订阅源，集中阅读与检索内容。
• 隐私敏感用户：替代依赖第三方的RSS服务（如Feedly），避免数据泄露风险。
• 定制化需求场景：需通过插件或API扩展功能（如内容自动转发、AI摘要生成）的用户。
• 小型团队/家庭：共享订阅源，协同阅读行业资讯或内部公告。

使用方法与配置说明

前置依赖

• Docker Engine (20.10+)/Docker Desktop
• Docker Compose (推荐，用于管理应用与数据库容器)
• 可访问的数据库服务（PostgreSQL 12+/MySQL 8.0+，推荐通过容器部署）

Docker部署示例

1. Docker Compose配置（推荐）

创建docker-compose.yml文件，集成TT-RSS应用与PostgreSQL数据库：

yaml
version: '3.8'

services:
  tt-rss:
    image: tt-rss/tt-rss:latest
    container_name: tt-rss-app
    restart: unless-stopped
    depends_on:
      - tt-rss-db
    environment:
      - TTRSS_DB_HOST=tt-rss-db
      - TTRSS_DB_USER=tt_rss_user
      - TTRSS_DB_NAME=tt_rss_db
      - TTRSS_DB_PASS=secure_password_here  # 替换为强密码
      - TTRSS_SELF_URL_PATH=http://your-domain.com/tt-rss  # 替换为实际访问URL
      - TTRSS_SESSION_COOKIE_LIFETIME=86400  # 会话有效期（秒）
      - TTRSS_ENABLE_PLUGINS=auth_internal,note  # 启用插件（默认包含基础认证）
    volumes:
      - tt-rss-data:/var/www/html
    ports:
      - "8080:80"  # 映射端口（根据需求调整主机端口）

  tt-rss-db:
    image: postgres:14-alpine
    container_name: tt-rss-db
    restart: unless-stopped
    environment:
      - POSTGRES_USER=tt_rss_user
      - POSTGRES_PASSWORD=secure_password_here  # 与TTRSS_DB_PASS保持一致
      - POSTGRES_DB=tt_rss_db
    volumes:
      - tt-rss-db-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U tt_rss_user -d tt_rss_db"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  tt-rss-data:  # 存储应用配置、插件、缓存
  tt-rss-db-data:  # 存储数据库数据

2. 启动服务

在docker-compose.yml所在目录执行：

bash
docker-compose up -d

3. 初始化与访问

• 首次启动后，访问http://<主机IP>:8080（或配置的TTRSS_SELF_URL_PATH）
• 使用默认管理员账户登录：
  • 用户名：admin
  • 密码：password（首次登录需强制修改）
• 按引导完成数据库初始化与管理员密码重置。

主要配置参数（环境变量）

数据持久化与备份

• 应用数据（配置、插件、缓存）：存储于tt-rss-data卷，可通过docker volume inspect tt-rss-data查看主机路径。
• 数据库数据：存储于tt-rss-db-data卷，建议定期通过pg_dump备份数据库：

bash
# 备份数据库（需替换容器名与密码）
docker exec tt-rss-db pg_dump -U tt_rss_user tt_rss_db > tt-rss_backup_$(date +%Y%m%d).sql

注意事项

• 安全配置：生产环境需启用HTTPS（可通过Nginx反向代理配置SSL证书），并使用强密码与非默认端口。
• 性能优化：订阅源数量较多时，建议调整数据库资源（如增加内存）并启用缓存插件。
• 更新维护：通过docker-compose pull && docker-compose up -d更新镜像，更新前建议备份数据。
• 官方文档：更多功能与插件配置详见TT-RSS官方Wiki。

volumes: tt-rss-data: tt-rss-db-data: