npm et yarn derrière un proxy

Les gestionnaires de paquets téléchargent via HTTPS, donc ils ont besoin d'un proxy HTTP CONNECT — qui est exactement le point de terminaison HTTP s4m sur le port 3128. npm garde sa propre configuration, donc définir les variables d'environnement du shell n'est pas toujours suffisant ; vous devez généralement définir à la fois proxy et https-proxy dans la configuration npm pour que le trafic du registre soit acheminé. Les deux générations de Yarn diffèrent : le yarn classique v1 lit ses propres paramètres proxy / https-proxy (et honore largement ceux de npm), tandis que Yarn Berry (v2+) utilise les clés httpProxy et httpsProxy dans .yarnrc.yml.

Pour tous, les variables d'environnement standard http_proxy, https_proxy et no_proxy sont également respectées, ce qui est le moyen le plus rapide de corriger une installation unique de npm install sur une machine verrouillée. Avec s4m, vous vous authentifiez avec USER:PASS contre proxy.s4m.online:3128. Consultez la page proxy et le guide des variables d'environnement partagé ; le guide frère pip et conda couvre l'équivalent Python.

Deux choses interrompent les installations même après que le proxy soit configuré. Premièrement, les caractères spéciaux dans le mot de passe : s'il contient @, : ou #, encodez-les en URL (par exemple, @ devient %40) sinon la configuration analyse mal l'URL. Deuxièmement, un mélange de registries publics et privés : mettez tout hôte de registre interne dans noproxy afin qu'il soit atteint directement, tandis que le registre npm public passe par le proxy.

Le point de terminaison HTTP de s4m est un proxy de datacenter authentifié, facturé à l'utilisation — un ajustement parfait pour les exécuteurs CI et les machines de développement qui doivent accéder à npm depuis derrière une sortie contrôlée. Ce n'est pas un proxy résidentiel et ce n'est pas un cache de paquets ; pour les installations hors ligne, utilisez un véritable miroir de registre. Lorsque votre CI a besoin d'une seule adresse IP de sortie autorisée, ajoutez une adresse IP personnelle dédiée. Un 407 signifie de mauvaises informations d'identification — consultez le guide 407. Le même point de terminaison alimente pip/conda et Docker ; validez-le avec les outils.