Skip to content

theforeman/smart_proxy_dns_dnsmasq

Repository files navigation

Dnsmasq Smart Proxy plugin

This plugin adds a new DNS provider for managing records in dnsmasq.

Installation

See How_to_Install_a_Smart-Proxy_Plugin for how to install Smart Proxy plugins

This plugin is compatible with Smart Proxy 1.15 or higher.

Configuration

To enable this DNS provider, edit /etc/foreman-proxy/settings.d/dns.yml and set:

:use_provider: dns_dnsmasq

Configuration options for this plugin are in /etc/foreman-proxy/settings.d/dns_dnsmasq.yml and include:

  • backend (optional): The backend to use, currently implemented ones are; openwrt, and default
  • config_path: The path to the configuration file.
  • reload_cmd: The command to use for reloading the dnsmasq configuration.
  • dns_ttl: The TTL values for the DNS data. (currently unused)

For best results, config_path should point to a file in a dnsmasq conf-dir which only the smart-proxy accesses.

NB: The openwrt backend uses the UCI configuration files, which for the moment don't support IPv6 entries.

Contributing

Fork and send a Pull Request. Thanks!

Copyright

Copyright (c) 2017 Alexander Olofsson

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.