How to configure a network proxy for the V2.0 Node.js SDK - Alibaba Cloud SDK: Central de Documentação do Alibaba Cloud

Configure proxies HTTP ou HTTPS para o SDK V2.0 e direcione as requisições por meio de um servidor proxy. Essa abordagem permite implementar controle de acesso, logging, cache ou lazy loading sem alterar o código da sua aplicação.

Tipos de proxy

O SDK suporta proxies HTTP e HTTPS.

Tipo de proxy	Descrição
Proxy HTTP	Utilize o parâmetro httpProxy para definir o endereço e a porta do servidor proxy. O formato é `http://<IP address>:<port>`. Essa configuração se aplica exclusivamente a requisições HTTP.
Proxy HTTPS	Defina o endereço e a porta do servidor proxy com o parâmetro httpsProxy. O formato é `http://<IP address>:<port>`. Essa configuração vale apenas para requisições HTTPS.

Nota

Caso o servidor proxy exija autenticação de identidade, inclua o nome de usuário e a senha no endereço. Adote o seguinte formato: http://<user>:<password>@<IP address>:<port>

Após configurar o proxy, use o parâmetro noProxy para indicar uma lista de endereços que não precisam passar pelo proxy. Separe vários endereços com vírgulas. É possível utilizar nomes de domínio e endereços IP.

Método de configuração

Nota

As configurações de proxy definidas em RuntimeOptions substituem as definições presentes no Config do cliente.

Configure o proxy utilizando o 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'
});

Defina um proxy global por meio do objeto Config. Esse proxy será aplicado a todas as requisições originadas pelo 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'
});

Referências

Para obter mais detalhes sobre a configuração de proxy, consulte Práticas de configuração de proxy HTTP.