VXVX Docs

Dispatcher

DispatcherConfig — sniffing and overrides

The dispatcher is configured in ServerConfig.dispatcher (DispatcherConfig). Schema: protos/proto/vx/dispatcher/dispatcher.proto.

It controls protocol sniffing, destination override, and some client-only behaviors.

DispatcherConfig

FieldTypeDescription
destinationOverridestring[]If non-empty, sniff connections and override destination with sniffed domain when protocol matches
sniffboolEnable sniffing for extra connection metadata (logging / routing)
ipv6UseDomainboolClient only — IPv6 handling preference
fallbackTimeoutuint32Wait time (ms) for response data before treating connection as failed
sessionStatsboolMeter per-session statistics

When destinationOverride lists protocols (for example http, tls), vx-core may replace the connection target with the sniffed hostname so router domain rules apply to IP-based connections.

Example

{
  "dispatcher": {
    "sniff": true,
    "destinationOverride": ["http", "tls"],
    "sessionStats": false
  }
}
  • RouterskipSniff, protocols, domain rules after sniff
  • DNS — resolution when rules use resolveDomain

Comments