Files
openwrt-adguard-setup/README.md
jessikitty 2e6fd4b396 Update IP configuration and add network topology
Changes:
- OpenWRT is now main gateway at 10.0.0.254 (was 10.0.0.246)
- Added TP-Link AX72 Pro as AP at 10.0.0.246
- Added dual DNS configuration (10.0.0.245 filtered, 10.0.0.254 unfiltered)
- Added network topology diagram
- Added advanced DHCP options to features list
- Updated description to reflect OpenWRT as main gateway
2025-12-15 11:20:32 +11:00

3.2 KiB

OpenWRT and AdGuard Home Configuration Guide

Complete setup guide for configuring OpenWRT router with AdGuard Home DNS filtering and device access control.

Network Configuration

Target Setup:

  • OpenWRT Router (Main Gateway): 10.0.0.254
  • AdGuard Home DNS: 10.0.0.245
  • TP-Link Archer AX72 Pro (AP Mode): 10.0.0.246
  • DHCP Range: 10.0.0.1 - 10.0.0.200
  • DNS Options: 10.0.0.245 (filtered), 10.0.0.254 (unfiltered)

Files in this Repository

📖 openwrt-adguard-setup.md

Comprehensive configuration guide covering:

  • Initial OpenWRT setup and network configuration
  • DHCP server configuration with static leases
  • Advanced DHCP options (dual DNS, boot options, NTP, etc.)
  • Custom DNS settings per client
  • Multiple access control methods
  • AdGuard Home installation and configuration
  • TP-Link AX72 Pro WiFi 6 AP configuration
  • Integration and testing procedures
  • Troubleshooting and maintenance

🛡️ device-control.sh

Bash script for easy device access management:

  • Block/unblock devices from internet access
  • List all currently blocked devices
  • Check device blocking status
  • View action logs
  • Simple command-line interface

setup-checklist.md

Step-by-step checklist with:

  • Pre-setup information gathering
  • Phase-by-phase setup tracking
  • Testing procedures
  • Backup creation steps
  • Maintenance schedule
  • Troubleshooting quick reference

Quick Start

  1. Follow the setup-checklist.md for a guided setup process
  2. Refer to openwrt-adguard-setup.md for detailed explanations
  3. Deploy device-control.sh to your OpenWRT router for easy device management

Features

DHCP server with customizable range
Static IP assignment for critical devices
Dual DNS configuration (filtered + unfiltered)
Per-client DNS server configuration
Device-level internet access control
AdGuard Home DNS filtering and ad-blocking
Local DNS name resolution
Comprehensive logging and monitoring
Advanced DHCP options (NTP, boot options, static routes)

Network Topology

Cable Modem
    ↓
OpenWRT Router (10.0.0.254) - Main Gateway, DHCP, Firewall
    ↓
AdGuard Home (10.0.0.245) - DNS Filtering
    ↓
TP-Link AX72 Pro (10.0.0.246) - WiFi 6 Access Point
    ↓
Devices (10.0.0.1-200)

Device Access Control

Simple commands to manage device access:

# Block a device
./device-control.sh block 10.0.0.100 "Kids Tablet"

# Unblock a device
./device-control.sh unblock 10.0.0.100

# List all blocked devices
./device-control.sh list

# Check device status
./device-control.sh status 10.0.0.100

Prerequisites

  • OpenWRT router (any compatible device)
  • Server/device for AdGuard Home (Docker, Linux, or Windows)
  • TP-Link Archer AX72 Pro (or similar WiFi 6 router for AP mode)
  • Basic networking knowledge
  • SSH access to OpenWRT

Support

Refer to the comprehensive troubleshooting sections in the main guide, or consult:

License

Feel free to use and modify for your own network setup.