GeoDNS
Serve different DNS answers by continent, country, or region
Configure GeoDNS on a hosted zone at /organization/dns → open the zone → Geo (?t=geo).
A geo record has a default answer plus optional answers for continents, countries, and regions. Visitors receive the most specific match: an exact state or province, then a region group, then the country, then the continent, then the default.
GeoDNS is available for A, AAAA, CNAME, NAPTR, and SRV. TTL must be 30–60 seconds.
Add a geo record
Open Geo
On the zone page, open the Geo tab → Add geo record.
Name, type, TTL, default
Set the owner (@ or www), type, TTL (30–60), and a default value (required). The default is used when no location rule matches.
Optional location answers
For Continents, Countries, or Regions, pick a place from the dropdown, enter the value (for example an IP), and click Add. Repeat for as many locations as you need. You never type codes such as EU or US-CA.
Save
NodeRings stores the policy and publishes the matching answers. You do not write Lua.
Regions include:
- Region/Groups such as US federal regions, Canada East/West/North, and Asia sub-regions
- States and provinces (US states and Canadian provinces)
Remove a row with the trash icon. The Geo table lists the default plus continent, country, and region answers so you can see the full policy without opening Edit.
Check answers on the map
GeoDNS check is enabled after you have at least one geo record.
Select the geo record, then click a country or region on the map (or use the continent / country / region menus). The result shows the answer that location would receive and which rule matched.
Until a geo record exists, the map and location menus stay disabled.
How a match is chosen
Example: you set a default IP, a Europe IP, a Netherlands IP, and a California IP.
| Visitor location | Answer used |
|---|---|
| California | California (state) |
| Other United States | Default (unless you also set a United States country rule) |
| Netherlands | Netherlands (country) |
| Germany | Europe (continent), if you set Europe and not Germany |
| Anywhere else | Default |
More specific always wins over less specific.
Geo records are separate from ordinary records on the Records tab. LUA used for GeoDNS does not appear as an editable record there.