Cada registro se valida al crearlo o cambiarlo, igual desde el panel, la API, la CLI o el servidor MCP. Un registro rechazado responde 422 invalid con el campo erróneo en field y un mensaje. Consulta Códigos de error.
Tipos admitidos
| Tipo | Contenido | Ejemplo | Admite proxy |
|---|---|---|---|
A | Dirección IPv4 | 203.0.113.10 | Sí |
AAAA | Dirección IPv6 | 2001:db8::10 | Sí |
CNAME | Nombre de host; no puede apuntar a sí mismo | miapp.example.net | Sí |
MX | Nombre del servidor de correo, o . para un MX nulo; necesita priority | mx1.example.net | No |
TXT | Texto sin comillas, hasta 4096 bytes de UTF-8 | v=spf1 include:_spf.example.net -all | No |
NS | Servidor de nombres de un subdominio delegado (no en el apex) | ns1.proveedor.net | No |
SRV | peso puerto destino; necesita priority | 5 5060 sip.example.com | No |
CAA | flags etiqueta "valor" | 0 issue "letsencrypt.org" | No |
Cualquier otro tipo se rechaza: unsupported record type (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA).
Detalles del formato:
A/AAAA: la dirección tiene que corresponder al tipo (una IPv6 que mapea una IPv4 no se acepta comoAAAA). Se guarda en forma canónica.- Los nombres de host (
CNAME,MX,NSy destinosSRV) se guardan en minúsculas y sin el punto final. TXT: escribe el texto sin comillas. Los valores largos se parten automáticamente en cadenas de 255 bytes al publicarse.SRV:pesoypuertovan de 0 a 65535. La prioridad va enpriority, no en el contenido.CAA:flagsva de 0 a 255 y la etiqueta no distingue mayúsculas; si dejas el valor sin comillas, se le añaden.
Nombres
@o un nombre vacío es el apex. Un nombre relativo (www) se completa con la zona. Un nombre que termina en punto se toma como completo y tiene que estar dentro de la zona.- Etiquetas: letras, cifras,
-y_, hasta 63 caracteres cada una y 253 en total. Los nombres se guardan en minúsculas. - Una etiqueta
*al principio crea un comodín (*.example.com). Los comodines y los nombres con_no admiten proxy.
TTL
| Valor | |
|---|---|
| Permitido | De 60 a 86 400 segundos |
| Por defecto, si no se indica | 3600 segundos |
| Nombres con proxy | Se publican con un TTL corto que gestiona OpenWAF (aparece como Auto); el TTL que pongas se guarda para cuando quites el proxy |
Prioridad
Los registros MX y SRV necesitan una priority entre 0 y 65 535. Los demás tipos no pueden tenerla (only MX and SRV records have a priority).
Comentarios y etiquetas
Los registros pueden llevar un comment (hasta 100 caracteres, sin caracteres de control) y hasta 10 tags (de 1 a 32 caracteres de a-z, 0-9, :, _ y -, empezando por letra o cifra; se guardan en minúsculas y sin duplicados). Se versionan con la zona pero nunca se publican en el DNS.
Reglas de convivencia
Los registros de un mismo nombre tienen que encajar entre sí. Estas reglas se comprueban en cada cambio y, en un lote, sobre el estado final de cada nombre:
| Regla | Mensaje de error |
|---|---|
| No hay dos registros idénticos (mismo tipo, contenido y prioridad) | an identical … record already exists at … |
Un solo CNAME por nombre | … already has a CNAME record |
Un CNAME nunca junto a A/AAAA | a CNAME cannot coexist with A/AAAA records at … |
Fuera del apex, un CNAME sin proxy está solo en su nombre | an unproxied CNAME must be the only record at … |
Un nombre delegado con NS no tiene otros registros | … is delegated with NS records; it cannot hold other records |
Todos los A, AAAA y CNAME de un nombre comparten el estado del proxy | all A, AAAA and CNAME records at … must have the same proxied value |
En el apex, un CNAME sin proxy se publica como alias (OpenWAF resuelve el destino y responde con sus direcciones), así que puede convivir con registros MX, TXT y CAA. Un CNAME con proxy puede compartir nombre con MX, TXT y otros registros que no son de dirección, porque el nombre publica las direcciones del borde.
Gestionados por OpenWAF
- El registro
SOAy losNSdel apex (tu pareja de servidores de nombres) los gestiona OpenWAF y no se pueden crear ni editar (the zone apex NS records are the assigned pair and cannot be edited). - En una zona externa solo se aceptan registros
A,AAAAyCNAMEcon proxy.