Miniflux 极简 RSS 阅读器部署教程

Miniflux 是一款使用 Go 语言编写的极简 RSS 阅读器。它只有一个二进制文件，运行时内存占用极低，界面简洁干净，专注于阅读体验。如果你喜欢简约风格，不需要花哨的功能，Miniflux 是 RSS 阅读器的最佳选择。本文将介绍如何在搬瓦工 VPS 上部署 Miniflux。

一、Miniflux 的设计理念

极简主义：界面只保留最核心的阅读功能，没有多余的装饰。
高性能：Go 语言编译的单个二进制文件，启动快、内存占用低（约 30MB）。
安全优先：自动清理 HTML 内容，防止 XSS 攻击。自动使用 HTTPS 获取 Feed。
隐私保护：不追踪用户行为，不加载外部资源（如 Favicon 代理获取）。
键盘友好：完整的键盘快捷键支持，不用鼠标即可完成所有操作。
API 完善：内置 Fever 和 Google Reader 兼容 API。
集成丰富：支持发送文章到 Wallabag、Pocket、Telegram 等服务。

二、环境准备

搬瓦工 VPS 一台，256MB 内存即可运行（使用优惠码 NODESEEK2026 享受 6.77% 折扣）。
已安装 Docker 和 Docker Compose（参考 Docker 安装教程）。

三、Docker Compose 部署

mkdir -p /opt/miniflux
cat > /opt/miniflux/docker-compose.yml <<'EOF'
version: '3.8'

services:
  miniflux:
    image: miniflux/miniflux:latest
    restart: always
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "8080:8080"
    environment:
      DATABASE_URL: postgres://miniflux:miniflux_password@db/miniflux?sslmode=disable
      RUN_MIGRATIONS: 1
      CREATE_ADMIN: 1
      ADMIN_USERNAME: admin
      ADMIN_PASSWORD: your_admin_password
      POLLING_FREQUENCY: 30
      BATCH_SIZE: 20
      CLEANUP_ARCHIVE_UNREAD_DAYS: 90
      CLEANUP_ARCHIVE_READ_DAYS: 30

  db:
    image: postgres:15-alpine
    restart: always
    environment:
      POSTGRES_USER: miniflux
      POSTGRES_PASSWORD: miniflux_password
      POSTGRES_DB: miniflux
    volumes:
      - pg_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "miniflux"]
      interval: 10s
      start_period: 30s

volumes:
  pg_data:
EOF

四、启动服务

cd /opt/miniflux
docker compose up -d

查看日志确认启动成功：

docker compose logs -f miniflux

访问 http://VPS_IP:8080，使用配置的管理员账号登录。

五、配置反向代理

cat > /etc/nginx/sites-available/miniflux <<'EOF'
server {
    listen 80;
    server_name rss.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
EOF

ln -sf /etc/nginx/sites-available/miniflux /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d rss.yourdomain.com

六、基础配置说明

Miniflux 通过环境变量进行配置，以下是重要参数说明：

POLLING_FREQUENCY：RSS 源刷新频率（分钟），默认 60。
BATCH_SIZE：每次刷新时同时检查的 Feed 数量。
CLEANUP_ARCHIVE_UNREAD_DAYS：未读文章保留天数。
CLEANUP_ARCHIVE_READ_DAYS：已读文章保留天数。
PROXY_IMAGES：设为 all 可以通过 Miniflux 代理所有图片请求，保护隐私。

七、客户端配置

7.1 启用 Fever API

在 Miniflux Web 界面的「设置」>「集成」中启用 Fever API，并设置 Fever 密码。这样可以在支持 Fever 协议的客户端中使用 Miniflux。

7.2 推荐客户端

Android：ReadYou、FeedMe
iOS：Reeder、NetNewsWire
桌面：Fluent Reader

八、集成 Wallabag

可以将文章一键发送到 Wallabag 稍后阅读：

在 Miniflux 设置中找到「集成」>「Wallabag」。
填入 Wallabag 的 API 地址和凭据。
保存后，在文章页面就可以一键保存到 Wallabag。

九、数据备份

docker compose exec db pg_dump -U miniflux miniflux > /opt/miniflux/backup_$(date +%Y%m%d).sql

十、Miniflux vs FreshRSS 对比

Miniflux：极简设计，资源消耗极低，适合追求简洁和性能的用户。
FreshRSS：功能更丰富，支持更多扩展和自定义，适合需要高级功能的用户。参考 FreshRSS 搭建教程。

总结

Miniflux 是追求简洁高效的 RSS 阅读器首选，Go 语言编写确保了极低的资源消耗和出色的性能。部署在搬瓦工 VPS 上只需要很少的资源。选购搬瓦工 VPS 请访问 bwh81.net，使用优惠码 NODESEEK2026 享受 6.77% 折扣。