Todos los productos
Search
Centro de documentos

Alibaba Cloud SDK:Configurar un proxy

Última actualización: Sep 05, 2026

Configure proxies HTTP o HTTPS para el SDK V2.0 para enrutar las solicitudes a través de un servidor proxy. Esto le permite aplicar control de acceso, registrar información, almacenar en caché o habilitar la carga diferida sin modificar el código de su aplicación.

Tipos de proxy

Se admiten los proxies HTTP y HTTPS.

Tipo de proxy

Descripción

Proxy HTTP

Use el parámetro httpProxy para configurar la dirección y el puerto del servidor proxy. El formato es http://<IP address>:<port>. Esta configuración se aplica únicamente a las solicitudes HTTP.

Proxy HTTPS

Use el parámetro httpsProxy para configurar la dirección y el puerto del servidor proxy. El formato es http://<IP address>:<port>. Esta configuración se aplica únicamente a las solicitudes HTTPS.

Nota

Si el servidor proxy requiere autenticación de identidad, agregue el nombre de usuario y la contraseña a la dirección. Use el siguiente formato: http://<user>:<password>@<IP address>:<port>

Después de configurar un proxy, también puede usar el parámetro noProxy para especificar una lista de direcciones que no requieren proxy. Separe varias direcciones con comas. Puede utilizar nombres de dominio y direcciones IP.

Método de configuración

Nota

La configuración de proxy en RuntimeOptions anula la establecida en el objeto Config del cliente.

  • Configure un proxy mediante el objeto RuntimeOptions.

    const { RuntimeOptions } = require('@alicloud/tea-util');
    
    const runtime = new RuntimeOptions({
      // Configure an HTTP proxy.
      httpProxy: "http://xx.xx.xx.xx:8089",
      // Configure an HTTPS proxy.
      httpsProxy: "https://xxx.xxx.xxx.xxx:9999",
      // Configure the addresses that do not require a proxy.
      noProxy: '127.0.0.1,localhost',
    });
    
    import * as $Util from '@alicloud/tea-util';
    
    // Create a RuntimeOptions instance and set runtime parameters.
    const runtime = new $Util.RuntimeOptions({
      // Configure an HTTP proxy.
      httpProxy: "http://xx.xx.xx.xx:8089",
      // Configure an HTTPS proxy.
      httpsProxy: "https://xxx.xxx.xxx.xxx:9999",
      // Configure the addresses that do not require a proxy.
      noProxy: '127.0.0.1,localhost'
    });
    
  • Configure un proxy global mediante el objeto Config. Este proxy se aplica a todas las solicitudes del cliente.

    const { Config } = require('@alicloud/openapi-client');
    
    const config = new Config({
      // Configure an HTTP proxy.
      httpProxy: "http://xx.xx.xx.xx:8089",
      // Configure an HTTPS proxy.
      httpsProxy: "https://xxx.xxx.xxx.xxx:9999",
      // Configure the addresses that do not require a proxy.
      noProxy: '127.0.0.1,localhost',
    });
    
    import * as $OpenApi from '@alicloud/openapi-client';
    
    const config = new $OpenApi.Config({
      // Configure an HTTP proxy.
      httpProxy: "http://xx.xx.xx.xx:8089",
      // Configure an HTTPS proxy.
      httpsProxy: "https://xxx.xxx.xxx.xxx:9999",
      // Configure the addresses that do not require a proxy.
      noProxy: '127.0.0.1,localhost'
    });
    

Referencias

Para obtener más información sobre la configuración de proxy, consulte HTTP proxy configuration practices.