ankurs47/ad-nope repository overview

⁠ad-nope

ad-nope is a high-performance, privacy-focused DNS resolver and ad-blocker written in Rust. It leverages the power of Hickory DNS⁠ to provide a modern, secure DNS gateway for your network.

⁠🚀 Key Features

• Modern Protocols: Supports DNS-over-HTTPS (DoH), DNS-over-TLS (DoT), DNS-over-QUIC (DoQ), and DNS-over-HTTP/3 (DoH3) for secure upstream resolution.
• Ad & Tracker Blocking: Automatically downloads and enforces standard blocklists (e.g., Hagezi's lists) to keep your network clean.
• High Performance: Built on asynchronous Rust (Tokio) with parallel upstream queries and efficient caching using Moka.
• Multi-Arch Support: Official images available for x86_64 and ARM64 (perfect for Raspberry Pi).
• Low Latency: Connection multiplexing and "fastest-wins" parallel querying minimize DNS resolution time.

⁠🐳 Quick Start

Run the latest version with default settings (listens on port 53):

docker run -d \
  --name ad-nope \
  --restart unless-stopped \
  -p 53:5300/udp \
  -p 53:5300/tcp \
  ankurs47/ad-nope:latest

⁠⚙ Configuration

You can customize the behavior by mounting your own config.toml:

docker run -d \
  --name ad-nope \
  -p 53:5300/udp \
  -p 53:5300/tcp \
  -v $(pwd)/my-config.toml:/app/config.toml \
  ankurs47/ad-nope:latest

Check the GitHub repository⁠ for the default configuration template and documentation on upstream server formats and blocklist management.

⁠📜 License

This project is licensed under the MIT License.