Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
Fundación MxOS · Documentación de Espejos
Fundación MxOS · Documentación de Espejos
  • Especificación de Negocio y Misión
    • Misión y Soberanía de Infraestructura
    • Modelo de Participación e Incentivos
  • Especificación Funcional
    • Catálogo Modular de Repositorios
    • Especificación de Pineo Granular
    • Tablero de Métricas del Enjambre
  • Especificación Técnica
    • Arquitectura de Distribución sobre IPFS
    • Resolución Inmutable con DNSLink
    • Puente HTTP y Fedora MirrorManager
    • Ingesta de Repositorios y Telemetría
    • Criptografía y Gestión de Llaves IPNS Ed25519
    • Propuesta Técnica: Red Descentralizada de Espejos sobre IPFS para Distribuciones RPM
  • Manuales y Guías
    • Guía del Operador de Nodo Guardián
    • Configuración de Clientes DNF con IPFS
    • Manual de Autonomía Técnica: Hazlo Tú Mismo
  • Hoja de Ruta del Proyecto de Espejos
    • Fase 1: Prueba de Concepto y Publicación Canónica
    • Fase 2: Tablero de Métricas del Enjambre
    • Fase 3: Federación e Integración Upstream
Back to top
View this page

Resolución Inmutable con DNSLink¶

Identificador Técnico: [TECH-003]

Fundamento¶

El direccionamiento directo por CID (ejemplo: /ipfs/bafy...) es inmutable; cualquier cambio en un paquete genera un nuevo CID raíz. Por su parte, el Sistema de Nombres Interplanetario tradicional (IPNS) basado en DHT experimenta una latencia de resolución prohibitiva para las consultas rápidas de metadatos de DNF.

Para solventar esta limitación, el proyecto utiliza DNSLink. DNSLink asocia un registro TXT en el sistema de nombres de dominio convencional con el CID raíz activo de IPFS.

Topología de Registros DNS¶

En los servidores de nombres autoritativos para el dominio mx-os.mx, se definen los siguientes registros:

; Registro raíz del portal de espejos
_dnslink.mirrors.mx-os.mx.      300 IN TXT "dnslink=/ipfs/bafyrei..."

; Registros complementarios para pasarelas públicas
_dnslink.ipfs.mx-os.mx.         300 IN TXT "dnslink=/ipfs/bafyrei..."
_dnslink.gateway.mx-os.mx.      300 IN TXT "dnslink=/ipfs/bafyrei..."

; Subdominios dedicados opcionales para granularidad independiente
_dnslink.fedora.mirrors.mx-os.mx. 300 IN TXT "dnslink=/ipfs/bafyfed..."
_dnslink.centos.mirrors.mx-os.mx. 300 IN TXT "dnslink=/ipfs/bafycen..."

Mecánica de Resolución en Kubo¶

  1. Un cliente solicita un recurso bajo la ruta /ipns/mirrors.mx-os.mx/fedora/iso o accede directamente a https://ipfs.mx-os.mx/.

  2. Kubo extrae el nombre de dominio y consulta el registro TXT de _dnslink.mirrors.mx-os.mx (o _dnslink.ipfs.mx-os.mx). Por defecto, Kubo utiliza los resolutores del sistema operativo (que a su vez dependen de servidores DNS locales o de enrutadores LAN con cachés independientes).

  3. Para eliminar el desfase de caché y garantizar resolución inmediata tras cada publicación, se configura un resolvedor DNS sobre HTTPS (DoH) directo en la configuración de Kubo para el dominio mx-os.mx. Es indispensable incluir el punto final (FQDN estricto):

    ipfs config --json DNS.Resolvers '{"mx-os.mx.": "https://cloudflare-dns.com/dns-query", ".": "auto"}'
    
  4. El registro TXT devuelve el prefijo canónico dnslink=/ipfs/<CID_RAÍZ>.

  5. Kubo reemplaza internamente la ruta por /ipfs/<CID_RAÍZ>/fedora/iso y procede a recuperar los bloques vía Bitswap o desde la memoria local.

  6. El tiempo de vida (TTL) del registro se fija en 300 segundos (5 minutos) en la zona autoritativa gestionada mediante el script de automatización nodo/bin/mxos-dnslink-update.bash.

Soberanía Dual: DNSLink e Identidad Criptográfica IPNS¶

Para preservar la resiliencia en escenarios de fallas de DNS, censura o entornos desconectados de internet, el catálogo mantiene dos mecanismos equivalentes de direccionamiento:

  1. Resolución nominal con DNSLink: Ruta amigable /ipns/mirrors.mx-os.mx respaldada por el registro TXT en Cloudflare.

  2. Resolución criptográfica autónoma con IPNS: Ruta inmutable e independiente de DNS bajo /ipns/k51qzi5uqu5di6ed3qtnwrdlvpmfil07ib6qfzb1t259nux49jenn8my4dtg0v, firmada con la llave Ed25519 de Fundación MxOS y publicada periódicamente en la DHT de libp2p.

Next
Puente HTTP y Fedora MirrorManager
Previous
Arquitectura de Distribución sobre IPFS
Copyright © 2026, Fundación MxOS
Made with Sphinx and @pradyunsg's Furo
On this page
  • Resolución Inmutable con DNSLink
    • Fundamento
    • Topología de Registros DNS
    • Mecánica de Resolución en Kubo
    • Soberanía Dual: DNSLink e Identidad Criptográfica IPNS