Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/opsxcq/docker-dnsmasq
https://github.com/opsxcq/docker-dnsmasq
container dns dns-server dnsmasq docker
Last synced: 14 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/opsxcq/docker-dnsmasq
- Owner: opsxcq
- License: gpl-3.0
- Created: 2017-01-14T01:38:41.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2020-05-19T12:56:59.000Z (over 4 years ago)
- Last Synced: 2024-08-01T17:22:49.674Z (3 months ago)
- Topics: container, dns, dns-server, dnsmasq, docker
- Language: Dockerfile
- Size: 19.5 KB
- Stars: 33
- Watchers: 2
- Forks: 11
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Docker DNSMASQ
[](https://hub.docker.com/r/strm/dnsmasq/)
Dnsmasq is a lightweight, easy to configure, DNS forwarder and DHCP server. It is designed to provide DNS and optionally, DHCP, to a small network. It can serve the names of local machines which are not in the global DNS. The DHCP server integrates with the DNS server and allows machines with DHCP-allocated addresses to appear in the DNS with names configured either in each host or in a central configuration file. Dnsmasq supports static and dynamic DHCP leases and BOOTP/TFTP for network booting of diskless machines.
# Example in a docker-compose
Here is a `docker-compose.yml` file that run a local dns server using this image. You can adapt it for your own needs as you wish.
```yaml
version: '2'
services:
dns:
restart: always
image: strm/dnsmasq
volumes:
- ./dnsmasq.conf:/etc/dnsmasq.conf
ports:
- "53:53/udp"
cap_add:
- NET_ADMIN
```
# Deploy with ansible demo playbook
Is possible to deploy with ansible using [this
role](https://github.com/opsxcq/ansible-role-linux-server) to create a complete
Debian buster setup with docker and everything else that you may need.
```yaml
- hosts: all
vars:
hostname: "my_dns_server"
domain: "strm.sh"
network:
ip: "192.168.0.9"
gateway: "192.168.0.1"
dns: "8.8.8.8"
github_user: opsxcq
tasks:
- name: "Network | Create DNS container"
copy:
dest: /config/dnsmasq.conf
content: |
#log all dns queries
log-queries
#dont use hosts nameservers
no-resolv
#use google as default nameservers
server=8.8.4.4
server=8.8.8.8
#explicitly define host-ip mappings
address=/server/10.1.1.2
address=/server/10.1.1.2
- name: "Network | Create DNS container"
docker_container:
name: dns
image: strm/dnsmasq
restart_policy: unless-stopped
ports:
- "53:53/tcp"
- "53:53/udp"
entrypoint:
- dnsmasq
- "-d"
volumes:
- /config/dnsmasq.conf:/etc/dnsmasq.conf
capabilities:
- NET_ADMIN
roles:
- opsxcq.linux_server
```
# Configuration Example
To be able to run the above example, you will need a configuration file. This is a very basic example that has two hosts, but it serve our purpose.
```
#log all dns queries
log-queries
#dont use hosts nameservers
no-resolv
#use google as default nameservers
server=8.8.4.4
server=8.8.8.8
#explicitly define host-ip mappings
address=/router/10.1.1.1
address=/server/10.1.1.2
```