======================================
Configuración de Clientes DNF con IPFS
======================================

Propósito
=========
Este manual detalla cómo configurar el gestor de paquetes DNF en cualquier estación de trabajo o servidor local para consumir paquetes directamente desde el enjambre de IPFS a través del gateway HTTP local (puerto 8080).

Ventajas
========

* **Velocidad máxima:** Los paquetes que tú o tus vecinos de red local hayan pineado se descargan a la velocidad máxima de la interfaz local sin saturar tu conexión hacia internet.
* **Seguridad criptográfica íntegra:** Las firmas GPG oficiales de Fedora y CentOS Stream siguen siendo verificadas por DNF contra las llaves oficiales instaladas en ``/etc/pki/rpm-gpg/``.

Configuración para Fedora
=========================
Crea un archivo de repositorio en ``/etc/yum.repos.d/fedora-mxos-ipfs.repo`` con el siguiente contenido:

.. code-block:: ini

   [fedora-mxos-ipfs]
   name=Fedora $releasever - $basearch (Espejo MxOS IPFS)
   baseurl=http://127.0.0.1:8080/ipns/mirrors.mx-os.mx/fedora/linux/releases/$releasever/Everything/$basearch/os/
   enabled=1
   metadata_expire=6h
   gpgcheck=1
   gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch

   [fedora-updates-mxos-ipfs]
   name=Fedora $releasever Updates - $basearch (Espejo MxOS IPFS)
   baseurl=http://127.0.0.1:8080/ipns/mirrors.mx-os.mx/fedora/linux/updates/$releasever/Everything/$basearch/
   enabled=1
   metadata_expire=6h
   gpgcheck=1
   gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch

Configuración para CentOS Stream 10
===================================
Crea un archivo en ``/etc/yum.repos.d/centos-stream-mxos-ipfs.repo``:

.. code-block:: ini

   [cs10-baseos-mxos-ipfs]
   name=CentOS Stream 10 - BaseOS (Espejo MxOS IPFS)
   baseurl=http://127.0.0.1:8080/ipns/mirrors.mx-os.mx/centos-stream/10-stream/BaseOS/$basearch/os/
   enabled=1
   metadata_expire=6h
   gpgcheck=1
   gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-centosofficial

   [cs10-appstream-mxos-ipfs]
   name=CentOS Stream 10 - AppStream (Espejo MxOS IPFS)
   baseurl=http://127.0.0.1:8080/ipns/mirrors.mx-os.mx/centos-stream/10-stream/AppStream/$basearch/os/
   enabled=1
   metadata_expire=6h
   gpgcheck=1
   gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-centosofficial

Prueba de Funcionamiento
========================
Limpia la caché de metadatos de DNF y verifica la comunicación con el gateway local:

.. code-block:: bash

   # Limpiar cachés previas
   sudo dnf clean all --disablerepo="*" --enablerepo="*-mxos-ipfs"

   # Comprobar la actualización de metadatos
   sudo dnf check-update --disablerepo="*" --enablerepo="*-mxos-ipfs"

Configuración Soberana sin Dependencia de DNS en Modo Desconectado o Air-gapped
===============================================================================
En entornos donde no se disponga de resolución DNS o se requiera validación puramente criptográfica sin intermediación de Cloudflare, se puede configurar ``baseurl`` apuntando directamente al identificador de la llave Ed25519 ``mxos-mirrors``:

.. code-block:: ini

   [fedora-mxos-ipns-direct]
   name=Fedora $releasever - $basearch (IPNS Directo Soberano)
   baseurl=http://127.0.0.1:8080/ipns/k51qzi5uqu5di6ed3qtnwrdlvpmfil07ib6qfzb1t259nux49jenn8my4dtg0v/fedora/releases/$releasever/Everything/$basearch/os/
   enabled=1
   metadata_expire=6h
   gpgcheck=1
   gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch