Miniflux 群晖 Container Manager 部署文档

适用环境：群晖 DSM，使用 Container Manager（Docker）部署，无外网IP依赖，局域网访问。 Miniflux 是开源RSS阅读器，本身不自带资讯内容，需要添加RSS源抓取文章。

1. 前置准备

  1. 在群晖 File Station 创建存放数据目录
    • 创建目录：/volumeX/docker/miniflux
    • 子目录自动生成：data（Postgres数据库存放位置）

      替换volumeX为实际硬盘卷号。

  2. 记录自定义信息（后续配置使用）
    • 数据库用户名：miniflux
    • 数据库密码：自定义高强度密码
    • 数据库名称：miniflux
    • 管理员账号：自定义登录用户名
    • 管理员密码：自定义网页登录密码

2. docker-compose.yml

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

services:
  postgres:
    image: postgres:16-alpine
    container_name: miniflux_db
    restart: unless-stopped
    environment:
      POSTGRES_USER: miniflux
      POSTGRES_PASSWORD: 【替换为自定义数据库密码】
      POSTGRES_DB: miniflux
    volumes:
      - ./data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U miniflux -d miniflux"]
      interval: 10s
      timeout: 5s
      retries: 5

  miniflux:
    image: miniflux/miniflux:latest
    container_name: miniflux
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
    ports:
      - "8080:8080"
    environment:
      DATABASE_URL: postgres://miniflux:【替换为自定义数据库密码】@postgres:5432/miniflux?sslmode=disable
      ADMIN_USERNAME: 【替换管理员登录账号】
      ADMIN_PASSWORD: 【替换管理员登录密码】
      RUN_MIGRATIONS: "1"
    networks:
      - miniflux_net

networks:
  miniflux_net:

3. 部署操作步骤

  1. 打开群晖 Container Manager → 项目 → 创建项目
  2. 项目名称填写 miniflux
  3. 来源选择「上传 compose 文件」，选中上面保存的 docker-compose.yml
  4. 点击下一步，确认配置，勾选「自动启动」
  5. 完成创建，等待容器拉取镜像并启动。

    启动顺序说明：postgres数据库先启动，数据库就绪后自动启动miniflux，自动执行数据库迁移。

4. 访问与初始化

  1. 局域网访问地址：http://NAS内网IP:8080
  2. 使用compose内填写的 ADMIN_USERNAME 和 ADMIN_PASSWORD 登录网页端。

添加RSS订阅源

  1. 左侧菜单 → Feeds → Add feed
  2. 填入RSS源地址，点击提交
    • 部分网站直接粘贴网站主页，Miniflux可自动探测RSS地址
    • 无原生RSS输出的网站，需要搭配RSSHub生成RSS地址
  3. 源添加完成后，Miniflux会按设定周期自动抓取文章更新。

OPML批量导入订阅

  1. Feeds → Import
  2. 上传OPML文件，一次性批量导入全部订阅源。

5. 常用环境变量说明

变量 说明
DATABASE_URL Postgres数据库连接字符串，保持容器内postgres主机名不变，仅修改账号密码
ADMIN_USERNAME 网页管理员账号，部署前定义
ADMIN_PASSWORD 网页管理员密码，部署前定义
RUN_MIGRATIONS 1=自动执行数据库迁移，首次部署必须开启

6. 备份与维护

数据库备份

Miniflux所有订阅、文章数据全部存放在postgres容器挂载的data目录。

  1. 定期备份 /volumeX/docker/miniflux/data 目录
  2. 迁移新NAS时，直接复制整个data目录，搭配相同compose配置即可恢复全部订阅和阅读记录。

版本升级

Container Manager项目页面，重新拉取镜像，重启项目即可自动升级，数据库迁移会自动执行。

7. 常见问题排查

  1. 无法登录网页
    • 检查容器状态：miniflux 和 miniflux_db 两个容器都必须正常运行
    • 查看miniflux容器日志，确认数据库连接是否正常
  2. RSS源抓取失败/超时
    • 部分国内站点网络访问受限，可尝试更换RSS源，或使用RSSHub中转
    • 检查NAS网络是否可以访问目标网站
  3. 忘记管理员密码 修改docker-compose.yml内ADMIN_PASSWORD，保存后重建项目，自动重置管理员密码，不会丢失订阅数据。
  4. 容器反复重启
    • 优先检查数据库密码是否前后一致（DATABASE_URL内密码必须和POSTGRES_PASSWORD完全相同）
    • 检查挂载目录权限

8. 补充说明

Miniflux本身不生成资讯，仅作为RSS聚合阅读器； 想要订阅没有原生RSS的网站，需要额外部署RSSHub服务，将网页转为RSS feed地址填入Miniflux。