VXVX Docs

Sets

Domain, IP, and app sets to help you split your traffic

Sets — named collections used by routing and dns rules.

Set types

TypeContainsExample names
Atomic domain setDomains, geosite, remote URLsCustom Proxy, Custom Direct, GFW, CN, Private
Atomic IP setCIDRs, geoip, remote URLsCustom Proxy, Custom Direct, CN, Public
Great domain setCombination of domain sets (include / exclude)GFW Mode Proxy Domains
Great IP setCombination of other IP setsGFW Mode Proxy IPs
App setApplication IDsProxy, Direct

Atomic sets are building blocks. Great sets are built from atomic sets (and other great sets).

Great domain sets and great IP sets

A great set does not hold domains or IPs directly. It combines other sets using Include and Exclude lists.

When vx-core checks whether a domain or IP belongs to a great set:

  1. Exclude first — if the destination matches any set in Exclude, the great set does not match.
  2. Include — if the destination matches any set in Include, the great set matches.
  3. Otherwise it does not match.

Great IP sets work the same way, but with IP sets instead of domain sets.

Example: GFW Mode Proxy Domains

In GFW mode, the great domain set GFW Mode Proxy Domains is defined as:

  • Include: GFW, Custom Proxy, Fallback
  • Exclude: Custom Direct

A domain in the GFW list (and not in Custom Direct) matches this set.

Mutually exclusive set name

When creating or editing a great domain set or great IP set, you can optionally set a Mutually Exclusive Set Name.

This names the paired opposite set. For example:

  • CN Mode Direct DomainsCN Mode Proxy Domains

They represent two sets: one include all domains in China mainland, the other include all others.

In the UI, when you pick domain or IP sets for routing rules, both a set and its mutually exclusive name appear in the picker. Lookups also work by either name.

Atomic set

Atomic domain set

FieldPurpose
NameUnique identifier referenced by routing rules.
Use Bloom FilterReduces memory for large sets. There is a small chance (~1%) of false positives — a domain not in the set may be treated as if it were.
InverseFlips membership: the set matches destinations that are not in its sources.
GeoSite URLHTTPS URL to a custom geosite.dat file. If empty, VX uses the geosite.dat provided by LoyalSoldier.
GeoSite CodesCategories from geosite data (e.g. cn, gfw, private).
GeoSite AttributesSub-filters within a code (e.g. cn under category-games).
URLsRemote files downloadable by urls — see URL file types below.
DomainsManually added domain entries (full domain, suffix, keyword, etc.).

Atomic IP set

FieldPurpose
NameUnique identifier referenced by routing rules.
InverseSame as for domain sets — matches IPs not in the set's sources.
GeoIP URLHTTPS URL to a custom geoip.dat file. If empty, VX uses the geosite.dat provided by LoyalSoldier..
GeoIP CodesCategories from geoip data (e.g. cn, private).
URLsRemote files downloadable by urls
CIDRsManually added IP ranges.

Supported URL file types

  • V2ray GeoSite / GeoIP files

  • Clash Rules

Geo file updates

VX downloads geo files from urls specified in atomic sets periodically.

Configure automatic updates in Settings → General → Auto Update Geo Files:

SettingBehavior
Auto Update Geo FilesEnables periodic re-download of geo files.
Update IntervalHow often to refresh, in days (minimum 1). Default is 7 days.
Update NowTriggers an immediate download and processing.

Set name cannot be duplicated

Every set name must be unique within its category(domain/ip/app):

  • An atomic domain set name cannot be same as any other atomic or great domain set name.
  • A great domain set name cannot be same as any existing atomic or great domain set name.
  • A new name also cannot be same as another set's mutually exclusive set name.

The same rules apply separately to IP sets (atomic vs great).

Built-in geo sets

VX always has these built-in sets:

Atomic Domain Set

SetRole
Custom ProxyThis is the set you are editing when you add/remove domains in proxy segment of the simplified view
Custom DirectThis is the set you are editing when you add/remove domains in direct segment of the simplified view

Atomic IP Set

SetRole
Custom ProxyThis is the set you are editing when you add/remove ips in proxy segment of the simplified view
Custom DirectThis is the set you are editing when you add/remove ips in direct segment of the simplified view

App Set

SetRole
ProxyThis is the set you are editing when you add/remove apps in proxy segment of the simplified view
DirectThis is the set you are editing when you add/remove apps in direct segment of the simplified view

Comments