schklom/ttrss-app

schklom/ttrss-app 镜像文档

镜像概述

本镜像基于TT-RSS官方仓库（https://git.tt-rss.org/fox/tt-rss.git%EF%BC%89%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%AF%8F%E6%97%A5%E5%90%8C%E6%AD%A5%E6%9C%80%E6%96%B0%E6%8F%90%E4%BA%A4%EF%BC%88%E8%8B%A5%E4%BB%93%E5%BA%93%E6%9C%89%E6%9B%B4%E6%96%B0%EF%BC%89%E3%80%82%E6%8F%90%E4%BE%9B%E6%99%AE%E9%80%9A%E7%89%88%E6%9C%AC%E5%92%8C%E6%94%AF%E6%8C%81%E6%96%87%E4%BB%B6%E6%97%A5%E5%BF%97%E7%9A%84%E7%89%88%E6%9C%AC%EF%BC%8C%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8E%E9%83%A8%E7%BD%B2%E5%BC%80%E6%BA%90RSS%E9%98%85%E8%AF%BB%E5%99%A8TT-RSS%E3%80%82**%E4%BB%85%E6%B5%8B%E8%AF%95%E8%BF%87ARM64%E6%9E%B6%E6%9E%84**%E3%80%82

镜像构建来源：https://github.com/schklom/Mirror-workflows%EF%BC%88TTRSS-docker%E5%92%8CTTRSS-docker-with-filelogging%E5%88%86%E6%94%AF%EF%BC%89%E3%80%82

核心功能与特性

• 每日同步官方仓库：基于最新提交自动同步构建，确保代码时效性
• 架构支持：特别测试ARM64架构，多平台支持
• 双版本选择：
  • 普通版：错误日志输出到容器/dev/stderr（默认）
  • 文件日志版（with-filelogging-latest标签）：支持将错误日志记录到文件
• 日志管理优化：文件日志版便于集成fail2ban等工具，简化日志监控与安全管理

使用场景

• 部署TT-RSS开源RSS阅读器的个人或企业用户
• ARM64架构设备（如树莓派等单板计算机）上的TT-RSS部署
• 需要将应用错误日志持久化存储并进行集中管理的场景
• 需通过日志监控工具（如fail2ban）增强系统安全性的场景

使用方法

普通版本（无文件日志）

无需特殊配置，错误日志直接输出到容器/dev/stderr，可通过docker logs <容器名>查看。

文件日志版本（with-filelogging-latest标签）

该版本需配合环境变量和日志文件挂载使用，将错误日志记录到/var/log/error.log。

1. 准备日志文件

手动创建日志文件并设置权限（尤其在Rootless Docker环境或日志路径为/var/log等系统目录时）：

bash
# 创建日志文件（替换实际路径）
touch /path/to/error.log

# 设置权限（替换1000:1000为环境变量中配置的OWNER_UID:OWNER_GID）
chown 1000:1000 /path/to/error.log

2. 配置环境变量

必须将TTRSS_LOG_DESTINATION设置为空字符串：

• Docker run命令：-e TTRSS_LOG_DESTINATION=
• Docker Compose：TTRSS_LOG_DESTINATION: ""

3. Docker Compose示例

yaml
services:
  ttrss:
    image: schklom/ttrss-app:with-filelogging-latest
    volumes:
      # 挂载日志文件（替换实际路径）
      - /path/to/error.log:/var/log/error.log
      # 挂载TT-RSS数据目录（替换实际路径）
      - /path/to/ttrss/files:/var/www/html
    environment:
      - TZ=Europe/Berlin  # 时区设置
      - TTRSS_DB_TYPE=pgsql  # 数据库类型
      - TTRSS_DB_HOST=ttrss_db  # 数据库容器名
      - TTRSS_DB_NAME=abcd  # 数据库名
      - TTRSS_DB_USER=abcd  # 数据库用户
      - TTRSS_DB_PASS=abcd  # 数据库密码（建议修改为强密码）
      - OWNER_UID=1000  # 文件所有者UID（默认1000，可选）
      - OWNER_GID=1000  # 文件所有者GID（默认1000，可选）
      - TTRSS_LOG_DESTINATION: ""  # 启用文件日志的关键配置（必须为空）
      - TTRSS_SELF_URL_PATH=http://192.168.0.1:8080/tt-rss/  # TT-RSS访问URL（替换为实际地址）

  ttrss_db:
    image: postgres:13-alpine
    environment:
      - TZ=Europe/Berlin
      - POSTGRES_DB=abcd
      - POSTGRES_USER=abcd
      - POSTGRES_PASSWORD=abcd

  ttrss_web_nginx:
    image: schklom/ttrss-web-nginx
    ports:  # 可选，建议使用反向代理替代直接暴露端口
      - 8080:80
    environment:
      - APP_UPSTREAM=ttrss  # 主TT-RSS容器名，默认"app"
    volumes:
      - /path/to/ttrss/files:/var/www/html:ro  # 只读挂载应用文件

4. 验证配置

启动容器后，通过以下命令确认环境变量已正确设置：

bash
docker exec <ttrss容器名> env | grep TTRSS_LOG_DESTINATION

此时docker logs <ttrss容器名>将不再显示错误日志，日志内容已写入挂载的/path/to/error.log文件。

注意事项

• 架构兼容性：仅在ARM64架构上测试通过，其他架构可能存在兼容性问题
• 日志权限：确保日志文件所有者UID/GID与环境变量OWNER_UID:OWNER_GID一致，避免权限错误
• 反向代理建议：生产环境建议使用反向代理（如Nginx、Traefik）替代直接暴露端口
• 数据库配置：示例中使用PostgreSQL，需确保数据库容器与TT-RSS容器网络连通