A unofficial DDNS-Client for Porkbun domains
Project description
Disclaimer
This package is not related to or developed by Porkbun. No relationship between the developer of this package and Porkbun exists.
All trademarks, logos and brand names are the property of their respective owners. All company, product and service names used in this package are for identification purposes only. Use of these names,trademarks and brands does not imply endorsement.
Porkbun DDNS
porkbun-ddns
is a unofficial DDNS-Client for Porkbun Domains.
This library will only update the records if the IP(s) have changed or the dns entry didn't exist before, it will also set/update A (IPv4) and AAAA (IPv6) records.
Since porkbun-dynamic-dns-python is deprecated I took it into my own hands to code a decent DDNS Client for Porkbun. Inspired by con-f-use pull request, I built a pip Package and a docker container.
As alternative to cert-bun use my lego-certbot image.
Setup on Porkbun
Make sure that any domain you use this client with has API access enabled. See the below picture for reference.
If this is not enabled, you'll see an error about your API keys being invalid, despite them being correct.
CLI
Install via pip
pip install porkbun-ddns
Usage
$ porkbun-ddns -h
usage: porkbun-ddns [-h] [-i [PUBLIC_IPS ...]] [-f FRITZBOX] [-4 | -6] config domain [subdomain]
positional arguments:
config Path to config file
domain Domain to be updated
subdomain Subdomain
options:
-h, --help show this help message and exit
-i [PUBLIC_IPS ...], --public-ips [PUBLIC_IPS ...]
Public IPs (v4 and or v6)
-f FRITZBOX, --fritzbox FRITZBOX
IP or Domain of your Fritz!Box
-4, --ipv4-only Only set/update IPv4 A Records
-6, --ipv6-only Only set/update IPv6 AAAA Records
-v, --verbose Show Debug Output
Examples:
$ porkbun-ddns "./config.json" domain.com my_subdomain
# Multiple subdomains:
$ porkbun-ddns "./config.json" domain.com my_subdomain_1 my_subdomain_2 my_subdomain_3
# Set root and subdomains:
$ porkbun-ddns "./config.json" domain.com @ my_subdomain_1 my_subdomain_2 my_subdomain_3
# Get config from environment variable:
# PORKBUN_APIKEY
# PORKBUN_SECRETAPIKEY
# PORKBUN_DDNS_ENDPOINT (Optional)
$ porkbun-ddns - domain.com my_subdomain
# Set IP's explicit
$ porkbun-ddns "./config.json" domain.com my_subdomain -i '1.2.3.4' '1234:abcd:0:4567::8900'
# Use Fritz!Box to obtain IP's and set IPv4 A Record only
$ porkbun-ddns "./config.json" domain.com my_subdomain -f fritz.box -4
You can set up a cron job get the full path to porkbun-ddns with which porkbun-ddns
, then execute crontab -e
and add the following line:
*/30 * * * * <PORKBUN-DDNS-PATH>/porkbun-ddns "<YOUR-PATH>/config.json" domain.com my.subdomain >/dev/null 2>&1
config.json
example:
{ "endpoint":"https://porkbun.com/api/json/v3",
"apikey": "pk1_xxx",
"secretapikey": "sk1_xxx"
}
Docker compose
version: "3"
services:
porkbun-ddns:
image: "mietzen/porkbun-ddns:latest"
container_name: porkbun-ddns
environment:
DOMAIN: "domain.com" # Your Porkbun domain
SUBDOMAINS: "my_subdomain,my_other_subdomain,my_subsubdomain.my_subdomain" # Subdomains comma spreaded
SECRETAPIKEY: "<YOUR-SECRETAPIKEY>" # Your Porkbun Secret-API-Key
APIKEY: "<YOUR-APIKEY>" # Your Porkbun API-Key
# PUBLIC_IPS: "1.2.3.4,2001:043e::1" # Set if you got static IP's
# FRITZBOX: "192.168.178.1" # Use Fritz!BOX to obtain Public IP's
# SLEEP: "300" # Seconds to sleep between DynDNS runs
# IPV4: "TRUE" # Set IPv4 address
# DEBUG: "FALSE" # DEBUG LOGGING
restart: unless-stopped
You have to use docker run
if you want to use IPv6, see https://github.com/mietzen/porkbun-ddns/issues/34
Docker run
docker run -d \
-e DOMAIN="domain.com" \
-e SUBDOMAINS="my_subdomain,my_other_subdomain,my_subsubdomain.my_subdomain" \
-e SECRETAPIKEY="<YOUR-SECRETAPIKEY>" \
-e APIKEY="<YOUR-APIKEY>" \
-e IPV4="TRUE" \
-e IPV6="TRUE" \
--name porkbun-ddns \
--restart unless-stopped \
mietzen/porkbun-ddns:latest
Python
from porkbun_ddns import PorkbunDDNS
config = {
'secretapikey': 'YOUR-SECRETAPIKEY',
'apikey': 'YOUR-APIKEY'
}
porkbun_ddns = PorkbunDDNS(config, 'domain.com')
# porkbun_ddns = PorkbunDDNS('./config.json', 'domain.com')
# porkbun_ddns_ip = PorkbunDDNS('./config.json', 'domain.com', public_ips=['1.2.3.4','1234:abcd:0:4567::8900'])
# porkbun_ddns_fritz = PorkbunDDNS('./config.json', 'domain.com', fritzbox='fritz.box', ipv6=False)
porkbun_ddns.set_subdomain('my_subdomain')
porkbun_ddns.update_records()
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for porkbun_ddns-0.6.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2650cee74a8ea6d0222bbeef61996b070a33df581dc58c32b3bf938c10c37938 |
|
MD5 | 1cf1171c6536339e2c206f9bf2bdca29 |
|
BLAKE2b-256 | 9000d14b93b22e5454c9144148480742a1ff831cb14ae730083dd4d896a8dda7 |