schklom/ttrss-app Docker 镜像 - 轩辕镜像

schklom/ttrss-app 镜像文档

镜像概述

本镜像基于TT-RSS官方仓库（[***]

镜像构建来源：[***]

核心功能与特性

• 每日同步官方仓库：基于最新提交自动同步构建，确保代码时效性
• 架构支持：特别测试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=[***]  # 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容器网络连通