block/README.md

# block

A collection of domains, wildcards and substrings designed for [`dnscrypt-proxy`](https://github.com/DNSCrypt/dnscrypt-proxy) filter method.

- __allowed-names.txt:__ it's the file used to unblock a specific domain blocked by some substring/wildcard contained in the blocklists.
- __domains-blocklist.conf:__ it's used to configure the sources to merge during the process.
- __domains-blocklist-local-additions.txt:__ it's used during the generation process to add your own additions and remove duplicates from the sources.
- __domains-allowlist.txt:__ it's used during the generation process to remove legit domains.
- __example-blocklist.txt:__ it contains valid name patterns for this purpose.
- __generate-domains-blocklist.py:__ it's the script used to launch the generation process.

## Sources

Updated sources from the following locations are always merged and included.

#### blocked-names.txt

| Source | Maintainer(s) | Description | Home Page | RAW Source | License |
|--------|:-------------:|-------------|:---------:|:----------:|:-------:|
OISD: Domains (full) | sjhgvr | A merged domain list from a variety of other lists  | [LINK](https://oisd.nl/) | [RAW](https://dbl.oisd.nl/) | All Rights Reserved |
 domains-blocklist-local-additions.txt | quindecim | Domains, wildcards and substrings collection | [LINK](https://codeberg.org/quindecim/block) | [RAW](https://codeberg.org/quindecim/block/raw/branch/master/config/domains-blocklist-local-additions.txt) | GPLv3 |
 domains-allowlist.txt | quindecim | Legit domains collection | [LINK](https://codeberg.org/quindecim/block) | [RAW](https://codeberg.org/quindecim/block/raw/branch/master/config/domains-allowlist.txt) | GPLv3 |

#### blocked-ips.txt

| Source | Maintainer(s) | Description | Home Page | RAW Source | License |
|--------|:-------------:|-------------|:---------:|:----------:|:-------:|
DNSCrypt: Rebind Protection | jedisct1 | DNS rebinding protection | [LINK](https://github.com/DNSCrypt/dnscrypt-proxy/wiki/Filters#dns-rebinding-protection) | - | ISC |

## Build

To generate your own list you can clone this repo, move into the `config` folder, edit files according to your needs and run this command:
```
python3 generate-domains-blocklist.py > list.txt.tmp && mv -f list.txt.tmp list
```
Update 'README.md' 2021-03-05 07:44:47 +00:00			`# block`
Initial commit 2020-02-22 09:51:02 +00:00
Update 'README.md' 2020-05-19 19:08:04 +00:00			A collection of domains, wildcards and substrings designed for [`dnscrypt-proxy`](https://github.com/DNSCrypt/dnscrypt-proxy) filter method.
Update 'README.md' 2020-02-22 10:13:45 +00:00
Update 'README.md' 2021-01-27 14:52:00 +00:00			`- __allowed-names.txt:__ it's the file used to unblock a specific domain blocked by some substring/wildcard contained in the blocklists.`
Update 'README.md' 2021-01-22 09:23:19 +00:00			`- __domains-blocklist.conf:__ it's used to configure the sources to merge during the process.`
			`- __domains-blocklist-local-additions.txt:__ it's used during the generation process to add your own additions and remove duplicates from the sources.`
			`- __domains-allowlist.txt:__ it's used during the generation process to remove legit domains.`
			`- __example-blocklist.txt:__ it contains valid name patterns for this purpose.`
			`- __generate-domains-blocklist.py:__ it's the script used to launch the generation process.`
Update 'README.md' 2020-02-22 10:13:45 +00:00
Update 'README.md' 2021-01-22 09:23:19 +00:00			`## Sources`
Update 'README.md' 2020-05-19 19:08:04 +00:00
Update 'README.md' 2020-05-19 19:10:46 +00:00			`Updated sources from the following locations are always merged and included.`
Update 'README.md' 2020-05-19 19:08:04 +00:00
Update 'README.md' 2021-01-22 09:23:19 +00:00			`#### blocked-names.txt`

Update 'README.md' 2020-05-19 19:08:04 +00:00			`\| Source \| Maintainer(s) \| Description \| Home Page \| RAW Source \| License \|`
			`\|--------\|:-------------:\|-------------\|:---------:\|:----------:\|:-------:\|`
[REVERT] - Move from OISD: Domains [full] to OISD - Domains (wildcards) [full] 2021-03-28 18:54:19 +00:00			`OISD: Domains (full) \| sjhgvr \| A merged domain list from a variety of other lists \| [LINK](https://oisd.nl/) \| [RAW](https://dbl.oisd.nl/) \| All Rights Reserved \|`
[DOCS] - Update the few git.nixnet.xyz links left to codeberg.org 2021-04-13 11:30:54 +00:00			`domains-blocklist-local-additions.txt \| quindecim \| Domains, wildcards and substrings collection \| [LINK](https://codeberg.org/quindecim/block) \| [RAW](https://codeberg.org/quindecim/block/raw/branch/master/config/domains-blocklist-local-additions.txt) \| GPLv3 \|`
[UPDATE] - Codeberg migration 2021-03-04 10:06:41 +00:00			`domains-allowlist.txt \| quindecim \| Legit domains collection \| [LINK](https://codeberg.org/quindecim/block) \| [RAW](https://codeberg.org/quindecim/block/raw/branch/master/config/domains-allowlist.txt) \| GPLv3 \|`
Update 'README.md' 2021-01-22 09:23:19 +00:00
			`#### blocked-ips.txt`

			`\| Source \| Maintainer(s) \| Description \| Home Page \| RAW Source \| License \|`
			`\|--------\|:-------------:\|-------------\|:---------:\|:----------:\|:-------:\|`
Update 'README.md' 2021-03-28 18:58:54 +00:00			`DNSCrypt: Rebind Protection \| jedisct1 \| DNS rebinding protection \| [LINK](https://github.com/DNSCrypt/dnscrypt-proxy/wiki/Filters#dns-rebinding-protection) \| - \| ISC \|`
Update 'README.md' 2020-05-19 19:08:04 +00:00
Update 'README.md' 2021-01-22 09:23:19 +00:00			`## Build`
Update 'README.md' 2020-10-27 09:54:30 +00:00
[UPDATE] - Update build intructions 2021-02-25 09:24:06 +00:00			To generate your own list you can clone this repo, move into the `config` folder, edit files according to your needs and run this command:
Update 'README.md' 2020-10-27 09:54:30 +00:00			```
[UPDATE] - Use python3 + fixed raw links 2021-02-23 09:33:55 +00:00			`python3 generate-domains-blocklist.py > list.txt.tmp && mv -f list.txt.tmp list`
[UPDATE] - Notice section removed 2021-02-25 09:21:17 +00:00			```