Configuration and Parser Options

Supported Share Schemes

  • VLESS

  • VMess

  • Trojan

  • Shadowsocks

The subscription metadata parser also recognizes SSR entries.

Common Parser Options

Pass additional native parser options to V2RootClient.parse:

normalized = client.parse(
    "vless://REPLACE_ME",
    routingMode="proxy",
    geositeDomain="ir",
    geositeDNS="1.1.1.1",
    geositeRules=[
        {"domain": "ads", "action": "block"},
        {"domain": "ir", "action": "direct"},
    ],
    geoipRules=[
        {"country": "private", "action": "direct"},
    ],
)

Port Defaults

  • HTTP: 2300 in the Python SDK

  • SOCKS: 2301 in the Python SDK

Both ports must be integers from 1 through 65535 and must differ.

Geo Options

geosite_path can be supplied during client construction and is forwarded to parser and runtime options.

The authoritative native option schema is maintained by V2Root Core.