Groupe de politiques

Un groupe de politiques peut contenir plusieurs politiques. Il peut s'agir d'une politique de proxy, d'un autre groupe de politiques ou d'une politique intégrée (DIRECT et REJECT).

Il existe cinq types de groupes : select, url-test, fallback, load-balance et ssid. La section [Proxy Group] déclare les groupes de politiques. Le type smart est également accepté et traité comme url-test.

Groupe à sélection manuelle

Choisissez dans l'interface utilisateur la politique à utiliser.

SelectGroup = select, ProxyHTTP, ProxyHTTPS, DIRECT, REJECT

Paramètres facultatifs : default=<index> (index du membre initialement sélectionné), policy-provider:Nom (importe les membres depuis un fournisseur de proxy), filter= / exclude-filter= (regex appliquées aux membres fournis par le fournisseur) et HIDDEN=true.

Sur la version iOS, vous pouvez utiliser le widget Today pour changer rapidement de politique dans le premier groupe « select ». Sur la version macOS, vous pouvez changer de politique depuis le menu de la barre des menus.

Groupe à test d'URL automatique

Sélectionne automatiquement la politique à utiliser en mesurant la latence vers une URL.

AutoTestGroup = url-test, ProxySOCKS5, ProxySOCKS5TLS, url = http://www.google.com/generate_204

Paramètres

url : facultatif

Chute envoie une requête HTTP GET vers l'URL. Le test ne s'intéresse qu'à la réception de données de réponse, même s'il s'agit d'une erreur HTTP. En cas d'omission, l'URL de sonde par défaut http://www.gstatic.com/generate_204 est utilisée.

interval : facultatif, s (par défaut : 600 s).

Fréquence à laquelle les politiques sont retestées. Un minuteur global d'une seconde déclenche des retests automatiques toutes les interval secondes, que le groupe de politiques soit utilisé ou non. Il existe deux exceptions : un groupe avec lazy=true ne commence les tests qu'à sa première utilisation, et les tests sont suspendus tant que le groupe reste inactif plus longtemps que idle-timeout.

tolerance : facultatif, ms (par défaut : 100 ms).

La politique ne change que lorsque le nouveau gagnant obtient un score supérieur à celui de l'ancien gagnant augmenté de la tolérance.

timeout : facultatif, s (par défaut : 5 s).

Abandonne une politique si le test ne s'achève pas dans ce délai.

lazy : facultatif (true/false, par défaut : false).

Lorsque cette option est activée, les politiques ne sont testées qu'à la première utilisation, et non au démarrage.

max-failed-times : facultatif (par défaut : 0, désactivé).

Nombre d'échecs de test consécutifs après lequel une politique est considérée comme défaillante. Cette option n'est effective que pour les groupes de répartition de charge, où les politiques défaillantes sont exclues de la sélection. Pour les groupes url-test et fallback, le nombre d'échecs est suivi mais n'affecte pas la sélection. Lorsqu'elle n'est pas définie (0), les échecs de test n'excluent jamais une politique.

expected-status : facultatif (par défaut : vide).

expected-status=204

Réservé. Analysé mais sans effet dans le noyau actuel — un test réussit dès que des données de réponse sont reçues, quel que soit le code de statut.

idle-timeout : facultatif, s.

idle-timeout = 120

Lorsque le groupe de politiques n'a pas été utilisé (aucune nouvelle connexion n'y a puisé de politique) pendant plus longtemps que cette durée, les tests d'URL périodiques sont suspendus. Ils reprennent dès que le groupe est de nouveau utilisé. Aucune connexion n'est jamais fermée par cette option.

Également pris en charge : HIDDEN=true, filter=, exclude-filter=, policy-provider:Nom.

Groupe de repli

Sélectionne une politique disponible par ordre de priorité. La disponibilité est testée par accès à une URL, comme pour un groupe à test d'URL automatique. Les politiques placées en tête ont une priorité supérieure.

FallbackGroup = fallback, ProxySOCKS5, ProxySOCKS5TLS, url = http://www.google.com/generate_204

Paramètres

url : facultatif

Indique quelle URL sera testée. En cas d'omission, l'URL de sonde par défaut http://www.gstatic.com/generate_204 est utilisée.

interval : facultatif, s (par défaut : 600 s).

Fréquence à laquelle les politiques sont retestées. Même sémantique que pour le groupe à test d'URL automatique.

timeout : facultatif, s (par défaut : 5 s).

Abandonne une politique si le test ne s'achève pas dans ce délai.

lazy / max-failed-times : facultatifs.

Identiques au groupe à test d'URL automatique. Également pris en charge : HIDDEN=true, filter=, exclude-filter=, policy-provider:Nom.

Groupe SSID

Sélectionne une politique en fonction du SSID Wi-Fi actuel.

SSIDGroup = ssid, default = ProxyHTTP, cellular = ProxyHTTP, SSIDName = ProxySOCKS5

Paramètres

default : requis.

La politique utilisée lorsqu'aucune option SSID correspondante n'a été trouvée.

cellular : facultatif.

La politique utilisée sur réseau cellulaire. Si elle n'est pas fournie, la politique par défaut est utilisée.

Au moins un mappage SSID (par ex. SSIDName = ProxySOCKS5) est requis en plus de default.

Groupe de répartition de charge

Répartit les requêtes entre plusieurs proxys selon une stratégie de répartition de charge.

LBGroup = load-balance, ProxySOCKS5, ProxyHTTPS, url = http://www.google.com/generate_204, strategy = round-robin

Paramètres

strategy : facultatif (par défaut : round-robin)

Indique la stratégie de répartition de charge :

url : facultatif

url = http://www.google.com/generate_204

Chute envoie une requête HTTP GET pour tester la disponibilité des proxys. En cas d'omission, l'URL de sonde par défaut http://www.gstatic.com/generate_204 est utilisée. Les résultats des tests n'affectent la sélection que lorsque max-failed-times est supérieur à 0 ; avec la valeur par défaut 0, les proxys défaillants ne sont pas exclus.

interval : facultatif, s (par défaut : 600 s).

interval = 300

Fréquence des nouveaux tests de disponibilité des proxys.

timeout : facultatif, s (par défaut : 5 s).

timeout = 3

Délai d'expiration de la requête de test de disponibilité.

lazy : facultatif (true/false, par défaut : false).

Identique au groupe à test d'URL automatique : les tests ne démarrent qu'à la première utilisation du groupe.

max-failed-times : facultatif (par défaut : 0, désactivé).

max-failed-times = 3

Nombre d'échecs de test consécutifs après lequel un proxy est marqué comme défaillant et exclu de la répartition de charge. Avec la valeur par défaut 0, les résultats de test n'excluent jamais un proxy. Si tous les proxys sont défaillants, ils sont de nouveau tous utilisés.

HIDDEN : facultatif (true/false, par défaut : false).

HIDDEN = true

Lorsque cette option est activée, le groupe de politiques est masqué dans l'interface utilisateur. La clé s'écrit conventionnellement en majuscules, mais elle est reconnue sans distinction de casse : hidden=true fonctionne donc également. Également disponible sur les groupes select, url-test et fallback.

Remarque : le paramètre interrupt-exist-connections est désormais un réglage global de [General]. Consultez Options diverses.

Fournisseur de proxy

Les fournisseurs de proxy permettent d'importer des listes de proxys depuis des sources externes (fichiers ou URL). Ils se définissent dans la section [Proxy Provider] :

[Proxy Provider]
MyProvider = url=https://example.com/proxies.yaml, interval=3600

Paramètres

La charge utile doit être un document YAML de style mihomo comportant une liste proxies: (ou payload:).

Les fournisseurs de proxy sont référencés depuis les groupes de politiques avec le préfixe policy-provider: :

[Proxy Group]
MyGroup = select, policy-provider:MyProvider