https://github.com/outout14/sacrebleu-dns
DNS server made in Go with SQL & Redis backend.
https://github.com/outout14/sacrebleu-dns
dns go golang redis reverse-dns sql wildcard
Last synced: 2 months ago
JSON representation
DNS server made in Go with SQL & Redis backend.
- Host: GitHub
- URL: https://github.com/outout14/sacrebleu-dns
- Owner: outout14
- License: other
- Created: 2020-12-07T21:53:33.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2022-06-05T19:32:17.000Z (about 4 years ago)
- Last Synced: 2024-06-19T09:12:57.344Z (almost 2 years ago)
- Topics: dns, go, golang, redis, reverse-dns, sql, wildcard
- Language: Go
- Homepage:
- Size: 75.2 KB
- Stars: 14
- Watchers: 1
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Sacrebleu
[](https://app.fossa.com/projects/git%2Bgithub.com%2Foutout14%2Fsacrebleu-dns?ref=badge_shield) [](https://deepsource.io/gh/outout14/sacrebleu-dns/?ref=repository-badge) [](https://github.com/outout14/sacrebleu-dns/actions?query=workflow%3ARelease) [](https://github.com/outout14/sacrebleu-dns/actions?query=workflow%3AGo)
Sacrebleu is a DNS authoritative nameserver made in Go with ``github.com/miekg/dns`` library.
Records are stored in a SQL Database and cached using Redis.
This software requires a SQL server and a Redis server.
This software is currently in development and NOT ready for production.
## Installation
### Automated install
Each release contains a RPM and DEB package.
- [Download the latest package](https://github.com/outout14/sacrebleu-dns/releases/latest) compatible with your system
- Edit the config file in ``/etc/sacrebleu/config-dns.ini``
- Launch the database migration with ``sacrebleu-dns -sqlmigrate -config /etc/sacrebleu/config-dns.ini``
- Start the service ``systemctl start sacrebleu-dns``
### Manual Install
- [Download the latest release](https://github.com/outout14/sacrebleu-dns/releases/latest) compatible with your system
- [Download](https://raw.githubusercontent.com/outout14/sacrebleu-dns/main/extra/config.ini.example) and edit the configuration file
- Launch the database migration with ``sacrebleu-dns -sqlmigrate -config [config path].ini``
- [Download](https://raw.githubusercontent.com/outout14/sacrebleu-dns/main/extra/sacrebleu-dns.service) and edit the systemd service and put it in ``/lib/systemd/system/``
- Start the service ``systemctl start sacrebleu-dns``
## Arguments
You can show theses informations using ``./sacrebleu-dns -h``.
```
-config string
the patch to the config file (default "extra/config.ini.example")
-sqlmigrate
initialize / migrate the database
```
## Configuration
Variables names are case sensitives.
|Variable name|Type|Example|Informations|
|--|--|--|--|
| app_mode | string|``"production"``|Anything different than ``production`` will show debug messages
| App | Section |
|IP|string|``":"``|IP address on which the DNS server must listen. Blank to listen on all IPs
|Port|int|``5353``|Port on which the DNS server must listen
|Logfile|bool|``true``|Enable or disable file logs.
|Logdir|string|``/var/log``|Log file directory.
|Database|Section|
|Type|string|``"postgresql"``|SQL Database type. ``"postgresql"`` or ``"mysql"`` (anything different than ``"postgresql"`` will rollback to ``"mysql"``)
|Host|string|``"127.0.0.1"`` ``"/var/run/postgres"``|Can be either an IP or a path to a socket for Postgres
|Username|string|``"sacrebleu"``|SQL Database Username
|Password|string|``"superSecretPassword"``|SQL Database Password (optional)
|Port|string|``"5432"``|SQL Database port (``"5432"`` for postgres or ``"3306"`` for MySQL by default)
|DB|string|``"sacrebleudatabase"``|SQL Database Name
|Redis|Section
|IP|string|``"127.0.0.1"``|Redis Database IP
|Password|string|``""``|Redis Database Password
|Port|int|``6379``|Redis Database port
|DB|int|``0``|Redis Database ID
|TTL|int|``10``|Redis Time To Live (in seconds)
|DNS|Section
|XfrIPs|[]string|``*,192.0.2.9,192.0.2.98``|Allowed IPs for XFR transfer (``*`` for any)
## What is working
- Read records (stricts & wildcard) from MySQL
- Read and write records (stricts & wildcard) in Redis
- Recursive wildcard for reverse DNS (IPv6 only)
- Generate dynamic reverse DNS (IPv6 only)
- Respond to all requested MySQL queries
## ToDo
- Recursive wildcard for reverse DNS (IPv4 part)
- Generate dynamic reverse DNS (IPv4 part)
- XFR
- DNSSEC
- Unit tests
## License
[](https://app.fossa.com/projects/git%2Bgithub.com%2Foutout14%2Fsacrebleu-dns?ref=badge_large)