My Privacy DNS Matrix

Introduction

My Privacy DNS is an organisation dedicated to maintaining a comprehensive knowledge base on blacklisted domains across various DNS blacklist projects. Our primary goal is to collect and organise this information to provide clear insights into why certain domains are blacklisted. The secondary objective is to offer these blacklists through the Matrix repository as a direct reflection of the data gathered from kb.mypdns.org/issues/MTX, Matrix issues, and mypdns.youtrack.cloud/issue/MTX.

Features

DNS Firewall

The "Matrix" project is a meticulously crafted and entirely self-managed DNS Firewall utilising Response Policy Zones (RPZ). The primary objective of this project is to safeguard your privacy by obstructing access to malicious domains and tracking servers, thereby providing a secure online environment. Given the escalating instances of online tracking and data breaches, it is imperative to adopt measures to protect one's privacy online.

Anti-Porn (Anti-NSFW) List

A notable feature of this project is the anti-porn (anti-NSFW) list, which restricts access to pornographic and explicit websites. This feature is particularly beneficial for parents who wish to prevent their children from encountering inappropriate content online.

Source List

The source directory comprises various sub-folders, each representing distinct groups for domain submissions. For instance, google.* is included in several groups due to its extensive online presence.

Categorising

Each sub-folder within sources contains a README file that outlines the list and criteria for adding domains to its domain.list or wildcard.list. Detailed explanations for each category are available in the Matrix Source Files.

Submitting

When reporting a problematic website, follow these steps in order:

1. Search existing issues for the website's eTLD (e.g. example.com) or gTLD (e.g. example.org). See:
2. If an issue already exists for that domain:
   • Add your report as a comment on the existing issue.
   • Include the website's exact URL and a screenshot as evidence.
   • Describe what is problematic and how you observed it. (For reproduction of problem)
3. If no issue exists for that domain:
   • Create a new issue titled with the eTLD or gTLD (for example: example.com or example.org).
   • In the issue body, provide:
     • The website's exact URL(s).
     • One or more screenshots as evidence.
     • A clear description of the problem and when you observed it.
4. For each distinct domain you are reporting, use a separate issue.

Notes

• Only include one domain per new issue title; add related URLs in the issue body.
• Screenshots and precise URLs help maintainers verify reports quickly.

Combining the Matrix

With RPZ, we utilise wildcard.list and domain.list records, which explains the absence of a hosts (RFC:952) file in our source list. To use My Privacy DNS's records Matrix with systems such as Pi-hole or /etc/hosts, combine both the wildcard.list and domain.list.

Whitelist

The whitelist is complex and requires meticulous handling. It is crucial to note that whitelisting is a personal task and should not be undertaken by third parties.

For instance, Gitlab hosts user-submitted content and may occasionally be flagged for malicious code. However, blocking it would significantly impact our workflow, necessitating its inclusion on the whitelist.

Bulk Commits

Bulk commits are permissible solely if executed by a @developer of the repository and only when the source is commonly trusted and the number of domains makes individual issues impractical.

FAQ

Broken Site

Q: Your lists have broken my website by blocking a third-party domain!

A: We have not caused your website to malfunction. The issue stems from your own miswritten code that compromises privacy by involving third parties.

Donations

We highly appreciate any contributions to support My Privacy DNS, a project committed to protecting online privacy. By donating to My Privacy DNS https://www.mypdns.org/donate, you are aiding in the continuation of this valuable service, which remains free of charge to the public, and supporting the development of additional privacy-friendly software.

Sponsors

• Free licence, might be provided, for members working more than 3 months on the My Privacy DNS open source project under a non-commercial licence. https://www.jetbrains.com/ides/

Official Mirrors

The following repositories are official mirrors and should be updated by push on commit:

Project	Host	Method (push | pull)
Adblocker Rules	https://git.disroot.org/my-privacy-dns/adblocker-rules	push
Adblocker Rules	https://gitea.slowb.ro/spirillen/adblocker-rules	pull
Adblocker Rules	https://github.com/mypdns/adblocker-rules	push
Adblocker Rules	https://gitlab.com/my-privacy-dns/matrix/adblocker-rules	push
=============	=====================================================	================
Matrix	https://gitea.slowb.ro/spirillen/matrix	push
Matrix	https://gitlab.com/my-privacy-dns/matrix/matrix	push

Licensing Information

This project is licensed under two different licences depending on the type of files:

• Data Files: All data files in the source/ directory are licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Licence (CC BY-NC-SA 4.0).
• Source Code and Other Files: All other files in this repository are licensed under the GNU Affero General Public Licence version 3 (AGPL-3.0).

For more details, please refer to the respective licence files included in this repository.