lunik1/tt-rss

弃用通知

此仓库已弃用，开发继续在 [***]

容器镜像现在托管于 registry.gitlab.com/lunik1/docker-tt-rss。

镜像概述

这是已弃用的 linuxserver.io tt-rss 容器的分支。构建时使用 tt-rss 的最新 master 分支，当 tt-rss master 分支有提交或基础容器更新时会触发重建。

在 Docker Hub 上查找镜像：https://hub.docker.com/r/lunik1/tt-rss

不被 linuxserver.io 团队支持或认可。

核心功能与特性

• 基于 tt-rss 最新 master 分支构建，确保使用最新功能
• 自动重建机制：当 tt-rss master 分支有新提交或基础容器更新时触发
• 内置 nginx 服务，简化 Web 部署
• 支持通过环境变量配置应用，优先级高于传统的 config.php
• 支持 Docker secrets：可通过 FILE__ 前缀从文件读取环境变量

使用场景与适用范围

适用于需要部署 Tiny Tiny RSS（开源 RSS 阅读器）的个人用户或小型团队。需自行准备 MySQL/MariaDB 或 PostgreSQL 数据库服务，用于存储 RSS 订阅数据和用户信息。

使用方法

docker

bash
docker create \
  --name=tt-rss \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -p 80:80 \
  -v <path to data>:/config \
  --restart unless-stopped \
  lunik1/tt-rss

docker-compose

兼容 docker-compose v2 架构。

yaml
---
version: "2"
services:
  tt-rss:
    image: lunik1/tt-rss
    container_name: tt-rss
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
    volumes:
      - <path to data>:/config
    ports:
      - 80:80
    restart: unless-stopped

参数说明

从文件设置环境变量（Docker secrets）

可通过特殊前缀 FILE__ 从文件读取环境变量值。例如：

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

上述命令会将 /run/secrets/mysecretpassword 文件的内容作为 PASSWORD 环境变量的值。

应用设置

1. 数据库准备：需在 MySQL/MariaDB 或 PostgreSQL 服务器中为 tt-rss 创建专用用户和数据库。
2. Nginx 配置：基础 Nginx 配置文件位于 /config/nginx/site-confs，可编辑该文件启用 SSL（默认端口 443）、设置服务器名等。
3. SSL 密钥：首次运行容器时会自动生成自签名密钥，存储于 /config/keys，可替换为自定义密钥。
4. 初始登录：初始配置后的默认用户名和密码为 admin/password。

应用配置

容器优先通过环境变量进行配置，而非传统的 config.php。常用配置变量包括：

• -e TTRSS_DB_TYPE=mysql：数据库类型（mysql 或 pgsql）
• -e TTRSS_DB_HOST=host：数据库主机地址
• -e TTRSS_DB_USER=user：数据库用户名
• -e TTRSS_DB_NAME=name：数据库名称
• -e TTRSS_DB_PASS=password：数据库密码
• -e TTRSS_DB_PORT=3306：数据库端口
• -e TTRSS_SELF_URL_PATH=http://localhost/：应用访问 URL

完整支持的环境变量及其默认值列表参见 tt-rss 配置文件。

注意：需确保数据库服务已提前初始化并可访问。