# WAN IP Guard

Bewaakt het publieke WAN IP en update automatisch DNS records bij wijziging, plus WhatsApp notificatie.

## Wat doet het?

- Controleert elke 5 minuten het publieke WAN IP
- Bij wijziging:
  - Updatet A-records via de DirectAdmin API
  - Stuurt een WhatsApp notificatie naar de admin
- Draait als systemd timer

## Installatie

### 1. Clone op je server

```bash
cd ~
git clone <jouw-repo-url> wan-ip-guard
cd wan-ip-guard
```

### 2. Configureer

```bash
cp .env.example .env
# Edit .env met je credentials
nano .env
```

### 3. Installeer dependencies

```bash
npm install --omit=dev
```

### 4. Systemd setup

```bash
# State directory
sudo mkdir -p /var/lib/wan-ip-guard
sudo chown $USER:$USER /var/lib/wan-ip-guard

# Pas de paden in systemd/*.service aan naar jouw setup
# (gebruiker, WorkingDirectory, ExecStart, EnvironmentFile)

# Systemd units
sudo cp systemd/wan-ip-guard.service /etc/systemd/system/
sudo cp systemd/wan-ip-guard.timer /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now wan-ip-guard.timer
```

## Configuratie (.env)

| Variabele | Beschrijving | Voorbeeld |
|-----------|-------------|-----------|
| `DA_LOGIN_KEY` | DirectAdmin Login Key | `your_login_key` |
| `DA_USERNAME` | DirectAdmin gebruiker | `your_username` |
| `DA_BASE_URL` | DirectAdmin base URL | `https://panel.example.com:2222` |
| `DA_DOMAIN` | Domeinnaam | `example.com` |
| `WHATSAPP_API_ENDPOINT` | wwebjs-api URL | `http://localhost:3001` |
| `WHATSAPP_SESSION` | WhatsApp sessie naam | `your_session` |
| `ADMIN_PHONE` | Admin telefoonnummer | `31600000000` |
| `DNS_RECORDS` | Komma-gescheiden records | `example.com,git,www` |
| `STATE_FILE` | Pad naar state file | `/var/lib/wan-ip-guard/current_ip` |

## DirectAdmin Login Key aanmaken

1. Log in op het DirectAdmin panel
2. Ga naar **Accountbeheer** → **Login Keys**
3. Maak een nieuwe key aan met rechten voor **DNS Control**
4. Sla de key op (het wordt maar één keer getoond)

## Beheer

```bash
# Timer status
systemctl status wan-ip-guard.timer

# Logs volgen
journalctl -u wan-ip-guard -f

# Handmatig draaien
cd ~/wan-ip-guard && node index.js

# Timer herstarten
sudo systemctl restart wan-ip-guard.timer

# State bestand resetten (forceer update bij volgende run)
rm /var/lib/wan-ip-guard/current_ip
```

## Hoe het werkt

1. **IP detectie:** Haalt het WAN IP op via `ifconfig.me` met fallback naar `api.ipify.org` en `icanhazip.com`
2. **State vergelijking:** Vergelijkt met het laatst opgeslagen IP in de state file
3. **DNS update:** Voor elke record: verwijder oud A-record + voeg nieuw A-record toe via DirectAdmin API. Per-record foutafhandeling — één falende record blokkeert de rest niet.
4. **State persist:** Het nieuwe IP wordt pas opgeslagen als **alle** DNS-updates gelukt zijn. Bij gedeeltelijke mislukking retried de volgende timer-run.
5. **Notificatie:** Stuurt WhatsApp bericht met oud/nieuw IP en status per record.

## Files

```
wan-ip-guard/
├── index.js             # Hoofdscript
├── package.json
├── .env.example         # Config template
├── deploy.sh            # Deployment script
├── systemd/
│   ├── wan-ip-guard.service
│   └── wan-ip-guard.timer

```