# Network Extension

> Usa Proxyman Network Extension para capturar el tráfico HTTP y HTTPS de cualquier app de tu Mac, incluidos scripts y apps que ignoran la configuración de proxy.

## 1. ¿Qué es? {#1-whats-it}

Network Extension captura el tráfico HTTP/HTTPS de las apps de tu Mac, incluidas las que ignoran el proxy del sistema.

Está basado en la [API de proxy transparente de Network Extension](https://developer.apple.com/documentation/networkextension/netransparentproxyprovider) de Apple. Se ejecuta como una extensión del sistema de macOS, firmada con nuestro certificado Developer ID de TablePlus Inc. y notarizada por Apple.

Funciona de forma similar al modo Network Capture de Fiddler Everywhere y al modo Local Capture de mitmproxy. No necesitas configurar un proxy en cada app.

> **Aviso:** Network Extension está en BETA y desactivado de forma predeterminada. Requiere Proxyman PRO, la edición directa de Proxyman, y macOS 26 o posterior. No está disponible en Setapp.

![Proxyman captura solicitudes HTTPS de cURL sin el flag --proxy](https://proxyman.com/docs/assets/proxyman_network_extension.jpeg)

_Capturar solicitudes de cURL sin el flag --proxy_

## 2. Problema {#2-problem}

El modo proxy normal depende de que las apps envíen sus solicitudes a través del proxy.

* Algunas apps y scripts ignoran el proxy del sistema de macOS, así que Proxyman no llega a verlas.
* Las librerías de NodeJS, Ruby y Python pueden necesitar configuraciones de proxy independientes, cambios en el código o Automatic Setup.
* Configurar cada app o librería a mano requiere tiempo y puede provocar errores.

## 3. Beneficios {#3-benefits}

* Captura el tráfico de apps y scripts que ignoran la configuración del proxy.
* Evita configurar el proxy manualmente en cada app.
* Usa herramientas existentes como Map Local, Breakpoint y Scripting en las solicitudes capturadas.

## 4. ¿Cómo instalar Network Extension? {#4-how-to-install-the-network-extension}

1. Activa Network Extension de una de estas dos formas:

* Abre Proxyman -> **Settings** -> **Network Extension**. Activa **Enable Network Extension**. Haz clic en **Install and Enable** si aparece.

![Settings de Proxyman con el panel Network Extension y el interruptor Enable Network Extension](https://proxyman.com/docs/assets/Screenshot%202026-10-01%20at%2019.56.42.jpg)

_Activa Network Extension en Settings_

* O haz clic en la barra de estado de la parte superior de la ventana principal (Proxyman | Listening on ...) y activa **Network Extension**.

2. Abre **System Settings** -> **General** -> **Login Items & Extensions**. En **Extensions**, selecciona **By Category** -> **Network Extensions** y, a continuación, activa Proxyman.
3. Cuando macOS pida añadir la configuración de red, haz clic en **Allow**.

![Activa el interruptor de Proxyman en Network Extensions](https://proxyman.com/docs/assets/install_proxyman_network_extension_step_2.jpeg)

_Permitir Proxyman Network Extension_

4. Espera a que Proxyman muestre "Capturing HTTP and HTTPS from local applications."

## 5. ¿Cómo se usa? {#5-how-to-use}

1. Mantén Proxyman abierto con Network Extension activada.
2. Network Extension ya captura el tráfico de las apps de tu Mac y lo envía a Proxyman.
3. Para leer el contenido HTTPS, [instala y confía en el certificado de Proxyman](https://proxyman.com/docs/es/debug-devices/macos) y, a continuación, activa [SSL Proxying](https://proxyman.com/docs/es/basic-features/ssl-proxying) para la app o el dominio.
4. Haz una nueva solicitud desde tu app, navegador o script. La solicitud aparece en Proxyman.

Si una app ya estaba abierta antes de activar la extensión, reiníciala para capturar las nuevas conexiones.

Para detener la captura sin desinstalar, desactiva **Enable Network Extension** en Settings.

## 6. Solución de problemas {#6-troubleshooting}

### Errores SSL en NodeJS, Ruby o Python {#ssl-errors-in-nodejs-ruby-or-python}

Es posible que estos entornos de ejecución no confíen en el certificado autofirmado de Proxyman, aunque lo hayas marcado como confiable en macOS. Network Extension captura su tráfico, pero la confianza en el certificado todavía requiere configuración.

Usa [Automatic Setup](https://proxyman.com/docs/es/automatic-setup/automatic-setup) para configurar la confianza en el certificado en las librerías compatibles:

1. Abre Proxyman -> **Setup** -> **Automatic Setup**.
2. Haz clic en **Open New Terminal** y acepta la solicitud de permisos si aparece.
3. Ejecuta tu script o reinicia tu servidor en esa nueva terminal.

> **Consejo:** Si usas [Automatic Setup](https://proxyman.com/docs/es/automatic-setup/automatic-setup) o [Manual Setup](https://proxyman.com/docs/es/automatic-setup/manual-setup), puedes desactivar **Enable Network Extension** en **Settings** -> **Network Extension**. Sigue ejecutando tu script o servidor en la terminal configurada con esa configuración.

Si el error continúa, consulta la [guía de solución de problemas de Automatic Setup](https://proxyman.com/docs/es/automatic-setup/troubleshooting).

## 7. ¿Cómo desinstalar Network Extension? {#7-how-to-uninstall-the-network-extension}

1. Abre Proxyman -> **Settings** -> **Network Extension**.
2. Haz clic en **Uninstall** y, a continuación, confirma.
3. Introduce la contraseña de tu Mac si se te pide y reinicia el Mac si se solicita.

Al desinstalar, se detiene la captura y se cierran las conexiones que usan la extensión. También se elimina la configuración de red.

## 8. Línea de comandos {#8-command-line}

Usa `proxyman-cli network-extension` para consultar el estado, instalar, desinstalar, activar, desactivar o reintentar. Proxyman debe estar abierto. Usa `install` para instalar sin activar la captura, o `enable` para iniciar la captura e instalar la extensión si hace falta. Puede que aún se requiera la aprobación de macOS o un reinicio.

Consulta la [guía de línea de comandos de Network Extension](https://proxyman.com/docs/es/command-line#16-network-extension) para ver los comandos, los campos de estado en JSON y los códigos de salida.

## Más información {#learn-more}

* [Presentamos Network Extension: captura el tráfico del Mac sin configurar un proxy](https://proxyman.com/posts/2026-10-06-introducing-network-extension)