mortezabahmani/luci-app-adg-dnslookup — explained in plain English
Analysis updated 2026-05-18
Automatically sync AdGuard Home DNS rewrite rules for CDN and cloud provider domains without manual edits.
Route traffic to region-specific servers for services like Google, Microsoft, or Cloudflare on a home router.
Manage and edit large domain category lists from a router's web interface instead of a config file.
Schedule automatic re-syncing of DNS rewrites on a recurring interval.
| mortezabahmani/luci-app-adg-dnslookup | 100/talk_stock | alexcybernetic/playground-ai | |
|---|---|---|---|
| Stars | 2 | 2 | 2 |
| Language | HTML | HTML | HTML |
| Last pushed | — | 2022-03-24 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | moderate | moderate | easy |
| Complexity | 3/5 | 3/5 | 1/5 |
| Audience | ops devops | general | general |
Figures from each repo's GitHub metadata at analysis time.
Requires an OpenWrt router with AdGuard Home already installed and running.
luci-app-adg-dnslookup is a plugin for OpenWrt, the operating system many home and small business routers run on. It adds a page to the router's web control panel, called LuCI, that automates a specific chore for people running AdGuard Home, a DNS-based ad and tracker blocker: keeping a list of domain names pointed at the correct local or region-specific IP addresses. Normally, making sure services like Google, Microsoft, or various CDNs resolve to nearby servers instead of distant ones means either running a separate Python script that calls a lot of APIs, or manually editing configuration files by hand. This plugin replaces both approaches. It looks up the current IP address for each domain you care about using a DNS server of your choosing, then pushes those results straight into AdGuard Home through its own API, so the rewrite rules stay accurate without any file editing. The plugin ships with a dashboard showing how many domains are tracked and when the last sync ran, a live log viewer, and a list manager where you can turn domain categories on or off. It comes preloaded with over 700 domains already grouped into categories like Google, Meta, Microsoft, various CDNs, cloud providers, developer tools, social networks, and streaming services, and you can edit any of these lists yourself. Syncing can be triggered manually or scheduled automatically every one, three, six, or twelve hours, or once a day. Installation is a short set of commands run on the router itself, using either the opkg or apk package manager depending on your OpenWrt version, followed by installing curl as a dependency. Configuration, including the AdGuard Home address and login details, is done either through the LuCI web interface or by editing a small configuration file directly. The project is released under the MIT license.
An OpenWrt router plugin that automatically keeps AdGuard Home's DNS rewrite rules synced to the correct IPs for hundreds of common domains.
Mainly HTML. The stack also includes Lua, Shell, OpenWrt.
MIT license: use, modify, and share freely, including commercially, as long as you keep the copyright notice.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly ops devops.
This repo across BitVibe Labs
Verify against the repo before relying on details.