Miniflux
Miniflux •
Since 2017
Quick Actions
Official Docs
What is Miniflux?
Miniflux is a minimalist, self-hosted RSS feed reader written in Go. It focuses on simplicity and performance, providing a clean reading experience without unnecessary features. The bot fetches subscribed feeds on behalf of users running their own Miniflux instances. It respects robots.txt directives.
User Agent String
Miniflux/2.0 (+https://miniflux.app/)
How to Control Miniflux
Block Completely
To prevent Miniflux from accessing your entire website, add this to your robots.txt file:
# Block Miniflux
User-agent: Miniflux
Disallow: /
Block Specific Directories
To restrict access to certain parts of your site while allowing others:
User-agent: Miniflux
Disallow: /admin/
Disallow: /private/
Disallow: /wp-admin/
Allow: /public/
Set Crawl Delay
To slow down the crawl rate (note: not all bots respect this directive):
User-agent: Miniflux
Crawl-delay: 10
How to Verify Miniflux
Verification Method:
Check user agent string for Miniflux identifier
Check user agent string for Miniflux identifier
Learn more in the official documentation.
Detection Patterns
Multiple ways to detect Miniflux in your application:
Basic Pattern
/Miniflux/iStrict Pattern
/^Miniflux/2\.0 \(\+https\://miniflux\.app/\)$/Flexible Pattern
/Miniflux[\s\/]?[\d\.]*?/iVendor Match
/.*Miniflux.*Miniflux/iImplementation Examples
// PHP Detection for Miniflux
function detect_miniflux() {
$user_agent = $_SERVER['HTTP_USER_AGENT'] ?? '';
$pattern = '/Miniflux/i';
if (preg_match($pattern, $user_agent)) {
// Log the detection
error_log('Miniflux detected from IP: ' . $_SERVER['REMOTE_ADDR']);
// Set cache headers
header('Cache-Control: public, max-age=3600');
header('X-Robots-Tag: noarchive');
// Optional: Serve cached version
if (file_exists('cache/' . md5($_SERVER['REQUEST_URI']) . '.html')) {
readfile('cache/' . md5($_SERVER['REQUEST_URI']) . '.html');
exit;
}
return true;
}
return false;
}
# Python/Flask Detection for Miniflux
import re
from flask import request, make_responsedef detect_miniflux():
user_agent = request.headers.get('User-Agent', '')
pattern = r'Miniflux'
if re.search(pattern, user_agent, re.IGNORECASE):
# Create response with caching
response = make_response()
response.headers['Cache-Control'] = 'public, max-age=3600'
response.headers['X-Robots-Tag'] = 'noarchive'
return True
return False# Django Middleware
class MinifluxMiddleware:
def __init__(self, get_response):
self.get_response = get_response
def __call__(self, request):
if self.detect_bot(request):
# Handle bot traffic
pass
return self.get_response(request)
// JavaScript/Node.js Detection for Miniflux
const express = require('express');
const app = express();// Middleware to detect Miniflux
function detectMiniflux(req, res, next) {
const userAgent = req.headers['user-agent'] || '';
const pattern = /Miniflux/i;
if (pattern.test(userAgent)) {
// Log bot detection
console.log('Miniflux detected from IP:', req.ip);
// Set cache headers
res.set({
'Cache-Control': 'public, max-age=3600',
'X-Robots-Tag': 'noarchive'
});
// Mark request as bot
req.isBot = true;
req.botName = 'Miniflux';
}
next();
}app.use(detectMiniflux);
# Apache .htaccess rules for Miniflux# Block completely
RewriteEngine On
RewriteCond %{HTTP_USER_AGENT} Miniflux [NC]
RewriteRule .* - [F,L]# Or redirect to a static version
RewriteCond %{HTTP_USER_AGENT} Miniflux [NC]
RewriteCond %{REQUEST_URI} !^/static/
RewriteRule ^(.*)$ /static/$1 [L]# Or set environment variable for PHP
SetEnvIfNoCase User-Agent "Miniflux" is_bot=1# Add cache headers for this bot
<If "%{HTTP_USER_AGENT} =~ /Miniflux/i">
Header set Cache-Control "public, max-age=3600"
Header set X-Robots-Tag "noarchive"
</If>
# Nginx configuration for Miniflux# Map user agent to variable
map $http_user_agent $is_miniflux {
default 0;
~*Miniflux 1;
}server {
# Block the bot completely
if ($is_miniflux) {
return 403;
}
# Or serve cached content
location / {
if ($is_miniflux) {
root /var/www/cached;
try_files $uri $uri.html $uri/index.html @backend;
}
try_files $uri @backend;
}
# Add headers for bot requests
location @backend {
if ($is_miniflux) {
add_header Cache-Control "public, max-age=3600";
add_header X-Robots-Tag "noarchive";
}
proxy_pass http://backend;
}
}
Should You Block This Bot?
Recommendations based on your website type:
| Site Type | Recommendation | Reasoning |
|---|---|---|
| E-commerce | Optional | Evaluate based on bandwidth usage vs. benefits |
| Blog/News | Allow | Increases content reach and discoverability |
| SaaS Application | Block | No benefit for application interfaces; preserve resources |
| Documentation | Selective | Allow for public docs, block for internal docs |
| Corporate Site | Limit | Allow for public pages, block sensitive areas like intranets |
Advanced robots.txt Configurations
E-commerce Site Configuration
User-agent: Miniflux
Crawl-delay: 5
Disallow: /cart/
Disallow: /checkout/
Disallow: /my-account/
Disallow: /api/
Disallow: /*?sort=
Disallow: /*?filter=
Disallow: /*&page=
Allow: /products/
Allow: /categories/
Sitemap: https://example.com/sitemap.xml
Publishing/Blog Configuration
User-agent: Miniflux
Crawl-delay: 10
Disallow: /wp-admin/
Disallow: /drafts/
Disallow: /preview/
Disallow: /*?replytocom=
Allow: /
SaaS/Application Configuration
User-agent: Miniflux
Disallow: /app/
Disallow: /api/
Disallow: /dashboard/
Disallow: /settings/
Allow: /
Allow: /pricing/
Allow: /features/
Allow: /docs/
Quick Reference
User Agent Match
MinifluxRobots.txt Name
MinifluxCategory
otherRespects robots.txt
Yes
Copied to clipboard!