From 750f51d911d000417ee4f294d721e71eea04fc23 Mon Sep 17 00:00:00 2001 From: cn Date: Thu, 15 Feb 2018 16:02:33 +0100 Subject: [PATCH] docs: update README and add CHANGELOG --- CHANGELOG.md | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 48 +++++++++++++++++++++++++++++---- 2 files changed, 118 insertions(+), 5 deletions(-) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..65a10eb --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,75 @@ +# Changelog + +## 2.0.0 + +IMPROVEMENTS: + +- Drop Ruby 2.2 and lower support +- Better protocol compliance by returning `badauth` in response body on HTTP 401 errors +- Better code maintainability by refactorings +- Update dependencies, mainly `rack` to new major version 2 + +## 1.6.1 (October 31, 2017) + +IMPROVEMENTS: + +- Fix broken password check affecting all previous releases + +## 1.6.0 (December 7, 2016) + +IMPROVEMENTS: + +- Support providing an IPv6 address in addition to a IPv4 for the same hostname + +## 1.5.0 (November 30, 2016) + +IMPROVEMENTS: + +- Drop Ruby 1.8.7 support +- Pin `json` gem to allow supporting Ruby 1.9.3 +- Support determining effective client IP address also from `X-Real-IP` header + +## 1.4.0 (November 27, 2016) + +IMPROVEMENTS: + +- Pin `rack` gem to allow supporting Ruby versions < 2.2.2 +- Support IPv6 addresses + +## 1.3.0 (October 8, 2013) + +IMPROVEMENTS: + +- Handle `SIGTERM` \*nix signal properly and shutdown the daemon + +## 1.2.2 (June 8, 2013) + +IMPROVEMENTS: + +- Add proper logging to the provided init script for dyndnsd.rb + +## 1.2.1 (June 5, 2013) + +IMPROVEMENTS: + +- Fix bug in previous release related to metrics preventing startup + +## 1.2.0 (May 29, 2013) + +IMPROVEMENTS: + +- Support sending metrics to graphite via undocumented `graphite:` section in configuration file + +## 1.1.0 (April 30, 2013) + +IMPROVEMENTS: + +- Support dropping priviliges on startup, also affects external commands run +- Add [metriks](https://github.com/eric/metriks) support for basic metrics in the process title +- Detach from child processes running external commands to avoid zombie processes + +## 1.0.0 (April 28, 2013) + +NEW FEATURES: + +- Initial 1.0 release diff --git a/README.md b/README.md index 1807214..e7b6a4e 100644 --- a/README.md +++ b/README.md @@ -6,11 +6,13 @@ A small, lightweight and extensible DynDNS server written with Ruby and Rack. ## Description -dyndnsd.rb aims to implement a small [DynDNS-compliant](https://help.dyn.com/remote-access-api/) server in Ruby supporting IPv4 and IPv6 addresses. It has an integrated user and hostname database in it's configuration file that is used for authentication and authorization. Besides talking the DynDNS protocol it is able to invoke an so-called *updater*, a small Ruby module that takes care of supplying the current host => ip mapping to a DNS server. +dyndnsd.rb aims to implement a small [DynDNS-compliant](https://help.dyn.com/remote-access-api/) server in Ruby supporting IPv4 and IPv6 addresses. It has an integrated user and hostname database in it's configuration file that is used for authentication and authorization. Besides talking the DynDNS protocol it is able to invoke a so-called *updater*, a small Ruby module that takes care of supplying the current hostname => ip mapping to a DNS server. -There is currently one updater shipped with dyndnsd.rb `command_with_bind_zone` that writes out a zone file in BIND syntax onto the current system and invokes a user-supplied command afterwards that is assumed to trigger the DNS server (not necessarily BIND since it's zone files are read by other DNS servers too) to reload it's zone configuration. +There is currently one updater shipped with dyndnsd.rb `command_with_bind_zone` that writes out a zone file in BIND syntax onto the current system and invokes a user-supplied command afterwards that is assumed to trigger the DNS server (not necessarily BIND since it's zone files are read by other DNS servers, too) to reload it's zone configuration. -Because of the mechanisms used dyndnsd.rb is known to work only on \*nix systems. +Because of the mechanisms used, dyndnsd.rb is known to work only on \*nix systems. + +See the [changelog](CHANGELOG.md) before upgrading. ## General Usage @@ -101,7 +103,7 @@ Please provide ideas if you are using dyndnsd.rb with other DNS servers :) The update URL you want to tell your clients (humans or scripts ^^) consists of the following - http[s]://[USER]:[PASSWORD]@[DOMAIN]:[PORT]/nic/update?hostname=[HOSTNAMES]&myip=[MYIP] + http[s]://[USER]:[PASSWORD]@[DOMAIN]:[PORT]/nic/update?hostname=[HOSTNAMES]&myip=[MYIP]&myip6=[MYIP6] where: @@ -110,7 +112,8 @@ where: * DOMAIN should match what you defined in your config.yaml as domain but may be anything else when using a webserver as proxy * PORT depends on your (webserver/proxy) settings * HOSTNAMES is a required list of comma separated FQDNs (they all have to end with your config.yaml domain) the user wants to update -* MYIP is optional and the HTTP client's address will be used if missing +* MYIP is optional and the HTTP client's IP address will be used if missing +* MYIP6 is optional but if present also requires presence of MYIP ### IP address determination @@ -130,6 +133,41 @@ Use a webserver as a proxy to handle SSL and/or multiple listen addresses and po The [Debian 6 init.d script](init.d/debian-6-dyndnsd) assumes that dyndnsd.rb is installed into the system ruby (no RVM support) and the config.yaml is at /opt/dyndnsd/config.yaml. Modify to your needs. +### Monitoring + +For monitoring dyndnsd.rb uses the [metriks](https://github.com/eric/metriks) framework and exposes several metrics like the number of unauthenticated requests, requests that did (not) update a hostname, etc. By default the most important metrics are shown in the [proctitle](https://github.com/eric/metriks#proc-title-reporter) but you can also configure a [Graphite](https://graphiteapp.org/) backend for central monitoring. + +```yaml +host: "0.0.0.0" +port: "8245" # the DynDNS.com alternative HTTP port +db: "/opt/dyndnsd/db.json" +domain: "dyn.example.org" +# configure the Graphite backend to be used instead of proctitle +graphite: + host: localhost # defaults for host and port of a carbon server + port: 2003 + prefix: "my.graphite.metrics.naming.structure.dyndnsd" +# configure the updater, here we use command_with_bind_zone, params are updater-specific +updater: + name: "command_with_bind_zone" + params: + zone_file: "dyn.zone" + command: "echo 'Hello'" + ttl: "5m" + dns: "dns.example.org." + email_addr: "admin.example.org." +# user database with hostnames a user is allowed to update +users: + # 'foo' is username, 'secret' the password + foo: + password: "secret" + hosts: + - foo.example.org + - bar.example.org + test: + password: "ihavenohosts" +``` + ## License dyndnsd.rb is licensed under the Apache License, Version 2.0. See LICENSE for more information.