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.
Each release contains a RPM and DEB package.
- Download the latest package 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
- Download the latest release compatible with your system
- Download and edit the configuration file
- Launch the database migration with
sacrebleu-dns -sqlmigrate -config [config path].ini - Download and edit the systemd service and put it in
/lib/systemd/system/ - Start the service
systemctl start sacrebleu-dns
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
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) |
- 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
- Recursive wildcard for reverse DNS (IPv4 part)
- Generate dynamic reverse DNS (IPv4 part)
- XFR
- DNSSEC
- Unit tests
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent