Comment configurer un proxy réseau pour le SDK Node.js V2.0 - Alibaba Cloud SDK

Configurez des proxys HTTP ou HTTPS pour le SDK V2.0 afin d'acheminer les requêtes via un serveur proxy. Cette approche permet d'assurer le contrôle d'accès, la journalisation, la mise en cache ou le chargement différé sans modifier le code de votre application.

Types de proxy

Les proxys HTTP et HTTPS sont pris en charge.

Type de proxy

Description

Proxy HTTP

Utilisez le paramètre httpProxy pour définir l'adresse et le port du serveur proxy. Le format est http://<IP address>:<port>. Ce paramètre s'applique uniquement aux requêtes HTTP.

Proxy HTTPS

Le paramètre httpsProxy permet de spécifier l'adresse et le port du serveur proxy. Le format attendu est http://<IP address>:<port>. Cette configuration concerne exclusivement les requêtes HTTPS.

Remarque

Si le serveur proxy exige une authentification, ajoutez le nom d'utilisateur et le mot de passe à l'adresse. Respectez le format suivant : http://<user>:<password>@<IP address>:<port>

Une fois le proxy configuré, utilisez le paramètre noProxy pour indiquer les adresses qui doivent contourner le proxy. Séparez les différentes adresses par des virgules. Les noms de domaine et les adresses IP sont acceptés.

Méthode de configuration

Remarque

Les paramètres de proxy définis dans RuntimeOptions remplacent ceux spécifiés dans la configuration (Config) du client.

Configurez un proxy à l'aide de l'objet RuntimeOptions.

Node.js

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',
});

Typescript

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'
});

Définissez un proxy global au moyen de l'objet Config. Ce proxy s'appliquera alors à toutes les requêtes émises par le client.

Node.js

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',
});

Typescript

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'
});

Références

Pour plus d'informations sur la configuration des proxys, consultez Pratiques de configuration de proxy HTTP.