185 lines
8.1 KiB
Markdown
185 lines
8.1 KiB
Markdown
# URLhaus Malicious URL Blocklist
|
|
|
|
A block list of malicious URLs that are being used for malware distribution. This [uBO](https://github.com/gorhill/uBlock/)-compatible filter list is based on the **Database dump (CSV)** of Abuse.ch [URLhaus](https://urlhaus.abuse.ch/).
|
|
|
|
## Subscribe
|
|
|
|
Filter is updated twice a day.
|
|
|
|
Import the following URL into uBO to subscribe:
|
|
|
|
- https://gitlab.com/curben/urlhaus-filter/raw/master/urlhaus-filter.txt
|
|
|
|
<details>
|
|
<summary>Mirrors</summary>
|
|
|
|
- https://cdn.statically.io/gl/curben/urlhaus-filter/raw/master/urlhaus-filter.txt
|
|
- https://glcdn.githack.com/curben/urlhaus-filter/raw/master/urlhaus-filter.txt
|
|
- https://raw.githubusercontent.com/curbengh/urlhaus-filter/master/urlhaus-filter.txt
|
|
- https://cdn.statically.io/gh/curbengh/urlhaus-filter/master/urlhaus-filter.txt
|
|
- https://gitcdn.xyz/repo/curbengh/urlhaus-filter/master/urlhaus-filter.txt
|
|
- https://cdn.jsdelivr.net/gh/curbengh/urlhaus-filter/urlhaus-filter.txt
|
|
- https://repo.or.cz/urlhaus-filter.git/blob_plain/refs/heads/master:/urlhaus-filter.txt
|
|
|
|
</details>
|
|
|
|
<br />
|
|
Lite version (online urls only):
|
|
|
|
- https://gitlab.com/curben/urlhaus-filter/raw/master/urlhaus-filter-online.txt
|
|
|
|
<details>
|
|
<summary>Mirrors</summary>
|
|
|
|
- https://cdn.statically.io/gl/curben/urlhaus-filter/raw/master/urlhaus-filter-online.txt
|
|
- https://glcdn.githack.com/curben/urlhaus-filter/raw/master/urlhaus-filter-online.txt
|
|
- https://raw.githubusercontent.com/curbengh/urlhaus-filter/master/urlhaus-filter-online.txt
|
|
- https://cdn.statically.io/gh/curbengh/urlhaus-filter/master/urlhaus-filter-online.txt
|
|
- https://gitcdn.xyz/repo/curbengh/urlhaus-filter/master/urlhaus-filter-online.txt
|
|
- https://cdn.jsdelivr.net/gh/curbengh/urlhaus-filter/urlhaus-filter-online.txt
|
|
- https://repo.or.cz/urlhaus-filter.git/blob_plain/refs/heads/master:/urlhaus-filter-online.txt
|
|
|
|
</details>
|
|
|
|
**Note:** Lite version is ~95% smaller by excluding offline urls. The status of urls is determined by the upstream Abuse.ch. However, the test is not 100% accurate and some malicious urls that are otherwise accessible may be missed. If bandwidth (1.5MB/day) is not a constraint, I recommend the regular version.
|
|
|
|
*PS: While regular version contains roughly 65K filters, uBO can [easily handle](https://github.com/uBlockOrigin/uBlock-issues/issues/338#issuecomment-452843669) half a million filters.*
|
|
|
|
## Compatibility
|
|
|
|
This filter is only tested with uBO. [FilterLists](https://filterlists.com/) shows it is compatible with the following software:
|
|
|
|
- [AdNauseam](https://github.com/dhowe/AdNauseam/)
|
|
- [NanoAdblocker](https://github.com/NanoAdblocker/NanoCore)
|
|
|
|
Host/DNS-based software uses host-based blocklist instead, see below section.
|
|
|
|
## Host-based blocklist
|
|
|
|
If you're using host-based blockers like one of the following (but not limited to):
|
|
|
|
- [AdGuard Home](https://github.com/AdguardTeam/AdGuardHome)
|
|
- [Blokada](https://github.com/blokadaorg/blokada/)
|
|
- [Google Hit Hider](https://www.jeffersonscher.com/gm/google-hit-hider/)
|
|
- [hostsmgr](https://www.henrypp.org/product/hostsmgr)
|
|
- [Personal Blocklist](https://addons.mozilla.org/firefox/addon/personal-blocklist/)
|
|
- [personalDNSfilter](https://zenz-solutions.de/personaldnsfilter)
|
|
- [Pi-hole](https://pi-hole.net/)
|
|
- [Samsung Knox](https://www.samsungknox.com/)
|
|
- [uMatrix](https://github.com/gorhill/uMatrix)
|
|
|
|
The filters listed in [Subscribe](#subscribe) section are not compatible.
|
|
Instead, use the following blocklist:
|
|
|
|
- https://gitlab.com/curben/urlhaus-filter/raw/master/urlhaus-filter-hosts.txt
|
|
|
|
<details>
|
|
<summary>Mirrors</summary>
|
|
|
|
- https://cdn.statically.io/gl/curben/urlhaus-filter/raw/master/urlhaus-filter-hosts.txt
|
|
- https://glcdn.githack.com/curben/urlhaus-filter/raw/master/urlhaus-filter-hosts.txt
|
|
- https://raw.githubusercontent.com/curbengh/urlhaus-filter/master/urlhaus-filter-hosts.txt
|
|
- https://cdn.statically.io/gh/curbengh/urlhaus-filter/master/urlhaus-filter-hosts.txt
|
|
- https://gitcdn.xyz/repo/curbengh/urlhaus-filter/master/urlhaus-filter-hosts.txt
|
|
- https://cdn.jsdelivr.net/gh/curbengh/urlhaus-filter/urlhaus-filter-hosts.txt
|
|
- https://repo.or.cz/urlhaus-filter.git/blob_plain/refs/heads/master:/urlhaus-filter-hosts.txt
|
|
|
|
</details>
|
|
|
|
<br />
|
|
Lite version (online hosts only):
|
|
|
|
- https://gitlab.com/curben/urlhaus-filter/raw/master/urlhaus-filter-hosts-online.txt
|
|
|
|
<details>
|
|
<summary>Mirrors</summary>
|
|
|
|
- https://cdn.statically.io/gl/curben/urlhaus-filter/raw/master/urlhaus-filter-hosts-online.txt
|
|
- https://glcdn.githack.com/curben/urlhaus-filter/raw/master/urlhaus-filter-hosts-online.txt
|
|
- https://raw.githubusercontent.com/curbengh/urlhaus-filter/master/urlhaus-filter-hosts-online.txt
|
|
- https://cdn.statically.io/gh/curbengh/urlhaus-filter/master/urlhaus-filter-hosts-online.txt
|
|
- https://gitcdn.xyz/repo/curbengh/urlhaus-filter/master/urlhaus-filter-hosts-online.txt
|
|
- https://cdn.jsdelivr.net/gh/curbengh/urlhaus-filter/urlhaus-filter-hosts-online.txt
|
|
- https://repo.or.cz/urlhaus-filter.git/blob_plain/refs/heads/master:/urlhaus-filter-hosts-online.txt
|
|
|
|
</details>
|
|
|
|
Note that host-based software does not block malware URLs hosted by well-known domains (e.g. amazonaws.com, docs.google.com, dropbox.com).
|
|
|
|
## Dnsmasq
|
|
|
|
Dnsmasq-compatible blocklist is also available.
|
|
|
|
### Install
|
|
|
|
```
|
|
mkdir -p ~/.config/urlhaus-filter/
|
|
curl https://gitlab.com/curben/urlhaus-filter/raw/master/urlhaus-filter-dnsmasq.conf -o ~/.config/urlhaus-filter/urlhaus-filter-dnsmasq.conf
|
|
printf "\nconf-file=$HOME/.config/urlhaus-filter/urlhaus-filter-dnsmasq.conf\n" >> /etc/dnsmasq.conf
|
|
```
|
|
|
|
### Update
|
|
|
|
```
|
|
curl https://gitlab.com/curben/urlhaus-filter/raw/master/urlhaus-filter-dnsmasq.conf -o ~/.config/urlhaus-filter/urlhaus-filter-dnsmasq.conf
|
|
```
|
|
|
|
<details>
|
|
<summary>Mirrors</summary>
|
|
|
|
- https://cdn.statically.io/gl/curben/urlhaus-filter/raw/master/urlhaus-filter-dnsmasq.conf
|
|
- https://glcdn.githack.com/curben/urlhaus-filter/raw/master/urlhaus-filter-dnsmasq.conf
|
|
- https://raw.githubusercontent.com/curbengh/urlhaus-filter/master/urlhaus-filter-dnsmasq.conf
|
|
- https://cdn.statically.io/gh/curbengh/urlhaus-filter/master/urlhaus-filter-dnsmasq.conf
|
|
- https://gitcdn.xyz/repo/curbengh/urlhaus-filter/master/urlhaus-filter-dnsmasq.conf
|
|
- https://cdn.jsdelivr.net/gh/curbengh/urlhaus-filter/urlhaus-filter-dnsmasq.conf
|
|
- https://repo.or.cz/urlhaus-filter.git/blob_plain/refs/heads/master:/urlhaus-filter-dnsmasq.conf
|
|
|
|
</details>
|
|
|
|
<br />
|
|
Lite version (online urls only); filename is different, adjust the installation and update instructions appropriately:
|
|
|
|
- https://gitlab.com/curben/urlhaus-filter/raw/master/urlhaus-filter-dnsmasq-online.conf
|
|
|
|
<details>
|
|
<summary>Mirrors</summary>
|
|
|
|
- https://cdn.statically.io/gl/curben/urlhaus-filter/raw/master/urlhaus-filter-dnsmasq-online.conf
|
|
- https://glcdn.githack.com/curben/urlhaus-filter/raw/master/urlhaus-filter-dnsmasq-online.conf
|
|
- https://raw.githubusercontent.com/curbengh/urlhaus-filter/master/urlhaus-filter-dnsmasq-online.conf
|
|
- https://cdn.statically.io/gh/curbengh/urlhaus-filter/master/urlhaus-filter-dnsmasq-online.conf
|
|
- https://gitcdn.xyz/repo/curbengh/urlhaus-filter/master/urlhaus-filter-dnsmasq-online.conf
|
|
- https://cdn.jsdelivr.net/gh/curbengh/urlhaus-filter/urlhaus-filter-dnsmasq-online.conf
|
|
- https://repo.or.cz/urlhaus-filter.git/blob_plain/refs/heads/master:/urlhaus-filter-dnsmasq-online.conf
|
|
|
|
</details>
|
|
|
|
Note that it is not possible for Dnsmasq to block malicious IP address.
|
|
|
|
## Issues
|
|
|
|
Report any false positive by creating an [issue](https://gitlab.com/curben/urlhaus-filter/issues) or [merge request](https://gitlab.com/curben/urlhaus-filter/merge_requests)
|
|
|
|
This filter **only** accepts malware URLs from [URLhaus](https://urlhaus.abuse.ch/).
|
|
|
|
Please report new malware URL to the upstream maintainer through https://urlhaus.abuse.ch/api/#submit.
|
|
|
|
This repo is not endorsed by Abuse.ch.
|
|
|
|
## Cloning
|
|
|
|
Since the filter is updated frequently, cloning the repo would become slower over time as the revision grows.
|
|
|
|
Use shallow clone to get the recent revisions only. Getting the last five revisions should be sufficient for a valid MR.
|
|
|
|
`git clone --depth 5 https://gitlab.com/curben/urlhaus-filter.git`
|
|
|
|
## License
|
|
|
|
[Creative Commons Zero v1.0 Universal](LICENSE.md)
|
|
|
|
## FAQ
|
|
|
|
See [wiki](https://gitlab.com/curben/urlhaus-filter/wikis/FAQ).
|