Files
proxy/nodejs/utils/dns_records.js
T
wmantly a2d194f855 Add dynamic DNS: keep A records pointed at the current public IP
For deployments on WAN DHCP, operators can declare A records in the DNS section
that the app updates to this box's current public IP every 4 hours (and
immediately on create).

- utils/public_ip.js: getPublicIp() queries external echo services (ipify +
  fallbacks, configurable) with pure isIPv4/extractIp helpers.
- utils/dns_records.js: pure planARecordUpdate() reconciliation decision.
- models/dns_provider.js: Domain.upsertARecord(name, ip) — provider-agnostic
  upsert via getRecords + deleteRecordById + createRecord (createRecord alone is
  not a reliable cross-provider upsert). Apex ('@') handling added to each
  provider (CloudFlare uses the domain name, Porkbun an empty name, DigitalOcean
  '@') via a new DnsApi.apexName().
- models/dynamic_record.js: DynamicRecord model (deterministic id per host,
  apply()/refreshAll()), registered + ModelPs-wrapped for live UI updates.
- services/dynamic_dns.js + conf: 4h scheduler mirroring host_scheduler.
- routes/dns.js: /dynamic CRUD + /dynamic/ip, gated to domain managers/admins.
- views/dns.ejs: "Dynamic A Records (WAN IP)" card with add form + list.
- test/unit/dynamic_record.test.js: public-IP parsing + reconciliation logic.

Verified end-to-end against a live Porkbun domain (create, idempotent, IP-change,
cleanup) plus unit suite (111 pass).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-10 23:55:56 -04:00

22 lines
852 B
JavaScript

'use strict';
// Pure DNS-record reconciliation logic, kept out of models/dns_provider.js so it
// can be unit-tested without a redis connection. Used by Domain.upsertARecord.
/**
* Decide how to reconcile an A record to `ip`, given the domain's current A
* records (as returned by a provider's getRecords: {id, name, data}) and the
* target sub-name (`''` for apex).
*
* Returns {deleteIds: [...], create: bool}: delete every same-name A record whose
* value differs, and create a new one unless a correct one already exists.
*/
function planARecordUpdate(aRecords, sub, ip){
let matches = (aRecords || []).filter(r => (r.name || '') === sub);
let correct = matches.some(r => r.data === ip);
let deleteIds = matches.filter(r => r.data !== ip).map(r => r.id);
return {deleteIds, create: !correct};
}
module.exports = {planARecordUpdate};