Skip to content

Commit 1090fb3

Browse files
Update block-lists.md
1 parent 91d5ec5 commit 1090fb3

File tree

1 file changed

+33
-3
lines changed

1 file changed

+33
-3
lines changed

wiki/block-lists.md

Lines changed: 33 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ Supported list stypes
1818
* [Lists of regular expressions](#lists-of-domains-with-regular-expressions)
1919
* [Lists of IPs](#lists-of-ips)
2020
* [Lists of Nets](#lists-of-nets)
21+
* [Lsits of MD5s](#lists-of-md5s-added-in-v170)
2122

2223
[Notes](#notes)
2324

@@ -110,18 +111,19 @@ adtrack(er|ing)?[0-9]*[_.-]
110111
^stat(s|istics)?[0-9]*[_.-]
111112
```
112113

113-
**Note**: if you add a domain without regex to this type of list, it'll match everything for that domain: _google.com_ will match _clients6.google.com_, _docs.google.com_, etc.
114+
**Note**: if you add a domain without a regex to this type of list, it'll match everything for that domain: _google.com_ will match _clients6.google.com_, _docs.google.com_, etc.
114115

115-
**Note**: Sometimes regular expressions can be too generic, so they may block too much domains. You can go to Rules tab -> double click on the rule, and see what domains the rule has matched, and refine the list accordingly.
116+
**Note**: Sometimes regular expressions can be too generic, so they may block too many domains. You can go to Rules tab -> double click on the rule, and see what domains the rule has matched, and refine the list accordingly.
116117

117-
**Warning**: This lists must be small (~500 items). Using it with huge lists will lead to important performance penalty ([#866](https://github.com/evilsocket/opensnitch/issues/866)).
118+
⚠️ **WARNING** ⚠️: This list must be small (~500 items). Using it with huge lists will lead to important performance penalty ([#866](https://github.com/evilsocket/opensnitch/issues/866)).
118119

119120
Here's a playground you can use to test regular expressions: https://go.dev/play/p/JzQCeNH4OH1
120121

121122
---
122123

123124
#### Lists of IPs
124125
- One per line:
126+
125127
IPs
126128
```
127129
# https://iplists.firehol.org/
@@ -143,6 +145,32 @@ Nets:
143145

144146
---
145147

148+
#### Lists of md5s (added in v1.7.0)
149+
Use this type to allow or block list of md5s.
150+
151+
```json
152+
"operator": {
153+
"type": "lists",
154+
"operand": "lists.hash.md5",
155+
"sensitive": false,
156+
"data": "/etc/opensnitchd/md5list/",
157+
"list": []
158+
}
159+
```
160+
161+
For example you can download a list of known malware in the wild from [bazaar.abuse.ch](https://bazaar.abuse.ch/export/)
162+
163+
```bash
164+
~ $ wget https://bazaar.abuse.ch/export/txt/md5/full/ -O /tmp/md5list-full.zip
165+
~ $ unzip -d /tmp/md5list-full.zip /etc/opensnitchd/md5list/
166+
~ $ head -3 /etc/opensnitchd/md5list/full_md5.txt
167+
################################################################
168+
# MalwareBazaar full malware samples dump (MD5 hashes) #
169+
# Last updated: 2025-08-12 19:33:06 UTC #
170+
```
171+
172+
---
173+
146174
#### Notes
147175
- Lines started with # are ignored. Write comments always on a new line, not after a domain.
148176
- The domains `local`, `localhost`, `localhost.localdomain` and `broadcasthost` are ignored.
@@ -217,6 +245,8 @@ https://urlhaus.abuse.ch/api/#hostfile
217245
218246
https://threatfox.abuse.ch/export/#hostfile
219247
248+
https://bazaar.abuse.ch/export/
249+
220250
Collections of Threat Intel feeds (by hash, IPs, domains, and more):
221251
222252
https://github.com/Bert-JanP/Open-Source-Threat-Intel-Feeds

0 commit comments

Comments
 (0)