Clash Verge Rev system_proxy_bypass & Global Extended Configuration

If you searched for Clash Verge system_proxy_bypass, verge.yaml format or Global Extended Configuration, you most likely want to change one setting for all subscriptions at once. This guide shows the YAML location, the global-versus-profile scope, and working examples for system proxy bypass, DNS, ports and proxy groups.

This follows Clash Verge Rev v2.x.

The concept: two types × two scopes #

Clash Verge Rev modifies the final effective config through “extensions”, in two types and two scopes:

Extended Configuration (YAML)Extended Script (JavaScript)
Purposeoverride / merge config keysflexibly adjust the config object via code
GlobalGlobal Extended Configuration: applies to all subscriptionsGlobal Extended Script: applies to all
SubscriptionSubscription Extended Configuration: only that subscriptionSubscription Extended Script: only that one

Execution chain (later stages can override earlier ones):

Global Extended Configuration → Global Extended Script → Subscription Extended Configuration → Subscription Extended Script

⚠️ Key point: since v1.7.x the Extended Configuration is only for override/merge of config keys (DNS, ports, toggles, proxy groups, etc.). Adding rules no longer uses prepend-rules — use right-click profile → Edit Rule.

Where to open it #

  • Global: on the Profiles page, find the Global Extended Configuration / Global Extended Script entry near the top.
  • Per subscription: right-click the profile card → choose Edit (Extended Configuration / Script).

system_proxy_bypass in verge.yaml #

If your search is specifically about system_proxy_bypass, this is an application setting, not a profile’s subscription YAML. Open Clash Verge’s application directory and edit verge.yaml only after making a backup. The value is a semicolon-separated string; use_default_bypass keeps the built-in local-network bypass entries enabled:

use_default_bypass: true
system_proxy_bypass: localhost;127.*;10.*;192.168.*;<local>

Restart Clash Verge after changing the file, or use the System Proxy settings when your version exposes the same fields in the UI. Do not paste this block into a downloaded profile: verge.yaml stores app preferences, while profile YAML stores the proxy configuration.

What Extended Configuration can do: override / merge examples #

Extended Configuration is a block of YAML; the top-level keys you write are merged into the final config (same-key override, map-type merge). Common uses:

Example 1: unify DNS and disable unified-delay (in Global Extended Configuration → applies to all subscriptions)

dns:
  enable: true
  ipv6: true
  nameserver:
    - https://223.5.5.5/dns-query
    - https://1.1.1.1/dns-query
unified-delay: false

Example 2: set the mixed port and allow LAN connections

mixed-port: 7890
allow-lan: true

Example 3: override a single subscription only (in that subscription’s Extended Configuration)

find-process-mode: always

Save and refresh. Because these live in the extension (separate from the subscription file), updates won’t wipe them.

Adding rules / proxies / proxy groups? #

These are not written in the Extended Configuration (prepend/append moved out in v1.7.x):

  • Rules: right-click profile → Edit Rule (prepend/append). Full guide: How to add rules / custom rules.
  • Proxies / proxy groups: right-click profile → Edit Node / Edit Proxy Group.
  • Or use an Extended Script to add/remove on config.rules / config.proxies / config["proxy-groups"].

Extended Script (in brief) #

For conditions or bulk generation, use an Extended Script (JavaScript on quickjs, no filesystem access):

function main(config) {
  // e.g. force-disable IPv6 DNS for every subscription
  config.dns = config.dns || {};
  config.dns.ipv6 = false;
  return config;
}

Put it in the Global Extended Script to apply to all subscriptions.

Troubleshooting #

SymptomCause / fix
No effect after editingNot refreshed — reselect the profile or reconnect the core
Global overridden by a subscriptionA later subscription extension overrode it — check if you set the same key there
prepend-rules has no effectExtended Configuration no longer adds rules in v1.7.x — use Edit Rule
Script errors, item turns redA thrown error skips the script — ensure main does return config and the syntax is valid
广告