workingmachine/ttrss

Tiny Tiny RSS PHP+Apache镜像文档

1. 镜像概述

本镜像专为Tiny Tiny RSS（TT-RSS）阅读器应用设计，基于PHP和Apache Web服务器构建，集成了更新守护进程功能。旨在提供一站式部署方案，满足TT-RSS对Web服务环境的依赖及内容自动更新需求。

2. 核心功能与特性

2.1 基础环境支持

• PHP运行环境：内置符合TT-RSS需求的PHP解释器及扩展，确保阅读器功能正常运行
• Apache Web服务器：提供稳定的HTTP服务能力，支持TT-RSS的Web界面访问

2.2 核心功能

• 更新守护进程：集成自动更新机制，可周期性处理TT-RSS的订阅内容同步与更新，无需手动触发
• 轻量化设计：在满足功能需求的前提下优化镜像体积，提升部署效率

3. 使用场景

• 个人或小型团队部署Tiny Tiny RSS阅读器实例
• 需要Web服务与内容自动更新能力结合的TT-RSS部署场景
• 简化TT-RSS环境配置流程，减少手动搭建PHP+Apache环境及更新机制的操作成本

4. 使用方法与配置说明

4.1 基本部署命令

通过docker run快速启动镜像：

bash
docker run -d \
  --name tt-rss-web \
  -p 80:80 \
  -v /path/to/tt-rss/data:/var/www/html \
  [镜像名称]:[标签]

参数说明：

• -p 80:80：将容器80端口映射到主机80端口，用于Web访问
• -v /path/to/tt-rss/data:/var/www/html：挂载主机目录至容器内Web根目录，实现数据持久化

4.2 环境变量配置（可选）

根据实际部署需求，可通过-e参数传递环境变量调整配置：

示例（自定义更新间隔）：

bash
docker run -d \
  --name tt-rss-web \
  -p 80:80 \
  -v /path/to/tt-rss/data:/var/www/html \
  -e UPDATE_INTERVAL=60 \
  [镜像名称]:[标签]

4.3 启动后验证

1. 访问http://[主机IP]，确认TT-RSS Web界面正常加载
2. 检查更新守护进程状态：

   bash
   docker exec tt-rss-web ps aux | grep update_daemon
   

   若输出包含update_daemon进程，表明守护进程已正常启动

4.4 配合Docker Compose部署（推荐）

创建docker-compose.yml文件简化部署：

yaml
version: '3'
services:
  tt-rss-web:
    image: docker.xuanyuan.run/[镜像名称]:[标签]
    container_name: tt-rss-web
    ports:
      - "80:80"
    volumes:
      - ./tt-rss-data:/var/www/html
    environment:
      - PHP_MEMORY_LIMIT=256M
      - UPDATE_INTERVAL=45
    restart: unless-stopped

启动命令：

bash
docker-compose up -d

5. 注意事项

• 确保挂载的数据目录具有正确权限（容器内Apache用户可读写）
• 根据TT-RSS版本需求选择匹配的镜像标签
• 生产环境建议配合反向代理（如Nginx）及HTTPS配置使用