mario-dns/README.md

45 lines
1.3 KiB
Markdown

# Mario DNS tool
[![Download Mario DNS tool](https://a.fsdn.com/con/app/sf-download-button)](https://sourceforge.net/projects/mario-dns/files/latest/download)
Tool for resolving domain names with web interface and API. Meshname / meship supported.
C++, Qt5
### For what?
The main use of the tool is to translate IPv6 addresses to meship domains for use in services without IPv6 support. Meship (and meshname) domains are resolved by [meshnamed](https://github.com/zhoreeq/meshname).
Also, the tool can be used as a supplement to projects that need to resolve domain names to addresses with some API. Mario DNS provides API with output in JSON format:
```
# Request:
dns.acetone.ygg
# Answer:
{
"status": true,
"answer": [
"324:71e:281a:9ed3::53"
]
}
```
You can use `version` request for version information.
To use the API, send a domain or address to a socket without additional headers.
### How to start
Pass address and port to bind via parameters:
```
./mario-dns 192.168.0.1 5000
```
Several options are supported, which must be specified after the port:
- `--no-api` disable API access (only HTTP mode for web browser);
- `--no-http` disable HTTP access (only API mode);
- `--no-resolve` disable DNS resolving (only meship domains);
- `--no-favicon` disable web page favicon (-135KB for faster loading).