a2d194f855
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>
22 lines
852 B
JavaScript
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};
|