RSSPub：RSS聚合器及EPUB生成器

发表于 2025-12-15 分类于各种折腾 Waline：阅读次数：本文字数： 2.4k 阅读时长 ≈ 2 分钟

RSSPub 可以将你最喜欢的 RSS/Atom 订阅源转为 EPUB 文件。

简介

什么是 RSSPub ？

RSSPub 是一个自托管的 Rust 应用程序，旨在将用户的 RSS/Atom 订阅源转换为个人化的每日新闻报（EPUB 格式）。该工具自动抓取文章、处理图片，并将所有内容打包成可供 e-reader 或平板电脑阅读的 EPUB 文件。此外，RSSPub 还提供了一个 OPDS 订阅源，使用户能够直接下载生成的 EPUB 文件到兼容的阅读器中，如 KOReader 和 Moon+ Reader。

主要特点

RSS/Atom 解析：自动抓取和解析用户配置的 RSS/Atom 订阅源内容。
EPUB 生成：将抓取的文章编译成格式良好的 EPUB 电子书。
图片优化：下载并处理图片，以提高在 e-reader 上的显示效果（如灰度、调整大小）。
网页界面：提供一个简单的网页 UI，以管理订阅源、设置生成时间表，并手动触发生成。
OPDS 目录：内置 OPDS 服务器（/opds），用户可以浏览并下载生成的 EPUB 文件。
调度功能：根据用户配置的 cron 表达式自动生成 EPUB 文件。
身份验证：可选的基本身份验证，以保护应用实例。
电子邮件送达：可自动将生成的 EPUB 文件发送到配置的电子邮件地址，如 Send-to-Kindle。
高性能：基于 Rust、Axum 和 Tokio 构建，具有高性能和低资源消耗的特点。

应用场景

个人信息管理：用户可以将自己喜欢的新闻源转换为每日电子报，方便随时阅读。
自托管解决方案：适合希望控制个人数据并使用自托管应用的用户。
阅读优化：通过优化的 EPUB 文件和图片处理，提升阅读体验。
自动化工作流：对于需要定期读取新闻的用户，自动生成电子书并通过电子邮件发送，省去手动操作。
简易管理：通过简单的网页界面，轻松管理和定制 RSS 订阅源。

总之，RSSPub 提供了一个灵活且高效的方式，让用户能够轻松获取、整理和阅读自己感兴趣的内容。

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 rsspub ，选择第一个 harshit181/rsspub，版本选择 latest。

本文写作时， latest 版本对应为 0.96.2；

卷

在 docker 文件夹中，创建一个新文件夹 rsspub，并在其中建一个子文件夹 data

文件夹	装载路径	说明
`docker/rsspub/data`	`/app/db`	存放数据库文件
`docker/rsspub/epubs`	`/app/static/epubs`	存放生成的 `epub` 文件

端口

本地端口不冲突就行，不确定的话可以用命令查一下

1 2	# 查看端口占用 netstat -tunlp \| grep 端口号

本地端口	容器端口
`3364`	`3000`

环境

可变	值
`RUST_LOG`	日志级别设置（如 `info` 或 `error`）
`EPUBS_HOST_DIR`	存储生成 `EPUB` 文件的目录
`RPUB_USERNAME`	用于基本身份验证的用户名
`RPUB_PASSWORD`	用于基本身份验证的密码

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 rsspub 和 子目录
mkdir -p /volume1/docker/rsspub/{data,epubs}

# 进入 rsspub 目录
cd /volume1/docker/rsspub

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name rsspub \
   -p 3364:3000 \
   -v $(pwd)/data:/app/db \
   -v $(pwd)/epubs:/app/static/epubs \
   -e RPUB_USERNAME=laosu \
   -e RPUB_PASSWORD=123456 \
   harshit181/rsspub:latest

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

services:
  rsspub:
    image: harshit181/rsspub:latest
    container_name: rsspub
    restart: unless-stopped
    ports:
      - "3364:3000"
    volumes:
      - ./data:/app/db
      - ./epubs:/app/static/epubs
    environment:
      - RUST_LOG=info,html5ever=error
      - RPUB_USERNAME=laosu
      - RPUB_PASSWORD=123456

然后通过 SSH 登录到您的群晖，执行下面的命令：

# 新建文件夹 rsspub 和 子目录
mkdir -p /volume1/docker/rsspub/{data,epubs}

# 进入 rsspub 目录
cd /volume1/docker/rsspub

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d