Watch
1
0
Fork
You've already forked mirrors
0
forked from MxOS/mirrors
mirrors/docs/technical/specs/puente-mirrormanager.rst
Rénich Bon Ćirić 0312c9e4a6
feat(branding): add official logo, update evaluator identity to EVALinux, and document guardian onboarding
- Embed official vector logo in portal header and Vigia bundle with adaptive theme styling
- Update public gateway domain to ipfs.mx-os.mx and gateway.ipfs.mx-os.mx in documentation
- Update custodian identity to EVALinux in Jalisco in guardianes.json
- Add comprehensive step-by-step onboarding guide for community nodes in README.rst and operador-nodo.rst
- Eliminate spaces around forward slashes across technical specifications and user guides
- Rebuild self-contained README.html and synchronize staging assets

Co-authored-by: Antigravity <antigravity@google.com>
Signed-off-by: Rénich Bon Ćirić <renich@evalinux.com>
2026-10-09 02:50:08 -06:00

2.5 KiB

Puente HTTP y Fedora MirrorManager

Identificador Técnico: [TECH-005]

Integración con MirrorManager

Fedora gestiona su infraestructura de distribución global mediante MirrorManager (mirrormanager2). Para registrar formalmente a MxOS como el primer espejo oficial en México, se requiere:

  1. Exposición de puntos finales HTTP y HTTPS estables y de alta velocidad.

  2. Soporte para el protocolo de verificación de sincronización (archivo report_mirror).

  3. Respuesta rápida en peticiones GET y HEAD para metadatos de repositorio.

Topología del Puente Inverso

En el servidor cabecera de MxOS (ejemplo: mirrors.mx-os.mx), un servidor web de alto rendimiento (Caddy o Nginx) actúa como terminador TLS y proxy inverso directo hacia el gateway HTTP de Kubo:

Petición DNF Upstream (Internet)
             |
             v
+---------------------------------------+
| Caddy o Nginx (mirrors.mx-os.mx:443)  |
| Certificados Let's Encrypt y TLS 1.3  |
+---------------------------------------+
             |
             | proxy_pass http://127.0.0.1:8080/ipns/mirrors.mx-os.mx/
             v
+---------------------------------------+
| Gateway HTTP de Kubo (IPFS Local)    |
+---------------------------------------+
             |
             v
+---------------------------------------+
| Enjambre P2P de Nodos Guardianes      |
+---------------------------------------+

Configuración de Ejemplo para Caddy

El servidor web delega la entrega de archivos estáticos al gateway local de IPFS:

mirrors.mx-os.mx {
    encode zstd gzip

    # Proxy transparente hacia el gateway de IPFS
    reverse_proxy http://127.0.0.1:8080 {
        rewrite /ipns/mirrors.mx-os.mx{path}
        header_up Host {upstream_hostport}
    }

    log {
        output stdout
        format filter {
            wrap json
            fields {
                common_log delete
            }
        }
    }
}

Beneficio Operativo

Este desacoplamiento permite que los clientes externos utilicen el espejo como si fuera un servidor web convencional, mientras que por debajo, el servidor cabecera obtiene los bloques faltantes desde la red comunitaria de nodos guardianes, reduciendo drásticamente la carga de salida del nodo central.