[🇬🇧 English version](README.md)

# IONOS DDNS Auto-Updater & Creator

Usługa systemowa w Pythonie, która automatycznie aktualizuje rekordy DNS w IONOS.  
W przeciwieństwie do standardowych skryptów DDNS, to rozwiązanie używa **IONOS REST API**, dzięki czemu potrafi:

1. **Aktualizować** istniejące rekordy DNS.  
2. **Tworzyć** nowe rekordy DNS automatycznie, jeśli nie istnieją.  
3. Sprawdzać aktualną wartość DNS przed aktualizacją, aby unikać limitów API.

---

## Funkcje

- **Inteligentne sprawdzanie:** porównuje publiczne IP z aktualnym rekordem DNS przed wysłaniem zapytania do API.  
- **Auto-wykrywanie strefy:** automatycznie ustala, do której strefy DNS należy dana domena/subdomena.  
- **Usługa systemowa:** działa jako usługa `systemd` z automatycznym restartem po błędzie.  
- **Logowanie:** szczegółowe logi w `/var/log/ionos-ddns.log`.

---

## Wymagania

- Python 3  
- Konto IONOS z dostępem do **Developer API**  
- Klucz API (Prefix + Secret) wygenerowany na:  
  https://developer.hosting.ionos.com/

---

## Instalacja

### 1. Sklonuj repozytorium do `/opt`

Zalecana lokalizacja systemowa:

```bash
sudo mkdir -p /opt/ionos-ddns
cd /opt
sudo git clone https://git.invelio.co.uk/rafal/ionos-ddns.git
cd /opt/ionos-ddns
```