unixvoid/blackhole repository overview

Github: https://github.com/unixvoid/blackhole⁠

⁠Blackhole

Blackhole is a DNS blackhole written in golang. The main point of this project is to be a small(statically compiled), portable binary with available container options if needed.

⁠Running blackhole

There are 3 main ways to run blackhole:

1. Docker: we have cryodns pre-packaged over on the dockerhub⁠, go grab the latest and run: docker run -dp 53:53 unixvoid/blackhole. This will now expose port 53 on the host running the blackhole.

2. ACI/rkt: we have public rkt images hosted on the site! check them out here⁠ or go give us a fetch for 64bit machines! rkt fetch unixvoid.com/blackhole. This image can be run with rkt or you can grab our handy service file⁠

3. From Source: Are we not compiled for your architecture? Wanna hack on the source? Lets bulid and deploy:
   make dependencies
make run
   If you want to build a docker use: make docker
   If you want to build an ACI use: make aci

⁠Configuration

The configuration is very straightforward, we can take a look at the default config file and break it down.

[blackhole]								# this section is the start of the servers main config.
	loglevel		= "debug"			# loglevel, this can be [debug, cluster, info, error]
	dnsport			= 53				# port for DNS listener to bind to

[redis]									# this section is the start of redis configurations
	useredis		= false				# weather or not to use redis at all
	host			= "localhost:6379"	# address and port of the redis server to be used
	password		= ""				# password for the redis server