Ban Monitoring
The Bans page provides comprehensive visibility into all ban activity.
Live Feed
The default view shows a real-time stream of bans:
- New bans appear at the top instantly
- Auto-scrolls when at the top of the list
- Pauses auto-scroll when you scroll down
Ban Entry Details
Each ban shows:
- IP Address - With country flag
- Jail - Which jail triggered the ban
- Server - Where the ban occurred
- Time - When the ban happened
- Log Excerpt - Snippet of the log that triggered the ban (if available)
Search and Filter
Quick Filters
| Filter | Description |
|---|---|
| Server | Filter by specific server |
| Jail | Filter by jail name |
| Country | Filter by country code |
| Time Range | Last hour, 24h, 7 days, 30 days, custom |
Advanced Search
Search for specific IPs or patterns:
192.168.1.100 # Exact IP
192.168.1. # IP prefix
sshd # Jail name
CN # Country code
IP Details
Click on any IP address to view details:
WHOIS Information
- Organization - Who owns the IP
- Country - Registration country
- Network - CIDR block
- Abuse Contact - Where to report abuse
Ban History
- All bans for this IP across all servers
- Timeline view
- Total ban count
AbuseIPDB Score
If AbuseIPDB integration is enabled:
- Confidence score (0-100)
- Total reports
- Last reported date
- Report categories
Actions
| Action | Description |
|---|---|
| Unban | Unban this IP on specific server |
| Unban All | Unban on all servers |
| Whitelist | Add to global whitelist |
| Report | Report to AbuseIPDB |
Statistics
Overview Stats
- Total bans (selected period)
- Unique IPs banned
- Top attacking countries
- Most targeted jails
Charts
- Bans Over Time - Line chart of ban frequency
- By Country - Pie chart of top countries
- By Jail - Bar chart of jails with most bans
- Geographic Map - World map with heat intensity
Export
Export ban data for analysis:
- Apply desired filters
- Click Export button
- Choose format:
- CSV
- JSON
- Download file
Unban Operations
Single Unban
- Find the ban entry
- Click Unban button
- Confirm on the modal
- Wait for command completion
Bulk Unban
- Select multiple bans (checkboxes)
- Click Unban Selected
- Choose servers (or all)
- Confirm
Unban by IP
- Click Unban IP button
- Enter IP address
- Select servers
- Select jails (or all)
- Execute
Notifications
Configure ban notifications in Settings:
Discord
- Real-time ban alerts
- Configurable minimum severity
- Country flag and WHOIS info
Email
- Daily summary reports
- Alert on specific IPs or jails
Ban Deduplication
Bloqd prevents duplicate ban entries:
- Same IP + jail within 15 minutes = single entry
- Counter incremented instead of new record
- Reduces noise in dashboard
Retention
Ban history is retained based on settings:
- Default: 90 days
- Configurable in Settings
- Automatic cleanup via scheduled job