Feedster 镜像文档

镜像概述与主要用途

Feedster 是一款轻量级Docker化RSS阅读器，旨在提供简洁高效的RSS/Atom订阅与阅读体验。通过容器化部署，可快速搭建个人RSS服务，实现信息源集中管理、本地数据持久化及跨设备Web访问，适合追求轻量化、私有化信息阅读的用户。

核心功能与特性

• 轻量级设计：资源占用低，运行高效，适合低配置设备或服务器部署
• 多格式支持：兼容主流RSS及Atom信息源格式
• 本地数据存储：通过数据卷挂载实现订阅列表、阅读记录及图片缓存的持久化存储
• Web界面访问：内置Web服务，通过浏览器即可便捷操作，无需安装客户端
• 容器化部署：配置简单，支持Docker Compose一键启动，易于维护

使用场景与适用范围

• 个人信息聚合：集中管理博客、新闻网站、技术论坛等多平台信息源
• 数据私有化需求：避免第三方服务依赖，订阅数据本地存储，保障信息安全
• 轻量化服务搭建：适用于个人服务器、NAS或开发环境，无需复杂配置
• 跨设备访问：通过Web界面在电脑、手机等多设备上同步阅读

使用方法与配置说明

前提条件

• 已安装Docker及Docker Compose
• 具备基本的Docker命令操作能力

Docker Compose部署（推荐）

1. 创建配置文件

新建docker-compose.yml文件，内容如下：

version: '3.4'
services:
    feedster:
        image: index.docker.io/nl2109/feedster:latest
        container_name: feedster
        restart: unless-stopped
        volumes:
          - /your/path:/app/data  # 订阅数据存储目录（需替换为实际路径）
          - /your/path:/app/images  # 图片缓存目录（需替换为实际路径）
        ports:
          - '30080:80'  # 主机端口:容器端口（容器内默认使用80端口）

2. 配置说明

• volumes（数据卷）：
  • /app/data：存储订阅源配置、阅读状态等核心数据，必须挂载以确保数据持久化，建议替换/your/path为本地实际目录（如./feedster_data:/app/data）
  • /app/images：缓存信息源中的图片资源，建议挂载本地目录避免容器重启后图片丢失
• ports（端口映射）：
  • 格式为主机端口:容器端口，默认容器内使用80端口，可通过修改主机端口（如8080:80）避免端口冲突
• restart策略：
  • unless-stopped：容器退出时自动重启（手动停止除外），确保服务持续可用

部署步骤

1. 准备数据目录

在本地创建用于挂载的数据目录（示例）：

mkdir -p /path/to/feedster/data /path/to/feedster/images

2. 编写Docker Compose配置

修改docker-compose.yml中的挂载路径为实际目录：

volumes:
  - /path/to/feedster/data:/app/data
  - /path/to/feedster/images:/app/images

3. 启动服务

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

docker-compose up -d

4. 访问服务

服务启动后，通过浏览器访问 http://<部署设备IP>:30080（替换<部署设备IP>为实际IP，端口为配置中的主机端口），即可进入Feedster界面添加订阅源并开始阅读。

停止与更新

• 停止服务：

  docker-compose down
  

• 更新镜像：

  docker-compose pull && docker-compose up -d
  

更多详细信息请参考项目GitHub：[***]