Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jczic/MicroDNSSrv
A micro DNS server for MicroPython to simply respond to A queries on multi-domains with or without wildcards (used on Pycom modules & ESP32)
https://github.com/jczic/MicroDNSSrv
captive-portal dns dns-server esp32 hc2 host ip lookup lopy micropython nameserver pycom record resolve wildcard wipy
Last synced: 3 months ago
JSON representation
A micro DNS server for MicroPython to simply respond to A queries on multi-domains with or without wildcards (used on Pycom modules & ESP32)
- Host: GitHub
- URL: https://github.com/jczic/MicroDNSSrv
- Owner: jczic
- License: mit
- Created: 2017-06-04T01:25:12.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-03-07T13:32:33.000Z (over 6 years ago)
- Last Synced: 2024-04-22T12:33:04.021Z (7 months ago)
- Topics: captive-portal, dns, dns-server, esp32, hc2, host, ip, lookup, lopy, micropython, nameserver, pycom, record, resolve, wildcard, wipy
- Language: Python
- Homepage: https://microdnssrv.hc2.fr
- Size: 73.2 KB
- Stars: 68
- Watchers: 4
- Forks: 21
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-micropython-lib - MicroDNSSrv - DNS server for MicroPython to simply respond to A queries on multi-domains (Networking)
- awesome-micropython - MicroDNSSrv - A micro DNS server for MicroPython to simply respond to A queries on multi-domains with or without wildcards (used on Pycom modules & ESP32). (Libraries / Communications)
README
## MicroDNSSrv is a micro DNS server for MicroPython to simply respond to A queries (principally used on ESP32 and [Pycom](http://www.pycom.io) modules)
Very easy to integrate and very light with one file only :
- `"microDNSSrv.py"`
Simple but effective :
- Use it to embed a fast DNS server in yours modules
- Simply responds to A queries (only)
- Use a list of multiple domains
- Include wildcards in the scheme of names
- Use it to make a captive portal simply
### Using *microDNSSrv* main class :
| Name | Function |
| - | - |
| Constructor | `mds = MicroDNSSrv()` |
| Start DNS server | `mds.Start()` |
| Stop DNS server | `mds.Stop()` |
| Check if DNS server is running | `mds.IsStarted()` |
| Set the domain names list | `mds.SetDomainsList(domainsList)` |
### Basic example :
```python
from microDNSSrv import MicroDNSSrv
domainsList = {
"test.com" : "1.1.1.1",
"*test2.com" : "2.2.2.2",
"*google*" : "192.168.4.1",
"*.toto.com" : "192.168.4.1",
"www.site.*" : "192.168.4.1" }
mds = MicroDNSSrv(domainsList)
if mds.Start() :
print("MicroDNSSrv started.")
else :
print("Error to starts MicroDNSSrv...")
```
### Using *microDNSSrv* speedly creation of the class :
```python
from microDNSSrv import MicroDNSSrv
if MicroDNSSrv.Create( {
"test.com" : "1.1.1.1",
"*test2.com" : "2.2.2.2",
"*google*" : "192.168.4.1",
"*.toto.com" : "192.168.4.1",
"www.site.*" : "192.168.4.1" } ) :
print("MicroDNSSrv started.")
else :
print("Error to starts MicroDNSSrv...")
```
### Using for a captive portal :
```python
MicroDNSSrv.Create({ '*' : '192.168.0.254' })
```
- Can be used with [MicroWebSrv](http://microwebsrv.hc2.fr) easily.
### By JC`zic for [HC²](https://www.hc2.fr) ;')
*Keep it simple, stupid* :+1: