A PAC file indique à un navigateur quel proxy utiliser pour quel site. Plutôt que d’envoyer tout le trafic via un seul proxy, ou aucun, vous écrivez une règle courte : ces boutiques passent par un proxy résidentiel en Allemagne, l’intranet de l’entreprise passe en direct, tout le reste suit une règle par défaut. Le navigateur lit la règle avant chaque requête.
PAC signifie proxy auto-config. Le format remonte à Netscape dans les années 1990 et reste pris en charge par tous les grands navigateurs et systèmes d’exploitation. Ce guide explique le fonctionnement du fichier, donne quatre exemples à copier, indique où le configurer sur chaque système et liste les erreurs qui font discrètement sortir le trafic du proxy.
Comment fonctionne un fichier PAC
Un fichier PAC est du JavaScript brut avec une fonction obligatoire :
function FindProxyForURL(url, host) {
return "PROXY p.shifter.io:443";
}
Le navigateur appelle FindProxyForURL pour chaque requête, avec l’URL complète et le nom d’hôte. La fonction renvoie une chaîne qui indique où va la requête :
| Valeur renvoyée | Signification |
|---|---|
DIRECT | Se connecter sans proxy |
PROXY host:port | Utiliser un proxy HTTP |
HTTPS host:port | Utiliser un proxy HTTP via une connexion TLS vers le proxy |
SOCKS5 host:port | Utiliser un proxy SOCKS5 |
Vous pouvez enchaîner plusieurs réponses avec des points-virgules, comme PROXY p.shifter.io:443; DIRECT. Le navigateur les essaie dans l’ordre et passe à la suivante si un proxy est injoignable. Ce repli est utile, et c’est aussi la façon la plus courante dont le trafic échappe au proxy, comme montré plus bas.
Pour Shifter, utilisez PROXY. Les navigateurs ne prennent pas en charge l’authentification auprès d’un proxy SOCKS5 depuis un fichier PAC, et la passerelle accepte les connexions proxy HTTP sur le même port.
Les fonctions auxiliaires que vous utiliserez
L’environnement PAC ajoute quelques fonctions au JavaScript brut. Ces quatre couvrent la plupart des règles :
isPlainHostName(host): vrai pour les noms sans point, commeintranet.dnsDomainIs(host, ".example.com"): vrai quand l’hôte se termine par ce domaine.shExpMatch(host, "*.example.*"): correspond aux jokers de style shell.isInNet(ip, "10.0.0.0", "255.0.0.0"): vrai quand une IP se trouve dans une plage réseau.
Il existe aussi dnsResolve(host), qui recherche l’IP d’un hôte. À utiliser avec parcimonie, pour les raisons évoquées dans la section sur les erreurs.
Quatre exemples prêts à l’emploi
Remplacez les domaines par les vôtres. Chaque exemple fonctionne comme un fichier complet.
1. Tout via le proxy, adresses locales en direct
function FindProxyForURL(url, host) {
if (isPlainHostName(host) ||
host === "localhost" ||
shExpMatch(host, "*.local") ||
shExpMatch(host, "127.*") ||
shExpMatch(host, "10.*") ||
shExpMatch(host, "192.168.*")) {
return "DIRECT";
}
return "PROXY p.shifter.io:443";
}
Cela garde votre routeur, vos imprimantes et vos serveurs de développement locaux accessibles tandis que chaque site web passe par le proxy.
2. Seulement une liste de sites via le proxy
var VIA_PROXY = [".example-shop.com", ".example-news.de"];
function FindProxyForURL(url, host) {
host = host.toLowerCase();
for (var i = 0; i < VIA_PROXY.length; i++) {
if (dnsDomainIs(host, VIA_PROXY[i]) || "." + host === VIA_PROXY[i]) {
return "PROXY p.shifter.io:443";
}
}
return "DIRECT";
}
C’est la raison la plus courante d’écrire un fichier PAC. Votre navigation normale reste sur votre propre connexion, et seuls les sites que vous vérifiez sortent via le proxy, ce qui maintient aussi le trafic par GB à un niveau bas. Les équipes QA s’en servent pour voir une boutique ou la vue web d’une application depuis un autre marché pendant que le reste de leurs outils fonctionne comme d’habitude ; notre page sur le QA de localisation avec des proxies couvre ce flux de travail.
3. Choisir entre le repli et l’échec fermé
function FindProxyForURL(url, host) {
if (dnsDomainIs(host, ".example-shop.com")) {
// Échec fermé : si le proxy est hors service, la page ne se charge pas.
return "PROXY p.shifter.io:443";
}
if (dnsDomainIs(host, ".example-news.de")) {
// Repli : si le proxy est hors service, la page se charge depuis votre propre IP.
return "PROXY p.shifter.io:443; DIRECT";
}
return "DIRECT";
}
Les exemples 1, 2 et 4 échouent tous de façon fermée : il n’y a pas de ; DIRECT après le proxy. Si le proxy est injoignable, ces pages affichent une erreur au lieu de se charger discrètement depuis votre véritable IP. Quand l’objectif du proxy est de voir un site depuis un autre endroit, une erreur vaut mieux qu’une réponse fausse qui semble correcte. N’ajoutez le repli que pour les sites où toute réponse vaut mieux qu’aucune.
4. Tout via le proxy sauf quelques sites
var DIRECT_SITES = [".zoom.us", ".slack.com", ".yourcompany.com"];
function FindProxyForURL(url, host) {
host = host.toLowerCase();
if (isPlainHostName(host)) return "DIRECT";
for (var i = 0; i < DIRECT_SITES.length; i++) {
if (dnsDomainIs(host, DIRECT_SITES[i])) return "DIRECT";
}
return "PROXY p.shifter.io:443";
}
Les appels, la discussion et les outils internes restent sur votre propre connexion, où ils sont les plus rapides, et le reste du navigateur utilise le proxy.
Où configurer le fichier PAC
Un fichier PAC se configure comme une URL, pas en le collant comme du texte. Servez-le depuis un serveur web que vous contrôlez, avec le type application/x-ns-proxy-autoconfig. Windows n’accepte pas un chemin de fichier local pour le script, donc une URL web est le choix sûr partout.
- Windows 11 : Paramètres > Réseau et Internet > Proxy. Sous Configuration automatique du proxy, activez Utiliser un script de configuration et saisissez l’URL.
- macOS : Réglages Système > Réseau > votre connexion > Détails > Proxies. Activez Configuration automatique du proxy et saisissez l’URL.
- Firefox : Paramètres > Paramètres réseau > URL de configuration automatique du proxy.
- Chrome et Edge : ils suivent le paramètre système ci-dessus.
- iPhone : Réglages > Wi-Fi > le bouton info > Configurer le proxy > Automatique, puis l’URL.
- Android : les Options avancées du réseau Wi-Fi > Proxy > Configuration automatique du proxy, puis l’URL.
Notre guide pour configurer un proxy sous Windows et macOS montre la version manuelle de ces mêmes écrans, si vous préférez un seul proxy pour tout.
Authentification, et pourquoi la localisation est définie une fois
Un fichier PAC n’a pas de place pour un nom d’utilisateur ou un mot de passe. Quand une requête atteint le proxy, celui-ci demande des identifiants et le navigateur affiche une invite de connexion. Saisissez votre nom d’utilisateur proxy complet et votre mot de passe. Si l’invite revient sans cesse, les identifiants sont rejetés : recopiez les deux depuis le tableau de bord et vérifiez l’orthographe de la partie de ciblage.
Avec Shifter, la localisation et la session résident dans le nom d’utilisateur, par exemple customer-USERNAME-country-de-sid-qa1-ttl-1800 pour une IP allemande qui tient 30 minutes. Ainsi, un fichier PAC décide quels sites utilisent le proxy, et le nom d’utilisateur avec lequel vous vous connectez décide d’où ils apparaissent. Une session de navigateur correspond à une localisation. Si vous avez besoin de pays différents pour des sites différents au même moment, utilisez des profils de navigateur séparés, ou l’extension de navigateur Shifter, qui change de localisation en un clic.
Erreurs qui font passer le trafic autour du proxy
- Un repli que vous ne vouliez pas.
PROXY ...; DIRECTcharge la page depuis votre véritable IP dès que le proxy échoue. Ne l’utilisez que là où c’est acceptable. - Un fichier cassé ou injoignable. Si l’URL du PAC ne se charge pas, ou si le script lève une erreur, la plupart des navigateurs se connectent en direct. Testez après chaque modification et gardez le fichier court.
- Des règles sur le chemin des URL HTTPS. Les navigateurs retirent le chemin et la requête des URL HTTPS avant d’appeler la fonction, donc
urlne contient que quelque chose commehttps://example.com/. Faites correspondre surhost. - Des recherches DNS à l’intérieur des règles.
dnsResolveetisInNetsur un nom d’hôte recherchent d’abord le nom sur votre propre réseau. Cela ralentit chaque requête, et cela envoie les noms des sites que vous visitez à votre résolveur DNS local même quand la page elle-même passe par le proxy. Notre guide sur la prévention des fuites DNS avec des proxies résidentiels explique pourquoi c’est important. PréférezdnsDomainIsetshExpMatch, qui travaillent sur le seul nom. - Une ancienne version mise en cache. Les navigateurs mettent le fichier PAC en cache. Après une modification, redémarrez le navigateur ou réappliquez les paramètres (dans Chrome,
chrome://net-internals/#proxy). - Une découverte automatique que vous n’avez jamais demandée. « Détecter automatiquement les paramètres » (WPAD) permet au réseau que vous rejoignez de transmettre à votre appareil un fichier PAC. Sur les réseaux auxquels vous ne faites pas confiance, désactivez-la.
Vérifier que ça fonctionne
Ajoutez un domaine de test à vos règles, puis ouvrez ip-info.com une fois avec la règle qui le fait passer par le proxy et une fois en direct. La première visite devrait montrer l’IP du proxy et la localisation présente dans votre nom d’utilisateur ; la seconde, la vôtre propre. Ouvrez ensuite un site hors de votre liste et vérifiez qu’il se charge toujours normalement.
En résumé
Un fichier PAC est quelques lignes de JavaScript qui décident, site par site, si une requête passe par un proxy ou non. Gardez les règles basées sur les noms d’hôtes, évitez les recherches DNS à l’intérieur, choisissez délibérément entre le repli et l’échec fermé, et servez le fichier depuis une URL. Le nom d’utilisateur du proxy définit toujours la localisation, donc prévoyez une localisation par profil de navigateur.