Tous les produits
Search
Centre de documentation

Alibaba Cloud SDK:Configuration du proxy

Dernière mise à jour :Aug 11, 2026

Le SDK Go V2.0 prend en charge les proxys HTTP, HTTPS et SOCKS5. Configurez ces proxys via des variables d'environnement, l'objet Config ou RuntimeOptions.

Types de proxy

Ce SDK est compatible avec les proxys HTTP, HTTPS et SOCKS5. Utilisez un seul type de proxy à la fois.

Type de proxy

Description

Proxy HTTP

Définissez httpProxy sur l'adresse du proxy au format http://<IP address>:<port>. S'applique uniquement aux requêtes HTTP.

Proxy HTTPS

Définissez httpsProxy sur l'adresse du proxy au format http://<IP address>:<port>. S'applique uniquement aux requêtes HTTPS.

Proxy SOCKS5

Définissez socks5Proxy sur l'adresse du proxy au format socks5://<IP address>:<port> et spécifiez le protocole de transport (TCP ou UDP) pour Socks5NetWork.

Remarque

Si le proxy exige une authentification, incluez le nom d'utilisateur et le mot de passe dans l'URL : http://<user>:<password>@<IP address>:<port> ou socks5://<user>:<password>@<IP address>:<port>.

Pour les proxys HTTP ou HTTPS, utilisez noProxy pour spécifier les adresses (noms de domaine ou IP) séparées par des virgules qui contournent le proxy.

Méthodes de configuration

Remarque

Ordre de priorité (du plus élevé au plus bas) : RuntimeOptions > Config > variables d'environnement.

  • Configurez le proxy via des variables d'environnement.

    Remarque

    Les proxys SOCKS5 ne prennent pas en charge la configuration par variables d'environnement.

    • HTTP_PROXY ou http_proxy : adresse du proxy HTTP.

    • HTTPS_PROXY ou https_proxy : adresse du proxy HTTPS.

    • NO_PROXY ou no_proxy : adresses qui contournent le proxy.

  • Configurez le proxy dans RuntimeOptions. Cette configuration s'applique uniquement aux requêtes utilisant ces paramètres d'exécution.

    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"), 
    }
    
  • Configurez le proxy dans Config lors de l'initialisation du client. Cette configuration s'applique à toutes les requêtes.

    Exemple :

    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"),
    }
    

Références

Mise en œuvre de la configuration proxy HTTP