Proxy

Próxima versión — Zylon 1.58Esta documentación se publica antes del lanzamiento para que puedas preparar tus integraciones de API. La imagen de la versión todavía no está disponible. Para instalaciones con 1.57, consulta la documentación de 1.57.

El soporte de proxy está disponible a partir de Zylon 1.48 y CLI versión 1.23

Si tu instalación de Zylon se está ejecutando en una red LAN que requiere un proxy para el acceso a internet, sigue estos pasos para configurar los ajustes del proxy.

Determinar el tipo de proxy

Hay dos tipos de proxies:Proxy de Inspección SSL:

Intercepta e inspecciona el tráfico HTTPS
Descifra el tráfico usando su propio certificado SSL, luego lo vuelve a cifrar
Permite inspección profunda de paquetes y filtrado de contenido

Proxy Transparente:

Reenvía el tráfico HTTPS sin inspeccionarlo
No modifica los certificados SSL/TLS
Actúa como un simple paso para conexiones cifradas

Para determinar qué tipo tienes, ejecuta el siguiente comando, reemplazando your-proxy-address:port con los detalles de tu proxy:

curl -x your-proxy-address:port -v https://example.com 2>&1 | grep -A 5 "Server certificate" | grep "issuer:"

Mira la salida:

Si obtienes un error SSL, tienes un proxy de inspección SSL
Si el comando tiene éxito, verifica el campo issuer:
- Si el emisor es una autoridad de certificación pública (DigiCert, Let’s Encrypt, etc.), tienes un proxy transparente
- Si el emisor es la CA interna de tu organización o el nombre del servidor proxy, tienes un proxy de inspección SSL

Configurar los ajustes del proxy

Edita /etc/zylon/zylon-conf.yaml según tu tipo de proxy:

Proxy de Inspección SSL
Proxy Transparente

proxy:
  enabled: true
  httpProxy: "http://your-proxy-address:port"
  httpsProxy: "http://your-proxy-address:port"
  noProxy: "your,no,proxy,exceptions"
  crt: |-
    -----BEGIN CERTIFICATE-----
    MIIDoTCCAomgAwIBAgIGEAHcBPNvMA0GCSqGSIb3DQEBCwUAMCgxEjAQBgNVBAMM
    ...
    ipRF9TO2AlABfLmTR7uN8o0Opc92
    -----END CERTIFICATE-----

Para obtener el certificado CA de tu proxy, puedes intentar ejecutar:

echo | openssl s_client -showcerts -connect your-proxy-address:port 2>/dev/null | openssl x509

Ten en cuenta que esto puede no funcionar con todos los proveedores de proxy. Si falla, contacta a tu administrador de red para obtener el certificado CA.

proxy:
  enabled: true
  httpProxy: "http://your-proxy-address:port"
  httpsProxy: "http://your-proxy-address:port"
  noProxy: "your,no,proxy,exceptions"

replicated:
  privateCASecret: ~

No establezcas el campo crt para proxies transparentes. Si requieres capacidades de inspección SSL, debes reconfigurar tu infraestructura de proxy para inspección SSL y luego seguir las instrucciones en la pestaña Proxy de Inspección SSL arriba.

Aplicar la configuración

Ejecuta el comando de actualización para aplicar los cambios:

sudo zylon-cli sync

Reiniciar servicios (opcional, si tu clúster ya estaba ejecutándose)

Si el clúster estaba ejecutándose antes de aplicar los ajustes del proxy, reinicia el controlador k0s y recrea los pods de Zylon:

sudo systemctl daemon-reload
sudo systemctl restart k0scontroller
# Espera unos segundos hasta que el clúster se inicie de nuevo
kubectl delete pods -n zylon --all

Primeros pasos

Instalación

Mantenimiento y Operaciones

Backoffice

Configuración

Solución de Problemas

Seguridad

Auditabilidad y gobernanza de IA