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

112 lines
3.2 KiB
Markdown

# 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](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](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](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:
```bash
# 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:
- [OpenWRT Forum](https://forum.openwrt.org/)
- [AdGuard Home Documentation](https://github.com/AdguardTeam/AdGuardHome/wiki)
## License
Feel free to use and modify for your own network setup.