Skip to content

sudo-Tiz/dns-tester-go

Repository files navigation

DNS Tester GO

release Go version docker release semantic-release beta

High-performance DNS testing tool supporting UDP, TCP, DoT, DoH, and DoQ protocols.

⚠️ Beta Status: This project is under active development. Bugs and breaking changes may occur. Contributions and feedback are highly encouraged!

📖 Documentation | 🚀 Quick Start | 🛠️ Installation | 💻 CLI Guide | 📡 API Reference | ⚡ Benchmarks (coming soon)

🚀 Quick Start

# Docker (recommended)
docker compose up -d

# CLI
go install github.com/sudo-Tiz/dns-tester-go/cmd/dnstestergo@latest
dnstestergo query example.com quic://dns.adguard-dns.com:853

# Using Makefile
make build        # Build binaries
make test         # Run tests
make docker-dev   # Start Docker stack

For detailed installation, usage, configuration, and API documentation, see the documentation.

🤖 Documentation is partially generated using AI agents and may contain errors.

🤝 Contributing

We welcome contributions! This is a beta project and your help is valuable:

  • 🐛 Report bugs via GitHub Issues
  • 💡 Suggest features or improvements
  • 📖 Improve documentation
  • 🔧 Submit pull requests

See Contributing Guide.

📋 Roadmap

See TODO.md for upcoming features and improvements.

📝 License

See LICENSE file for details.

🙏 Credits

This project is a complete Go rewrite of DNS-Tester.

Special thanks to @dmachard for the original Python implementation and design inspiration.


Documentation | Issues | Releases | TODO