Todos los productos
Search
Centro de documentos

Alibaba Cloud SDK:Configuración de proxy

Última actualización: Sep 05, 2026

El SDK V2.0 de Go es compatible con proxies HTTP, HTTPS y SOCKS5. Configure los proxies mediante variables de entorno, Config o RuntimeOptions.

Tipos de proxy

El SDK admite proxies HTTP, HTTPS y SOCKS5. Utilice un solo tipo de proxy a la vez.

Tipo de proxy

Descripción

Proxy HTTP

Establezca httpProxy en la dirección del proxy con el formato http://<IP address>:<port>. Aplica únicamente a las solicitudes HTTP.

Proxy HTTPS

Establezca httpsProxy en la dirección del proxy con el formato http://<IP address>:<port>. Aplica únicamente a las solicitudes HTTPS.

Proxy SOCKS5

Establezca socks5Proxy en la dirección del proxy con el formato socks5://<IP address>:<port> y configure Socks5NetWork con el protocolo de transporte (TCP o UDP).

Nota

Si el proxy requiere autenticación, incluya el nombre de usuario y la contraseña en la URL: http://<user>:<password>@<IP address>:<port> o socks5://<user>:<password>@<IP address>:<port>.

Para los proxies HTTP o HTTPS, use noProxy para especificar las direcciones separadas por comas (nombres de dominio o IP) que omiten el proxy.

Métodos de configuración

Nota

Orden de prioridad (de mayor a menor): RuntimeOptions > Config > variables de entorno.

  • Configure el proxy con variables de entorno.

    Nota

    El proxy SOCKS5 no admite la configuración mediante variables de entorno.

    • HTTP_PROXY o http_proxy: la dirección del proxy HTTP.

    • HTTPS_PROXY o https_proxy: la dirección del proxy HTTPS.

    • NO_PROXY o no_proxy: las direcciones que omiten el proxy.

  • Configure el proxy en RuntimeOptions. Esta opción aplica únicamente a las solicitudes que usan estos parámetros de tiempo de ejecución.

    import (
        util "github.com/alibabacloud-go/tea-utils/v2/service"
        openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
        "github.com/alibabacloud-go/tea/tea"
    )
    
    config := &openapi.Config{
        Protocol: tea.String("https"),
    }
    
    runtime := &util.RuntimeOptions{
        // Modify the request protocol (Protocol) as needed. httpsProxy is effective only for the HTTPS protocol, and httpProxy is effective only for the HTTP protocol.
        HttpProxy:  tea.String("http://127.0.0.1:9898"),
        HttpsProxy: tea.String("http://127.0.0.1:8989"),
        
        NoProxy:    tea.String("127.0.0.1,localhost"),
    
        // SOCKS5 proxy
        // Socks5Proxy:   tea.String("socks5://127.0.0.1:8989"),
        // Socks5NetWork: tea.String("tcp"), 
    }
    
  • Configure el proxy en Config al inicializar el cliente. Esta opción aplica a todas las solicitudes.

    Ejemplo:

    import (
        openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
        "github.com/alibabacloud-go/tea/tea"
    )
    
    config := &openapi.Config{
        // httpsProxy is effective only for the HTTPS protocol, and httpProxy is effective only for the HTTP protocol.
        Protocol: tea.String("https"),
    
        // HTTP proxy
        HttpProxy:  tea.String("http://127.0.0.1:9898"),
        // HTTPS proxy
        HttpsProxy: tea.String("http://127.0.0.1:8989"),
        
        NoProxy:    tea.String("127.0.0.1,localhost"),
    
        // SOCKS5 proxy
        // Socks5Proxy:   tea.String("socks5://127.0.0.1:8989"),
        // Socks5NetWork: tea.String("tcp"),
    }
    

Referencias

HTTP proxy configuration practice