阅读器 · 2026 年 11 月 11 日 · 5 分钟
自建 Miniflux:一台小机器上的订阅中枢
一个二进制文件、一个数据库、一条反代规则。半小时能跑起来,之后每年维护两小时。
Miniflux 是一个用 Go 写的订阅服务:单个二进制、依赖少、内存占用低,1 核 1G 的机器就能跑得很稳。这篇只讲最小可用部署,不追求功能全开。
准备
- 一台有公网 IP 的 Linux 服务器,已装 Docker 与 Docker Compose。
- 一个域名(例如 feed.example.com),解析到这台机器。
- 一个反向代理(Caddy 或 Nginx),负责 HTTPS。
启动
services:
miniflux:
image: miniflux/miniflux:latest
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
- DATABASE_URL=postgres://miniflux:换成强密码@db/miniflux?sslmode=disable
- RUN_MIGRATIONS=1
- CREATE_ADMIN=1
- ADMIN_USERNAME=admin
- ADMIN_PASSWORD=换成更长的密码
- BASE_URL=https://feed.example.com/
ports:
- "127.0.0.1:8080:8080"
db:
image: postgres:16-alpine
restart: unless-stopped
environment:
- POSTGRES_USER=miniflux
- POSTGRES_PASSWORD=换成强密码
- POSTGRES_DB=miniflux
volumes:
- ./data:/var/lib/postgresql/data
healthcheck:
test: ["CMD", "pg_isready", "-U", "miniflux"]
interval: 10s
retries: 5
把两处「换成强密码」改掉,且两处必须一致。然后 docker compose up -d,访问 127.0.0.1:8080 应该能看到登录页。
加一层 HTTPS
用 Caddy 最省事,两行配置:
feed.example.com {
reverse_proxy 127.0.0.1:8080
}
Caddy 会自动申请证书。如果用 Nginx,记得把 proxy_set_header Host $host; 和 X-Forwarded-Proto 带上,否则生成的回调地址会是 http。
安全底线
- 端口只绑 127.0.0.1,不要直接把 8080 暴露到公网。
- 管理员密码至少十六位,别用 admin/admin。
- 开启登录失败限制,公网服务一定会被扫。
- 每周备份 Postgres 数据目录,异地存一份。
迁移与日常
在旧阅读器导出 OPML,登录 Miniflux 后「设置—导入」上传即可。移动端可以接 Reeder、Read You 等支持 Fever/Google Reader API 的客户端。更新用 docker compose pull && docker compose up -d,建议先看 release notes,偶尔有数据库迁移。
它不适合谁
不适合完全不想碰命令行的人,也不适合需要复杂规则过滤的人——Miniflux 的过滤能力比 Inoreader 弱不少。它的定位很清楚:稳定、快、少打扰。如果你要的就是这些,它很难被替代。