From a417c26d7fe827a81aaea736c0a61b3cfa18d489 Mon Sep 17 00:00:00 2001
From: Ming Di Leom <2809763-curben@users.noreply.gitlab.com>
Date: Sun, 23 Jul 2023 08:39:59 +0000
Subject: [PATCH] docs: move download links into a table
inspired by https://github.com/badmojr/1Hosts
---
README.md | 152 ++++++------------------------------------------------
1 file changed, 17 insertions(+), 135 deletions(-)
diff --git a/README.md b/README.md
index 2217134..feeea63 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
- [IP-based (AdGuard)](#ip-based-adguard)
- [IP-based (Vivaldi)](#ip-based-vivaldi)
- [dnscrypt-proxy](#dnscrypt-proxy)
- - [Snort2](#)
+ - [Snort2](#snort2)
- [Snort3](#snort3)
- [Suricata](#suricata)
- [Splunk](#splunk)
@@ -20,18 +20,15 @@ A blocklist of botnet IPs, based on the **Botnet C2 IOCs** of Abuse.ch [Feodo Tr
This blocklist is only useful as a last line of defence _after_ being infected. To avoid infection in the first place, consider using [urlhaus-filter](https://gitlab.com/malware-filter/urlhaus-filter).
-There are multiple formats available, refer to the appropriate section according to the program used:
-
-- uBlock Origin (uBO) -> [IP-based](#ip-based) section (recommended)
-- Pi-hole -> [Domain-based](#domain-based) or [Hosts-based](#hosts-based) section
-- AdGuard Home -> [Domain-based (AdGuard Home)](#domain-based-adguard-home)
-- AdGuard browser extension -> [IP-based (AdGuard)](#ip-based-adguard)
-- Vivaldi -> [IP-based (Vivaldi)](#ip-based-vivaldi)
-- [dnscrypt-proxy](#dnscrypt-proxy)
-- [Snort2](#snort2)
-- [Snort3](#snort3)
-- [Suricata](#suricata)
-- [Splunk](#splunk)
+| Client | mirror 1 | mirror 2 | mirror 3 | mirror 4 | mirror 5 | mirror 6 |
+| ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| uBlock Origin, [IP-based](#ip-based) | [link](https://malware-filter.gitlab.io/malware-filter/botnet-filter.txt) | [link](https://curbengh.github.io/malware-filter/botnet-filter.txt) | [link](https://curbengh.github.io/botnet-filter/botnet-filter.txt) | [link](https://malware-filter.gitlab.io/botnet-filter/botnet-filter.txt) | [link](https://malware-filter.pages.dev/botnet-filter.txt) | [link](https://botnet-filter.pages.dev/botnet-filter.txt) |
+| [AdGuard Home](#domain-based-adguard-home) | [link](https://malware-filter.gitlab.io/malware-filter/botnet-filter-agh.txt) | [link](https://curbengh.github.io/malware-filter/botnet-filter-agh.txt) | [link](https://curbengh.github.io/botnet-filter/botnet-filter-agh.txt) | [link](https://malware-filter.gitlab.io/botnet-filter/botnet-filter-agh.txt) | [link](https://malware-filter.pages.dev/botnet-filter-agh.txt) | [link](https://botnet-filter.pages.dev/botnet-filter-agh.txt) |
+| [AdGuard (browser extension)](#ip-based-adguard) | [link](https://malware-filter.gitlab.io/malware-filter/botnet-filter-ag.txt) | [link](https://curbengh.github.io/malware-filter/botnet-filter-ag.txt) | [link](https://curbengh.github.io/botnet-filter/botnet-filter-ag.txt) | [link](https://malware-filter.gitlab.io/botnet-filter/botnet-filter-ag.txt) | [link](https://malware-filter.pages.dev/botnet-filter-ag.txt) | [link](https://botnet-filter.pages.dev/botnet-filter-ag.txt) |
+| [Vivaldi](#ip-based-vivaldi) | [link](https://malware-filter.gitlab.io/malware-filter/botnet-filter-vivaldi.txt) | [link](https://curbengh.github.io/malware-filter/botnet-filter-vivaldi.txt) | [link](https://curbengh.github.io/botnet-filter/botnet-filter-vivaldi.txt) | [link](https://malware-filter.gitlab.io/botnet-filter/botnet-filter-vivaldi.txt) | [link](https://malware-filter.pages.dev/botnet-filter-vivaldi.txt) | [link](https://botnet-filter.pages.dev/botnet-filter-vivaldi.txt) |
+| [dnscrypt-proxy](#dnscrypt-proxy) | [link](https://malware-filter.gitlab.io/malware-filter/botnet-filter-dnscrypt-blocked-ips.txt) | [link](https://curbengh.github.io/malware-filter/botnet-filter-dnscrypt-blocked-ips.txt) | [link](https://curbengh.github.io/botnet-filter/botnet-filter-dnscrypt-blocked-ips.txt) | [link](https://malware-filter.gitlab.io/botnet-filter/botnet-filter-dnscrypt-blocked-ips.txt) | [link](https://malware-filter.pages.dev/botnet-filter-dnscrypt-blocked-ips.txt) | [link](https://botnet-filter.pages.dev/botnet-filter-dnscrypt-blocked-ips.txt) |
+| [Snort2](#snort2), [Snort3](#snort3), [Suricata](#suricata) | [link](https://malware-filter.gitlab.io/malware-filter/botnet-filter-suricata.rules) | [link](https://curbengh.github.io/malware-filter/botnet-filter-suricata.rules) | [link](https://curbengh.github.io/botnet-filter/botnet-filter-suricata.rules) | [link](https://malware-filter.gitlab.io/botnet-filter/botnet-filter-suricata.rules) | [link](https://malware-filter.pages.dev/botnet-filter-suricata.rules) | [link](https://botnet-filter.pages.dev/botnet-filter-suricata.rules) |
+| [Splunk](#splunk) | [link](https://malware-filter.gitlab.io/malware-filter/botnet-filter-splunk.csv) | [link](https://curbengh.github.io/malware-filter/botnet-filter-splunk.csv) | [link](https://curbengh.github.io/botnet-filter/botnet-filter-splunk.csv) | [link](https://malware-filter.gitlab.io/botnet-filter/botnet-filter-splunk.csv) | [link](https://malware-filter.pages.dev/botnet-filter-splunk.csv) | [link](https://botnet-filter.pages.dev/botnet-filter-splunk.csv) |
For other programs, see [Compatibility](https://gitlab.com/malware-filter/malware-filter/wikis/compatibility) page in the wiki.
@@ -47,74 +44,22 @@ Check out my other filters:
I highly recommend to use the upstream version (update every 5 minutes): [online+offline](https://feodotracker.abuse.ch/downloads/ipblocklist.txt) or [online only](https://feodotracker.abuse.ch/downloads/ipblocklist_recommended.txt).
-Import the following URL into uBO to subscribe:
-
-- https://malware-filter.gitlab.io/malware-filter/botnet-filter.txt
-
-
-Mirrors
-
-- https://curbengh.github.io/malware-filter/botnet-filter.txt
-- https://curbengh.github.io/botnet-filter/botnet-filter.txt
-- https://malware-filter.gitlab.io/botnet-filter/botnet-filter.txt
-- https://malware-filter.pages.dev/botnet-filter.txt
-- https://botnet-filter.pages.dev/botnet-filter.txt
+Import the link into uBO's filter list to subscribe.
## IP-based (AdGuard)
-Import the following URL into AdGuard browser extension to subscribe:
-
-- https://malware-filter.gitlab.io/malware-filter/botnet-filter-ag.txt
-
-
-Mirrors
-
-- https://curbengh.github.io/malware-filter/botnet-filter-ag.txt
-- https://curbengh.github.io/botnet-filter/botnet-filter-ag.txt
-- https://malware-filter.gitlab.io/botnet-filter/botnet-filter-ag.txt
-- https://malware-filter.pages.dev/botnet-filter-ag.txt
-- https://botnet-filter.pages.dev/botnet-filter-ag.txt
-
-
+Import the link into AdGuard browser extension to subscribe.
## IP-based (Vivaldi)
_Requires Vivaldi Desktop/Android 3.3+, blocking level must be at least "Block Trackers"_
-Import the following URL into Vivaldi's **Tracker Blocking Sources** to subscribe:
-
-- https://malware-filter.gitlab.io/malware-filter/botnet-filter-vivaldi.txt
-
-
-Mirrors
-
-- https://curbengh.github.io/malware-filter/botnet-filter-vivaldi.txt
-- https://curbengh.github.io/botnet-filter/botnet-filter-vivaldi.txt
-- https://malware-filter.gitlab.io/botnet-filter/botnet-filter-vivaldi.txt
-- https://malware-filter.pages.dev/botnet-filter-vivaldi.txt
-- https://botnet-filter.pages.dev/botnet-filter-vivaldi.txt
-
-
+Import the link into Vivaldi's **Tracker Blocking Sources** to subscribe.
## Domain-based (AdGuard Home)
-This AdGuard Home-compatible blocklist includes domains and IP addresses.
-
-- https://malware-filter.gitlab.io/malware-filter/botnet-filter-agh.txt
-
-
-Mirrors
-
-- https://curbengh.github.io/malware-filter/botnet-filter-agh.txt
-- https://curbengh.github.io/botnet-filter/botnet-filter-agh.txt
-- https://malware-filter.gitlab.io/botnet-filter/botnet-filter-agh.txt
-- https://malware-filter.pages.dev/botnet-filter-agh.txt
-- https://botnet-filter.pages.dev/botnet-filter-agh.txt
-
-
-
## dnscrypt-proxy
Save the rulesets to "/etc/dnscrypt-proxy/". Refer to this [guide](https://gitlab.com/malware-filter/malware-filter/wikis/update-filter) for auto-update.
@@ -126,19 +71,6 @@ Configure dnscrypt-proxy to use the blocklist:
+ blocked_ips_file = '/etc/dnscrypt-proxy/botnet-filter-dnscrypt-blocked-ips.txt'
```
-- https://malware-filter.gitlab.io/malware-filter/botnet-filter-dnscrypt-blocked-ips.txt
-
-
-Mirrors
-
-- https://curbengh.github.io/malware-filter/botnet-filter-dnscrypt-blocked-ips.txt
-- https://curbengh.github.io/botnet-filter/botnet-filter-dnscrypt-blocked-ips.txt
-- https://malware-filter.gitlab.io/botnet-filter/botnet-filter-dnscrypt-blocked-ips.txt
-- https://malware-filter.pages.dev/botnet-filter-dnscrypt-blocked-ips.txt
-- https://botnet-filter.pages.dev/botnet-filter-dnscrypt-blocked-ips.txt
-
-
-
## Snort2
I highly recommend to use the [upstream version](https://feodotracker.abuse.ch/blocklist/#ip-ids) which is updated every 5 minutes.
@@ -149,19 +81,6 @@ Configure Snort to use the ruleset:
`printf "\ninclude \$RULE_PATH/botnet-filter-suricata.rules\n" >> /etc/snort/snort.conf`
-- https://malware-filter.gitlab.io/malware-filter/botnet-filter-suricata.rules
-
-
-Mirrors
-
-- https://curbengh.github.io/malware-filter/botnet-filter-suricata.rules
-- https://curbengh.github.io/botnet-filter/botnet-filter-suricata.rules
-- https://malware-filter.gitlab.io/botnet-filter/botnet-filter-suricata.rules
-- https://malware-filter.pages.dev/botnet-filter-suricata.rules
-- https://botnet-filter.pages.dev/botnet-filter-suricata.rules
-
-
-
## Snort3
I highly recommend to use the [upstream version](https://feodotracker.abuse.ch/blocklist/#ip-ids) which is updated every 5 minutes.
@@ -179,19 +98,6 @@ ips =
}
```
-- https://malware-filter.gitlab.io/malware-filter/botnet-filter-suricata.rules
-
-
-Mirrors
-
-- https://curbengh.github.io/malware-filter/botnet-filter-suricata.rules
-- https://curbengh.github.io/botnet-filter/botnet-filter-suricata.rules
-- https://malware-filter.gitlab.io/botnet-filter/botnet-filter-suricata.rules
-- https://malware-filter.pages.dev/botnet-filter-suricata.rules
-- https://botnet-filter.pages.dev/botnet-filter-suricata.rules
-
-
-
## Suricata
I highly recommend to use the [upstream version](https://feodotracker.abuse.ch/blocklist/#ip-ids) which is updated every 5 minutes.
@@ -207,24 +113,13 @@ rule-files:
+ - botnet-filter-suricata.rules
```
-- https://malware-filter.gitlab.io/malware-filter/botnet-filter-suricata.rules
-
-
-Mirrors
-
-- https://curbengh.github.io/malware-filter/botnet-filter-suricata.rules
-- https://curbengh.github.io/botnet-filter/botnet-filter-suricata.rules
-- https://malware-filter.gitlab.io/botnet-filter/botnet-filter-suricata.rules
-- https://malware-filter.pages.dev/botnet-filter-suricata.rules
-- https://botnet-filter.pages.dev/botnet-filter-suricata.rules
-
-
-
## Splunk
-A CSV file for Splunk [lookup](https://docs.splunk.com/Documentation/Splunk/9.0.2/Knowledge/Aboutlookupsandfieldactions).
+A CSV file for Splunk [lookup](https://docs.splunk.com/Documentation/Splunk/latest/Knowledge/Aboutlookupsandfieldactions).
-Either upload the file via GUI or save the file in `$SPLUNK_HOME/Splunk/etc/system/lookups` or app-specific `$SPLUNK_HOME/etc/YourApp/apps/search/lookups`. Refer to this [guide](https://gitlab.com/malware-filter/malware-filter/wikis/update-filter) or [Getwatchlist](https://splunkbase.splunk.com/app/635) app for auto-update.
+Either upload the file via GUI or save the file in `$SPLUNK_HOME/Splunk/etc/system/lookups` or app-specific `$SPLUNK_HOME/etc/YourApp/apps/search/lookups`.
+
+Or use [malware-filter add-on](https://splunkbase.splunk.com/app/6970) to install this lookup and optionally auto-update it.
Columns:
@@ -232,19 +127,6 @@ Columns:
| ------- | -------------------------------- | -------------------- |
| 1.2.3.4 | botnet-filter botnet IP detected | 2022-12-21T12:34:56Z |
-- https://malware-filter.gitlab.io/malware-filter/botnet-filter-splunk.csv
-
-
-Mirrors
-
-- https://curbengh.github.io/malware-filter/botnet-filter-splunk.csv
-- https://curbengh.github.io/botnet-filter/botnet-filter-splunk.csv
-- https://malware-filter.gitlab.io/botnet-filter/botnet-filter-splunk.csv
-- https://malware-filter.pages.dev/botnet-filter-splunk.csv
-- https://botnet-filter.pages.dev/botnet-filter-splunk.csv
-
-
-
## Compressed version
All filters are also available as gzip- and brotli-compressed.