├── .github ├── FUNDING.yml └── ISSUE_TEMPLATE │ ├── 00-bug.yml │ └── config.yml ├── LICENSE ├── README.md ├── deployment ├── README.md └── ignore-repo ├── dns └── README.md └── graphs ├── backend.graphml └── backend.png /.github/FUNDING.yml: -------------------------------------------------------------------------------- 1 | github: 2 | - funilrys 3 | ko_fi: mitchellkrog 4 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/00-bug.yml: -------------------------------------------------------------------------------- 1 | name: Bug Report 2 | description: Report a bug or issue. 3 | title: "Bug | My Awesome Bug" 4 | labels: 5 | - bug 6 | projects: 7 | - Ultimate-Hosts-Blacklist/4 8 | assignees: 9 | - funilrys 10 | - mitchellkrogza 11 | body: 12 | - type: markdown 13 | attributes: 14 | value: |+ 15 | Thanks for taking the time to fill out this bug report! 16 | 17 | _Please help us by reporting to the right place. If you are not sure, please check the project's [README](https://github.com/Ultimate-Hosts-Blacklist/Ultimate.Hosts.Blacklist?tab=readme-ov-file#where-to-report-or-discuss-about-something-)._ 18 | 19 | We understand that this can be frustrating, confusing, embarrassing, time consuming, and even painful for you. 20 | Please be patient and rest assured that one of our team members will try to address your issue as soon as possible. 21 | Please be sure to provide as much information as possible to help us understand the issue. 22 | 23 | All bug reports are welcome, but please be aware that: 24 | - We are a small team and may not be able to respond immediately. 25 | - We may ask for more information to help us understand the issue. 26 | - Your request may be moved to our [dev-center](https://github.com/Ultimate-Hosts-Blacklist/dev-center/issues) or one of our other repositories. 27 | 28 | We appreciate your help in making the Ultimate-Hosts-Blacklist better! 29 | 30 | The Ultimate-Hosts-Blacklist Team. 31 | 32 | 33 | - type: textarea 34 | id: problem 35 | attributes: 36 | label: What is the problem you are experiencing? 37 | description: Please describe the problem you are experiencing. 38 | placeholder: | 39 | I am experiencing a problem where... 40 | value: | 41 | I am experiencing a problem where... 42 | validations: 43 | required: true 44 | 45 | - type: textarea 46 | id: reproduction 47 | attributes: 48 | label: How can we reproduce the problem? 49 | description: Please describe how we can reproduce the problem. 50 | placeholder: | 51 | To reproduce the problem... 52 | value: | 53 | To reproduce the problem... 54 | validations: 55 | required: true 56 | 57 | - type: textarea 58 | id: expected 59 | attributes: 60 | label: What did you expect to happen? 61 | description: Please describe what you expected to happen. 62 | placeholder: | 63 | I expected that... 64 | value: | 65 | I expected that... 66 | validations: 67 | required: true 68 | 69 | - type: textarea 70 | id: workaround 71 | attributes: 72 | label: Is there a workaround? 73 | description: Please describe if there is a workaround. 74 | placeholder: | 75 | I found a workaround... 76 | value: | 77 | I found a workaround... 78 | validations: 79 | required: false 80 | 81 | - type: textarea 82 | id: additional 83 | attributes: 84 | label: Additional context 85 | description: Please provide any additional context or screenshots. 86 | placeholder: | 87 | I would like to add... 88 | value: | 89 | I would like to add... 90 | validations: 91 | required: false 92 | 93 | # - type: checkboxes 94 | # id: terms 95 | # attributes: 96 | # label: Code of Conduct 97 | # description: By submitting this issue, you agree to follow our [Code of Conduct](https://example.org/todo). 98 | # options: 99 | # - label: I agree to follow this project's Code of Conduct 100 | # required: true 101 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/config.yml: -------------------------------------------------------------------------------- 1 | blank_issues_enabled: false 2 | contact_links: 3 | - name: Main Repository 4 | url: https://github.com/Ultimate-Hosts-Blacklist/Ultimate.Hosts.Blacklist 5 | about: Find more information about the main repository here. 6 | - name: Global Discussions 7 | url: https://github.com/Ultimate-Hosts-Blacklist/Ultimate.Hosts.Blacklist/discussions 8 | about: Please ask and answer questions here. 9 | - name: Whitelist Discussions 10 | url: https://github.com/Ultimate-Hosts-Blacklist/whitelist/discussions 11 | about: Please ask and answer questions related to the whitelist here. 12 | - name: Blacklist Discussions 13 | url: https://github.com/Ultimate-Hosts-Blacklist/blacklist/discussions 14 | about: Please ask and answer questions related to the blacklist here. 15 | - name: Whitelist 16 | url: https://github.com/Ultimate-Hosts-Blacklist/whitelist/issues 17 | about: Please report whitelist review requests here. 18 | - name: Blacklist 19 | url: https://github.com/Ultimate-Hosts-Blacklist/blacklist/issues 20 | about: Please report blacklist review requests here. 21 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2017-2024 Mitchell Krog - @mitchellkrogza 4 | Copyright (c) 2017-2024 Nissar Chababy - @funilrys 5 | Copyright (c) 2017-2024 Ultimate Hosts Blacklist - @Ultimate-Hosts-Blacklist Contributors 6 | 7 | Permission is hereby granted, free of charge, to any person obtaining a copy 8 | of this software and associated documentation files (the "Software"), to deal 9 | in the Software without restriction, including without limitation the rights 10 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 11 | copies of the Software, and to permit persons to whom the Software is 12 | furnished to do so, subject to the following conditions: 13 | 14 | The above copyright notice and this permission notice shall be included in all 15 | copies or substantial portions of the Software. 16 | 17 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 18 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 19 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 20 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 21 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 22 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 23 | SOFTWARE. 24 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Ultimate Hosts Blacklist - dev-center 2 | 3 | ## DNS Server 4 | 5 | For everything regarding the DNS server, please move into the `dns` folder. 6 | 7 | 8 | ## Comparison system 9 | 10 | Want to compare a list with the current state of the Ultimate Hosts Blacklist ? Simply move to the [`compare-with-system`](https://github.com/Ultimate-Hosts-Blacklist/dev-center/tree/compare-with-system) branch. 11 | 12 | ## Whitelisting program 13 | 14 | We created a whitelisting program for the world to use! [Read more about it](https://github.com/Ultimate-Hosts-Blacklist/whitelist/tree/script). 15 | 16 | ## How does our backend work? 17 | 18 | Here is a graph! 19 | 20 | ![UHB Backend](https://github.com/Ultimate-Hosts-Blacklist/dev-center/raw/master/graphs/backend.png "UHB Backend") 21 | -------------------------------------------------------------------------------- /deployment/README.md: -------------------------------------------------------------------------------- 1 | # Deployment 2 | 3 | This folder provides everything related or used for the deployment. 4 | 5 | ## `ignore-repo` 6 | 7 | The `ignore-repo` file will be fetched before starting the deployment. 8 | It should contain the name of the repositories to ignore. 9 | 10 | **Syntax:** One repository name per line. Comment should start with `#`. 11 | -------------------------------------------------------------------------------- /deployment/ignore-repo: -------------------------------------------------------------------------------- 1 | # Core components. 2 | dev-center 3 | template 4 | repository-structure 5 | Ultimate.Hosts.Blacklist 6 | .github 7 | whitelist 8 | test-launcher 9 | deployment-launcher 10 | webservice 11 | comparison-tool 12 | helpers-tools 13 | arch-linux-gh-actions-runner 14 | whitelist-tool 15 | 16 | # Input sources 17 | smed79_blacklist_nsfw 18 | smed79_blocklist_facebook 19 | ZeroDot1_CoinBlockerLists_optional 20 | -------------------------------------------------------------------------------- /dns/README.md: -------------------------------------------------------------------------------- 1 | # DNS 2 | 3 | The Ultimate Hosts Blacklist project offers 2 DNS servers that are updated 4 | daily. They are free to use and can be used instead of the other list we offer. 5 | 6 | Both DNS servers are located in Germany. They are configured to answer DNS 7 | queries with the [bind](https://www.isc.org/bind/) DNS implementation software. 8 | 9 | Our project follows a Zero-Logging policy. Meaning that we don't store any 10 | information about your queries nor their answers. 11 | 12 | ### Location 13 | 14 | Our servers are reachable 15 | 16 | | DNS Name | safedns.allover.co.za | safedns2.allover.co.za | Ports | 17 | | -------- | ----------------------- | ----------------------- | ------------ | 18 | | IPv4 | `88.198.70.38` | `88.198.70.39` | `53`, `5353` | 19 | | IPv6 | `2a01:4f8:140:5021::38` | `2a01:4f8:140:5021::39` | `53`, `5353` | 20 | 21 | ### Testing 22 | 23 | After each successful launch of our self-crafted software, the 24 | `xxx.allover.co.za` domain is added into one of the generated RPZ zones. 25 | 26 | Therefore, one can test through the following - or their equivalent for your 27 | system or distribution. 28 | 29 | IPv4: 30 | 31 | ```shell 32 | $ dig +short -t A xxx.allover.co.za @safedns.allover.co.za 33 | 0.0.0.0 34 | $ dig +short -t A xxx.allover.co.za @safedns2.allover.co.za 35 | 0.0.0.0 36 | ``` 37 | 38 | IPv6: 39 | 40 | ```shell 41 | $ dig +short -t AAAA xxx.allover.co.za @safedns.allover.co.za 42 | :: 43 | $ dig +short -t AAAA xxx.allover.co.za @safedns2.allover.co.za 44 | :: 45 | ``` 46 | 47 | ### Configuration 48 | 49 | Our servers are configured as masters. There is no Master/Slave constellation. 50 | 51 | A self-crafted software that merges all data from and create the RPZ zones out 52 | of them is automatically running every night or on-demand. 53 | 54 | Our logging configuration is the following: 55 | 56 | ``` 57 | logging { 58 | category default { null; }; 59 | }; 60 | ``` 61 | -------------------------------------------------------------------------------- /graphs/backend.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Ultimate-Hosts-Blacklist/dev-center/5ee907b4a4b1d41e7b257c983ab28b8ee4f5925d/graphs/backend.png --------------------------------------------------------------------------------