noVibe / DnsConf
git clone https://github.com/noVibe/DnsConf.git
DNS Block and Redirect configurer for Cloudflare / NextDNS
+15
stars, 24h · #2,397
+~63
stars, 7 days · #3,261
+~270
stars, 30 days · #2,962
1.3k
★ total · +5% this week
4.1k
forks · 2 open issues
Star history (as recorded here)
LanguageJava
License—
Created2026-01-08 (9mo ago)
Last push4d ago
Watchers5
OwnerUser
Links
- GitHub: github.com/noVibe/DnsConf
- Releases · Issues · Hacker News mentions
README excerpt
🌐 Languages: **English** | **Русский** # DNS Block&Redirect Configurer **Allows to set Redirect and Block rules to your Cloudflare and NextDNS accounts.** **Ready-to-run via GitHub Actions.** Video guide ## Comparison of Free Plans: NextDNS vs Cloudflare | | NextDNS | Cloudflare | |----------------------------------|-----------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------| | **DNS Query Limit** | 300,000 per month | 100,000 per day | | **Billing information required** | No | Yes | | **IPv4 Restrictions** | DNS queries are limited to a single IP address (can be changed) | DNS queries are strictly limited to a single IP address (automatically assigned by Cloudflare and cannot be changed) | | **DoH / DoT / IPv6** | Unlimited | Unlimited | | **Setup API Limits** | 60 requests per minute | Unlimited | | **General Limitations** | None | Infrastructure is blocked by Roskomnadzor (availability issues in Russia) | | **Advantages** | Built-in ad and tracker blocking options | More reliable and fast infrastructure | In summary: - If you are located in Russia, **NextDNS** is your only viable option due to Roskomnadzor restrictions. - If you are in other country than Russia, and you're ok with a credit card gate, **Cloudflare** offers more generous limits on the free plan. Tracker and ad blocking can also be enabled by providing a domain blocklist in `BLOCK`, for example: https://small.oisd.nl/domainswild2 ## Easy Setup Use the configurator https://dns-conf-ui.vercel.app in **Quick** mode. It will automatically configure your DNS profile and perform all required GitHub setup steps. You only need to sign in with GitHub and provide **CLIENT_ID** and **AUTH_SECRET**. More details on where to find these values here: Setup credentials ## Standard Setup Set up credentials Set up profile Set up data sources Set up exclude redirects (optional) Set up a DNS donor Multiple profiles setup GitHub Actions setup --- ## Set up credentials ### NextDNS credentials setup 1) Generate an **API KEY** from https://my.nextdns.io/account and set it as an **environment variable** `AUTH_SECRET` 2) Click on **NextDNS** logo. On the opened page, copy ID from Endpoints section. Set it as **environment variable** `CLIENT_ID` ### Cloudflare credentials setup 1) After signing up into a **Cloudflare**, navigate to _Zero Trust_ tab and create an account. 2) Create a **Cloudflare API token**, from https://dash.cloudflare.com/profile/api-tokens with 2 permissions: Account.Zero Trust : Edit Account.Account Firewall Access Rules : Edit Set API token to **environment variable** `AUTH_SECRET` 3) Get your **Account ID** from : https://dash.cloudflare.com/?to=/:account/workers Set **Account ID** to **environment variable** `CLIENT_ID` --- ## Set up profile Set **environment variable** `DNS` with DNS provider name (**Cloudflare** or **NextDNS**) --- ## Set up data