lukas/DynuIPRefresher
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
127 Commits 3 Branches 9 Tags 663 KiB
C++ 60.4%
CMake 36.9%
Dockerfile 2.7%
81de98bf6c
Go to file
lukas 81de98bf6c rename Version.h to StaticData.h 
new temp file path for windows and linux
temp file now writeable on windows
compare string find method with SIZE_MAX instead of ULONG_MAX
2020-05-26 16:51:29 +02:00
config renamed service-binarayname and config file name to dynuiprefresher 2020-05-21 11:52:55 +02:00
docs doxygen docu support 2019-10-27 13:41:40 +01:00
inc everywhere same code header 2020-05-08 16:45:27 +02:00
service renamed service-binarayname and config file name to dynuiprefresher 2020-05-21 11:52:55 +02:00
src rename Version.h to StaticData.h 2020-05-26 16:51:29 +02:00
tests rename Version.h to StaticData.h 2020-05-26 16:51:29 +02:00
.gitignore readded intellij workspace files 2019-05-08 19:56:43 +02:00
.gitlab-ci.yml right naming in gitlab ci 2020-05-21 14:27:16 +02:00
CMakeLists.txt rename Version.h to StaticData.h 2020-05-26 16:51:29 +02:00
README.md some minor renamings 2020-05-21 14:09:17 +02:00

README.md

pipeline status

DynuIPRefresher

A lightweight C++ application to setup a service for refreshing a dynamic IP to the Dynu servers. Dynu.com is a free DDns service and provides an API.

Installation

Download the latest Release at Release_Page. I'm providing executables for Debian/Ubuntu (.deb) and RHEL/Debian (.rpm). But you can still compile the code my your own (see build section).

Configuration

There is a configuration file /etc/dynuiprefresher.cfg where you have to specify the DYNU API key (get it from their homepage), the domainid and your domain. Furthermore, you can optionally specify a Telegram API key and a Chat ID if you want to be notfied when your local ip changes.

To enable and start the service: systemctl enable dynuiprefresher.service and systemctl start dynuiprefresher.service

Usage

First of all configure the right keys in the /etc/dynuiprefresher.cfg or %appdata%\DynuIpRefresher\dynuiprefresher.cfg config file.

Afterwards use the following options:

help page: 
[-h] [--help]  print this help page
[-v] [--version] print the software version
[-f] [--force] force refresh of ip
[-l] [--loop] infinite loop to refresh ip every five minutes
[-c] [--checkconfig] validate configuration
[-ip] [--currentip] get current global ip
[no argument] normal ip check and refresh

Build

Basic Build

Download source files

git clone https://github.com/Lukas-Heiligenbrunner/DynuIPRefresher.git

install build dependencies

libcurl libconfig

Debian:

apt install libcurl4-openssl-dev

Fedora:

dnf install libcurl-devel libconfig-devel

Alpine Linux:

Compiler dependencies:

apk add make cmake g++

Lib dependencies:

apk add libcurl curl-dev libconfig libconfig-dev

Packaging dependencies:

apk add dpkg rpm

dependencies for package build

dpkg --> debian/ubuntu package

rpmbuild --> Fedora/RedHat/CentOS package

cmake project

cd into downloaded files and Generate makefiles:

cmake -S . -B build

compile project

make

[root] install it to the system

make install

(optional) create Linux packages

make package

Windows cross build

Set Winbuild flag in CMakeList.txt.

Dependencies:

  • MinGW Compiler
  • MinGW-libcurl
  • MinGW-libconfig++

Optional dependencies

  • NSIS Pack tool (for creating installer)
  • doxygen (for generating html doc)

Some addition configuration of lib paths may be needed in CMakeList.txt. make package will pack it into a NSIS installer for Windows.