Proxy de Chromedp y cómo usar un proxy con chromedp en 2026
TL;DR
Se configura un proxy de chromedp cuando Chrome se inicia. Pase el endpoint a través de chromedp.ProxyServer, que mapea al flag --proxy-server de Chrome.
No coloque credenciales de proxy dentro de ProxyServer. Maneje un desafío 407 a través del dominio Fetch del Protocolo de DevTools de Chrome y suministre credenciales con ContinueWithAuth.
Cambiar ProxyServer no rota un navegador que ya está en ejecución. Inicie un nuevo asignador de ejecución para cada endpoint seleccionado por la aplicación, o use una puerta de enlace de proveedor que rote salidas aguas arriba.
La navegación exitosa no es suficiente evidencia. Lea un marcador DOM conocido o una respuesta de verificación de IP autorizada y confirme que el navegador utilizó la ruta esperada.
El repositorio llamado chromedp-proxy es una herramienta de registro de CDP. No es la configuración que enruta el tráfico web saliente de Chrome.
¿Qué es un Proxy de chromedp?
Un proxy de chromedp es una ruta de red saliente adjunta al proceso de Chrome que controla chromedp. La documentación oficial del paquete chromedp describe chromedp como una biblioteca de automatización de navegador de alto nivel para el Protocolo de DevTools de Chrome. Su opción de asignador ProxyServer suministra el valor de la línea de comandos proxy-server de Chrome antes de que se inicie el navegador.
Ese ciclo de vida es la idea clave. Un proxy no es una opción por navegación en chromedp.Navigate. Pertenece a un , que crea un proceso de Chrome, y cada pestaña o objetivo que utiliza ese proceso hereda la ruta. Chrome envía tráfico del navegador a través del endpoint mientras chromedp continúa impulsando la navegación, clics, esperas y extracción de DOM a través de CDP.
Los resultados de búsqueda también muestran un proyecto llamado chromedp-proxy. Ese repositorio registra y reproduce mensajes de CDP para depurar; no reemplaza a chromedp.ProxyServer para tráfico HTTP o HTTPS saliente. Esta guía utiliza “proxy de chromedp” para referirse al proxy de red externo del navegador.
Utilice uno cuando un flujo de trabajo de automatización autorizado necesite egreso controlado, pruebas basadas en ubicación, verificación de anuncios, monitoreo de páginas públicas o aislamiento entre trabajos. Un proxy cambia la ruta; no otorga permiso para acceder a un destino ni hace que seleccionadores frágiles sean confiables.
Para una ruta gestionada, Nstproxy Residential Prime Proxies expone endpoints de proxy estándar que se pueden adjuntar en el mismo límite del proceso de Chrome.
Cómo Funciona el Enrutamiento por Proxy en chromedp
La ruta se determina antes de iniciar Chrome:
Construya opciones de asignador a partir de chromedp.DefaultExecAllocatorOptions.
Agregue chromedp.ProxyServer("http://host:port").
Cree un asignador de ejecución con chromedp.NewExecAllocator.
Cree un contexto de navegador a partir del asignador y ejecute acciones de navegación.
Cancela ambos contextos cuando el trabajo termine para que Chrome y sus recursos sean liberados.
La actual historia de lanzamientos de chromedp lista v0.15.1 como el último lanzamiento al momento de la prueba. Los ejemplos a continuación fijan esa versión y se compilaron con Go 1.26.7 contra Google Chrome el 20 de agosto de 2026.
Para puertas de enlace proxy HTTP, una URL como http://proxy.example:9000 puede enrutar tanto páginas HTTP como páginas HTTPS. Chrome utiliza CONNECT para destinos HTTPS. Mantenga la verificación de TLS habilitada; ignorar errores de certificado oculta problemas de configuración y debilita la prueba de aceptación.
Requisitos Previos y Configuración Segura
Cree un pequeño módulo Go e instale la dependencia probada:
go mod init chromedp-proxy-example
go get github.com/chromedp/chromedp@v0.15.1
Establezca la ruta ejecutable de Chrome, el endpoint proxy y un objetivo autorizado a través de la configuración de tiempo de ejecución protegida:
Utilice la ruta real de Chrome de su plataforma. Mantenga los endpoints y credenciales fuera de los repositorios, capturas de pantalla, etiquetas de métricas y registros de aplicaciones. Los ejemplos fallan rápidamente cuando falta un valor requerido y colocan un límite de 20 segundos alrededor de la tarea del navegador.
Hay tres métodos prácticos: iniciar Chrome con un proxy ordinario, responder a un desafío de autenticación de proxy a través de CDP o lanzar asignadores de navegadores separados para múltiples endpoints. Cada ejemplo completo a continuación se ejecutó contra un proxy diseñado para un propósito local. El cuerpo devuelto identificó el puerto de escucha real, por lo que las verificaciones probaron el enrutamiento en lugar de solo el inicio exitoso del navegador.
Método 1: Iniciar Chrome con un Proxy
Usa chromedp.ProxyServer cuando el endpoint no requiera un desafío de autenticación manejado por el navegador. Las opciones del asignador deben completarse antes de llamar a NewExecAllocator.
package main
import("context""fmt""log""os""time""github.com/chromedp/chromedp")funcmain(){ proxyURL :=mustEnv("PROXY_URL") targetURL :=mustEnv("TARGET_URL") opts :=append(chromedp.DefaultExecAllocatorOptions[:], chromedp.ExecPath(mustEnv("CHROME_PATH")), chromedp.ProxyServer(proxyURL),) allocCtx, cancelAlloc := chromedp.NewExecAllocator(context.Background(), opts...)defercancelAlloc() ctx, cancelBrowser := chromedp.NewContext(allocCtx)defercancelBrowser() ctx, cancelTimeout := context.WithTimeout(ctx,20*time.Second)defercancelTimeout()var body stringif err := chromedp.Run(ctx, chromedp.Navigate(targetURL), chromedp.Text("body",&body, chromedp.ByQuery),); err !=nil{ log.Fatal(err)} fmt.Println(body)}funcmustEnv(name string)string{ value := os.Getenv(name)if value ==""{ log.Fatalf("%s es requerido", name)}return value
}
El endpoint de verificación en el puerto 18380 devolvió basic_proxy_port_18380, y el programa imprimió ese texto DOM exacto. Reemplaza la impresión del cuerpo en producción con un marcador de ruta no sensible, un título renderizado o un elemento de página esperado.
No confíes en el descubrimiento del ejecutable predeterminado de Chrome en un despliegue controlado. Una ruta explícita facilita la comparación del comportamiento local, de contenedor y de CI. Inspecciona las reglas de bypass si los destinos locales o internos evitan inesperadamente el proxy. La guía de configuración del proxy de Chrome de Nstproxy explica los mismos conceptos a nivel de navegador fuera de Go.
Método 2: Autenticar un Proxy chromedp a través de CDP
Chrome no acepta de manera confiable `username:password@host:port` como un valor de `--proxy-server`. Pasa un endpoint sin credenciales a `ProxyServer`, habilita el dominio Fetch y responde solo a los desafíos cuya fuente es `Proxy`. El <a href="https://chromedevtools.github.io/devtools-protocol/tot/Fetch/" rel="nofollow noopener"><strong>dominio Fetch del Protocolo de DevTools de Chrome</strong></a> define `handleAuthRequests` y `continueWithAuth`; el <a href="https://pkg.go.dev/github.com/chromedp/examples/proxy" rel="nofollow noopener"><strong>ejemplo oficial de proxy autenticado de chromedp</strong></a> utiliza el mismo patrón basado en eventos.
```go
package main
import (
"context"
"fmt"
"log"
"os"
"time"
"github.com/chromedp/cdproto/fetch"
"github.com/chromedp/chromedp"
)
func main() {
opts := append(chromedp.DefaultExecAllocatorOptions[:],
chromedp.ExecPath(mustEnv("CHROME_PATH")),
chromedp.ProxyServer(mustEnv("PROXY_URL")),
chromedp.Flag("proxy-bypass-list", "<-loopback>"),
)
allocCtx, cancelAlloc := chromedp.NewExecAllocator(context.Background(), opts...)
defer cancelAlloc()
ctx, cancelBrowser := chromedp.NewContext(allocCtx)
defer cancelBrowser()
ctx, cancelTimeout := context.WithTimeout(ctx, 20*time.Second)
defer cancelTimeout()
authCtx, cancelAuth := context.WithCancel(ctx)
defer cancelAuth()
chromedp.ListenTarget(authCtx, func(event any) {
switch event := event.(type) {
case *fetch.EventRequestPaused:
go func() {
if err := chromedp.Run(ctx, fetch.ContinueRequest(event.RequestID)); err != nil {
log.Printf("continuar solicitud: %v", err)
}
}()
case *fetch.EventAuthRequired:
if event.AuthChallenge.Source != fetch.AuthChallengeSourceProxy {
return
}
go func() {
action := fetch.ContinueWithAuth(event.RequestID, &fetch.AuthChallengeResponse{
Response: fetch.AuthChallengeResponseResponseProvideCredentials,
Username: mustEnv("PROXY_USERNAME"),
Password: mustEnv("PROXY_PASSWORD"),
})
if err := chromedp.Run(ctx, action); err != nil {
log.Printf("autenticación del proxy: %v", err)
}
cancelAuth()
}()
}
})
var body string
if err := chromedp.Run(ctx,
fetch.Enable().WithHandleAuthRequests(true),
chromedp.Navigate(mustEnv("TARGET_URL")),
chromedp.Text("body", &body, chromedp.ByQuery),
); err != nil {
log.Fatal(err)
}
fmt.Println(body)
}
func mustEnv(name string) string {
value := os.Getenv(name)
if value == "" {
log.Fatalf("%s es requerido", name)
}
return value
}
Ejecuta esto con PROXY_USERNAME y PROXY_PASSWORD proporcionados por tu sistema de secretos. En la prueba, el proxy devolvió un 407 hasta que el manejador de Fetch proporcionó los valores correctos; el marcador final del DOM fue authenticated_proxy_port_18381.
Las goroutines son intencionales. Un callback de evento de chromedp no debe invocar sincrónicamente otro chromedp.Run bloqueante en el mismo objetivo. Continúa las solicitudes pausadas de inmediato, restringe las credenciales a los desafíos del proxy y cancela el listener después de manejar el desafío previsto. Si el objetivo también usa autenticación HTTP, construye una regla separada en lugar de enviar secretos del proxy.
Método 3: Rotar Proxies con un Nuevo Allocador de Navegador
Usa un nuevo allocador de ejecución para cada endpoint seleccionado por la aplicación porque ProxyServer es una bandera del proceso de Chrome. Cambiar una variable de Go no puede redirigir un navegador que ya se está ejecutando.
Con los puertos 18380 y 18382, la salida informó basic_proxy_port_18380 seguida de rotated_proxy_port_18382. La limpieza vive dentro de browseWithProxy, por lo que las llamadas defer se ejecutan después de cada iteración en lugar de acumularse hasta que termine un gran bucle.
Iniciar Chrome por endpoint consume más CPU y latencia que reutilizar un proceso. Para trabajos independientes, mantén la concurrencia limitada y registra un ID de endpoint no secreto, la latencia de inicio, la latencia de navegación y la clase de fallo. Para flujos con estado, mantén las cookies, pestañas y rutas proxy juntas para la sesión requerida. Si un gateway puede rotar o mantener una sesión upstream, la rotación del lado del proveedor evita lanzar un proceso solo para cambiar la salida. Compara este modelo con las elecciones de proceso y contexto en la guía de proxy de Puppeteer.
Cómo Verificar la Ruta del Proxy
Verifica la ruta, el resultado del navegador y la extracción por separado. Primero navega hacia una página de reflexión IP autorizada o una página de diagnóstico controlada a través del proxy y compara su dirección observada o marcador de ruta con la sesión del proveedor. Segundo, requiere el título esperado, el elemento o el estado de la aplicación después de que se ejecute JavaScript. Tercero, captura un conjunto limitado de tiempos y clases de error sin registrar credenciales o contenido sensible de la página.
Una navegación que devuelve HTML aún puede estar equivocada. Las páginas de error de proxy, las páginas de inicio de sesión, las pantallas de consentimiento y las páginas de bloqueo pueden producir un documento. Requiere un marcador reconocible y rechaza contenido inesperado antes de las acciones posteriores. La guía de solución de problemas de proxy de Playwright cubre síntomas de enrutamiento del navegador relacionados que también ayudan al aislar fallos de Chrome, DNS, autenticación y respuesta del objetivo.
Para obtener evidencia de red más profunda, escucha los eventos de CDP Network y registra la URL y el estado del documento principal. Mantén las verificaciones observables pero mínimas: un registro de cuerpo de respuesta de alto volumen puede exponer datos y crear ruido.
Elegir una Ruta de Nstproxy para chromedp
Los Proxies Residenciales Prime de Nstproxy se adaptan a los flujos de trabajo de chromedp que necesitan endpoints autenticados estándar, ubicaciones seleccionables y sesiones rotativas o fijas en la superficie del producto actual. Chrome recibe un endpoint de proxy normal, por lo que la integración se mantiene en el código de asignador y Fetch-domain, en lugar de un SDK de navegador específico del proveedor.
Usa una sesión fija cuando un flujo de navegador de múltiples pasos dependa de cookies o una identidad estable.
Usa rotación para verificaciones autorizadas independientes donde cada trabajo puede tolerar una salida diferente.
Prueba el destino exacto, la región, el comportamiento de la sesión y el flujo de autenticación antes de aumentar la concurrencia. El enrutamiento por proxy no reemplaza la estrategia de espera del navegador o la validación del selector. La comparativa de herramientas de automatización de navegadores puede ayudar si la elección más amplia entre chromedp y otro stack de automatización aún está abierta.
El asignador no recibió ProxyServer, o una regla de bypass coincidió
Construir opciones antes de NewExecAllocator; inspeccionar las reglas de bypass; verificar contra un marcador controlado.
407 Proxy Authentication Required
El endpoint necesita credenciales
Habilitar el manejo de autenticación Fetch, responder solo desafíos de proxy y verificar secretos sin imprimirlos.
La navegación se bloquea después de habilitar Fetch
Las solicitudes pausadas nunca se continuaron, o la devolución de llamada del evento bloqueó
Manejar EventRequestPaused y ejecutar acciones de continuación en goroutines.
La rotación mantiene la misma salida
Se reutiliza el mismo proceso de Chrome, o la sesión del proveedor es fija
Crear un nuevo asignador por endpoint, o cambiar el identificador de la sesión del proveedor.
ERR_PROXY_CONNECTION_FAILED
Esquema, host, puerto incorrectos, o endpoint inalcanzable
Probar la alcanzabilidad del endpoint, confirmar el protocolo y utilizar un tiempo de espera limitado.
La página se carga pero los selectores fallan
La respuesta es un error o página alternativa, o la espera es incorrecta
Inspeccionar el título y un marcador DOM conocido; separar enrutamiento, renderización y extracción.
Procesos de Chrome se acumulan
Los contextos de asignador o navegador no están cancelados
Asociar cada contexto creado con limpieza en el ámbito del trabajo correcto.
Los reintentos deben ser selectivos y limitados. Reintenta fallos de conexión transitorios y fallos de gateway con retroceso; no loops indefinidos en credenciales incorrectas, objetivos prohibidos o contenido estructuralmente inválido. Pone en cuarentena endpoints que fallan repetidamente y preserva solo diagnósticos no secretos.
Conclusión
Una configuración de proxy de chromedp confiable comienza en el límite del proceso de Chrome. Utilice chromedp.ProxyServer para un punto final ordinario, el dominio Fetch para un desafío de autenticación 407 y un nuevo asignador cuando su aplicación Go cambie explícitamente de puntos finales. Luego, demuestre la ruta con una respuesta controlada y valide por separado la página renderizada.
Comience con un destino autorizado y un proxy. Una vez que la ruta, la autenticación, la limpieza y las verificaciones de aceptación de la página sean repetibles, agregue rotación y concurrencia de acuerdo con las necesidades medidas.
Experimente Nstproxy — Comience su Prueba Gratuita Hoy
P: ¿Puedo poner un nombre de usuario y una contraseña en chromedp.ProxyServer?
No confíe en las credenciales incrustadas en el valor del servidor proxy. Pase el host y el puerto a ProxyServer, habilite los eventos de autenticación de Fetch y proporcione secretos con fetch.ContinueWithAuth después de un desafío de proxy.
P: ¿Puede chromedp cambiar proxies sin reiniciar Chrome?
No a través de ProxyServer, porque se convierte en una bandera del proceso de Chrome al iniciarse. Inicie un nuevo asignador de ejecución para otro punto final seleccionado por la aplicación, o utilice una puerta de enlace que cambie salidas mientras su dirección permanece constante.
P: ¿Funciona un proxy chromedp con páginas HTTPS?
Sí. Un proxy HTTP normalmente conecta destinos HTTPS mediante CONNECT. Mantenga la verificación del certificado habilitada y confirme que el objetivo vea la ruta de salida prevista.
P: ¿Por qué se queda colgado chromedp después de habilitar el dominio Fetch?
Fetch pausa solicitudes coincidentes. Continúe con los eventos EventRequestPaused y evite bloquear el oyente de chromedp ejecutando acciones de continuación en goroutines.
P: ¿Es necesario el proyecto de GitHub chromedp-proxy para proxies salientes?
No. Ese proyecto de nombre similar es una herramienta de registro y reproducción de CDP; el enrutamiento del navegador saliente utiliza chromedp.ProxyServer y, cuando es necesario, manejo de autenticación CDP.
Marcus Chen
Aug. 20th 2026
110M+ IP reales con 99.9% de acceso exitoso
Respuesta media ultrarrapida ~0.5s para tareas de alta concurrencia
Desde solo $0.1/GB
Acceso inmediato a pools premium de proxies residenciales, datacenter, IPv6 e ISP.
