netcup-dns/README.md
2023-08-13 17:42:26 +02:00

73 lines
1.7 KiB
Markdown

# netcup-dns
Update DNS A/AAAA records with your current external IP address using the netcup DNS API.
## Installation
On Arch Linux:
```shell
make
```
With `pip`:
```shell
make install-pip
```
## Configuration
For each netcup customer, create a `.json` configuration file inside `/etc/netcup-dpns`.
There is an [example configuration](cfg/example.json).
## Usage
```
usage: netcup-dns [-h] [--config-directory CFG_DIR]
[--cache-directory CACHE_DIR]
[--cache-validity-seconds CACHE_VALIDITY_SECONDS]
Update DNS A/AAAA records with your current external IP address using the
netcup DNS API.
options:
-h, --help show this help message and exit
--config-directory CFG_DIR
Path to directory where `.json` config files reside.
--cache-directory CACHE_DIR
Path to cache directory. Retrieved and updated DNS
records are cached there.
--cache-validity-seconds CACHE_VALIDITY_SECONDS
Value in seconds for how long cached DNS records are
valid. Set to `0` to disable caching.
```
## TODOs
API backend:
- Currently: nc-dnsapi
- Alternatives:
- https://github.com/johndoe31415/dnssync_nc
Alternative external IP detection:
```python
def external_ip_upnp():
"""
https://stackoverflow.com/a/41385033
Didn't work for me. Even after double checking fritz.box settings:
fritz.box > Heimnetz > Netzwerk > Statusinformationen über UPnP übertragen
"""
import miniupnpc
u = miniupnpc.UPnP()
u.discoverdelay = 1000
u.discover()
u.selectigd()
print('external ip address: {}'.format(u.externalipaddress()))
```