refactor(config): Refactor V2Fly and Xray configuration schema definitions

- Split V2FlySchema into multiple independent object schema definitions - Split XraySchema into multiple independent schema definitions - Extract common object schemas such as LogObject, ApiObject, DnsObject, etc. - Optimize code structure to improve maintainability
2026-01-04 14:30:07 +08:00
2 changed files with 538 additions and 478 deletions
--- a/src/utils/core/configurator/schema/v2fly.schema.ts
+++ b/src/utils/core/configurator/schema/v2fly.schema.ts
@@ -1,20 +1,20 @@
 import {z} from "zod";

-
-export const V2flySchema = z.object({
-    log: z.object({
+const LogObject = z.object({
    access: z.string().optional(),
    error: z.string().optional(),
    loglevel: z.enum(["debug", "info", "warning", "error", "none"]).optional(),
    dnsLog: z.boolean().optional(),
    maskAddress: z.enum(["quarter", "half", "full"]).optional()
-    }).optional(),
-    api: z.object({
+});
+
+const ApiObject = z.object({
    tag: z.string().optional(),
    listen: z.string().optional(),
    services: z.array(z.string()).optional()
-    }).optional(),
-    dns: z.object({
+});
+
+const DnsObject = z.object({
    hosts: z.record(z.string(), z.union([
        z.string(),
        z.array(z.string())
@@ -43,8 +43,9 @@ export const V2flySchema = z.object({
    disableFallbackIfMatch: z.boolean().optional(),
    useSystemHosts: z.boolean().optional(),
    tag: z.string().optional()
-    }).optional(),
-    routing: z.object({
+});
+
+const RoutingObject = z.object({
    domainStrategy: z.enum(["AsIs", "IPIfNonMatch", "IPOnDemand"]).optional(),
    domainMatcher: z.enum(["hybrid", "linear"]).optional(),
    rules: z.array(z.object({
@@ -67,8 +68,9 @@ export const V2flySchema = z.object({
        tag: z.string().optional(),
        selector: z.array(z.string()).optional()
    })).optional()
-    }).optional(),
-    policy: z.object({
+});
+
+const PolicyObject = z.object({
    levels: z.record(z.string(), z.object({
        handshake: z.number().optional(),
        connIdle: z.number().optional(),
@@ -85,8 +87,9 @@ export const V2flySchema = z.object({
        statsOutboundUplink: z.boolean().optional(),
        statsOutboundDownlink: z.boolean().optional()
    }).optional()
-    }).optional(),
-    inbounds: z.array(z.object({
+});
+
+const InboundObject = z.object({
    listen: z.string().optional(),
    port: z.union([z.number(), z.string()]).optional(),
    protocol: z.enum(["dokodemo-door", "http", "shadowsocks", "socks", "vless", "vmess", "trojan", "wireguard"]).optional(),
@@ -105,8 +108,9 @@ export const V2flySchema = z.object({
        refresh: z.number().optional(),
        concurrency: z.number().optional()
    }).optional()
-    })).optional(),
-    outbounds: z.array(z.object({
+});
+
+const OutboundObject = z.object({
    sendThrough: z.string().optional(),
    protocol: z.string().optional(),
    settings: z.record(z.string(), z.any()).optional(),
@@ -125,11 +129,9 @@ export const V2flySchema = z.object({
        "AsIs", "UseIP", "UseIPv6v4", "UseIPv6", "UseIPv4v6", "UseIPv4",
        "ForceIP", "ForceIPv6v4", "ForceIPv6", "ForceIPv4v6", "ForceIPv4"
    ]).optional()
-    })).optional(),
-    transport: z.object({
-        network: z.enum(["raw", "xhttp", "kcp", "grpc", "ws", "httpupgrade"]).optional(),
-        security: z.enum(["none", "tls", "reality"]).optional(),
-        tlsSettings: z.object({
+});
+
+const TlsSettingsObject = z.object({
    serverName: z.string().optional(),
    rejectUnknownSni: z.boolean().optional(),
    verifyPeerCertInNames: z.array(z.string()).optional(),
@@ -152,8 +154,9 @@ export const V2flySchema = z.object({
    fingerprint: z.string().optional(),
    pinnedPeerCertificateChainSha256: z.array(z.string()).optional(),
    masterKeyLog: z.string().optional()
-        }).optional(),
-        realitySettings: z.object({
+});
+
+const RealitySettingsObject = z.object({
    show: z.boolean().optional(),
    dest: z.string().optional(),
    xver: z.number().optional(),
@@ -168,14 +171,9 @@ export const V2flySchema = z.object({
    publicKey: z.string().optional(),
    shortId: z.string().optional(),
    spiderX: z.string().optional()
-        }).optional(),
-        rawSettings: z.object({}).optional(),
-        xhttpSettings: z.object({}).optional(),
-        kcpSettings: z.object({}).optional(),
-        grpcSettings: z.object({}).optional(),
-        wsSettings: z.object({}).optional(),
-        httpupgradeSettings: z.object({}).optional(),
-        sockopt: z.object({
+});
+
+const SockoptObject = z.object({
    mark: z.number().optional(),
    tcpMaxSeg: z.number().optional(),
    tcpFastOpen: z.boolean().optional(),
@@ -195,13 +193,28 @@ export const V2flySchema = z.object({
    tcpWindowClamp: z.number().optional(),
    tcpMptcp: z.boolean().optional(),
    tcpNoDelay: z.boolean().optional()
-        }).optional()
-    }).optional(),
-    stats: z.object({
+});
+
+const TransportObject = z.object({
+    network: z.enum(["raw", "xhttp", "kcp", "grpc", "ws", "httpupgrade"]).optional(),
+    security: z.enum(["none", "tls", "reality"]).optional(),
+    tlsSettings: TlsSettingsObject.optional(),
+    realitySettings: RealitySettingsObject.optional(),
+    rawSettings: z.object({}).optional(),
+    xhttpSettings: z.object({}).optional(),
+    kcpSettings: z.object({}).optional(),
+    grpcSettings: z.object({}).optional(),
+    wsSettings: z.object({}).optional(),
+    httpupgradeSettings: z.object({}).optional(),
+    sockopt: SockoptObject.optional()
+});
+
+const StatsObject = z.object({
    // StatsObject currently doesn't require any parameters
    // Internal statistics will be enabled as long as this object exists
-    }).optional(),
-    reverse: z.object({
+});
+
+const ReverseObject = z.object({
    bridges: z.array(z.object({
        tag: z.string().optional(),
        domain: z.string().optional()
@@ -210,8 +223,9 @@ export const V2flySchema = z.object({
        tag: z.string().optional(),
        domain: z.string().optional()
    })).optional()
-    }).optional(),
-    fakedns: z.union([
+});
+
+const FakeDnsObject = z.union([
    z.object({
        ipPool: z.string().optional(),
        poolSize: z.number().optional()
@@ -220,17 +234,20 @@ export const V2flySchema = z.object({
        ipPool: z.string(),
        poolSize: z.number().optional()
    }))
-    ]).optional(),
-    metrics: z.object({
+]);
+
+const MetricsObject = z.object({
    tag: z.string().optional()
-    }).optional(),
-    observatory: z.object({
+});
+
+const ObservatoryObject = z.object({
    subjectSelector: z.array(z.string()).optional(),
    probeUrl: z.string().optional(),
    probeInterval: z.string().optional(),
    enableConcurrency: z.boolean().optional()
-    }).optional(),
-    burstObservatory: z.object({
+});
+
+const BurstObservatoryObject = z.object({
    subjectSelector: z.array(z.string()).optional(),
    pingConfig: z.object({
        destination: z.string().optional(),
@@ -239,7 +256,23 @@ export const V2flySchema = z.object({
        sampling: z.number().optional(),
        timeout: z.string().optional()
    }).optional()
-    }).optional()
-})
+});
+
+export const V2flySchema = z.object({
+    log: LogObject.optional(),
+    api: ApiObject.optional(),
+    dns: DnsObject.optional(),
+    routing: RoutingObject.optional(),
+    policy: PolicyObject.optional(),
+    inbounds: z.array(InboundObject).optional(),
+    outbounds: z.array(OutboundObject).optional(),
+    transport: TransportObject.optional(),
+    stats: StatsObject.optional(),
+    reverse: ReverseObject.optional(),
+    fakedns: FakeDnsObject.optional(),
+    metrics: MetricsObject.optional(),
+    observatory: ObservatoryObject.optional(),
+    burstObservatory: BurstObservatoryObject.optional()
+});

 export type v2flyConfig = z.infer<typeof V2flySchema>;
--- a/src/utils/core/configurator/schema/xray.schema.ts
+++ b/src/utils/core/configurator/schema/xray.schema.ts
@@ -1,20 +1,20 @@
 import {z} from "zod";

-
-export const XraySchema = z.object({
-    log: z.object({
+const LogSchema = z.object({
    access: z.string().optional(),
    error: z.string().optional(),
    loglevel: z.enum(["debug", "info", "warning", "error", "none"]).optional(),
    dnsLog: z.boolean().optional(),
    maskAddress: z.enum(["quarter", "half", "full"]).optional()
-    }).optional(),
-    api: z.object({
+}).optional();
+
+const ApiSchema = z.object({
    tag: z.string().optional(),
    listen: z.string().optional(),
    services: z.array(z.string()).optional()
-    }).optional(),
-    dns: z.object({
+}).optional();
+
+const DnsSchema = z.object({
    hosts: z.record(z.string(), z.union([
        z.string(),
        z.array(z.string())
@@ -43,8 +43,9 @@ export const XraySchema = z.object({
    disableFallbackIfMatch: z.boolean().optional(),
    useSystemHosts: z.boolean().optional(),
    tag: z.string().optional()
-    }).optional(),
-    routing: z.object({
+}).optional();
+
+const RoutingSchema = z.object({
    domainStrategy: z.enum(["AsIs", "IPIfNonMatch", "IPOnDemand"]).optional(),
    domainMatcher: z.enum(["hybrid", "linear"]).optional(),
    rules: z.array(z.object({
@@ -67,8 +68,9 @@ export const XraySchema = z.object({
        tag: z.string().optional(),
        selector: z.array(z.string()).optional()
    })).optional()
-    }).optional(),
-    policy: z.object({
+}).optional();
+
+const PolicySchema = z.object({
    levels: z.record(z.string(), z.object({
        handshake: z.number().optional(),
        connIdle: z.number().optional(),
@@ -85,8 +87,9 @@ export const XraySchema = z.object({
        statsOutboundUplink: z.boolean().optional(),
        statsOutboundDownlink: z.boolean().optional()
    }).optional()
-    }).optional(),
-    inbounds: z.array(z.object({
+}).optional();
+
+const InboundSchema = z.object({
    listen: z.string().optional(),
    port: z.union([z.number(), z.string()]).optional(),
    protocol: z.enum(["dokodemo-door", "http", "shadowsocks", "socks", "vless", "vmess", "trojan", "wireguard"]).optional(),
@@ -105,8 +108,9 @@ export const XraySchema = z.object({
        refresh: z.number().optional(),
        concurrency: z.number().optional()
    }).optional()
-    })).optional(),
-    outbounds: z.array(z.object({
+});
+
+const OutboundSchema = z.object({
    sendThrough: z.string().optional(),
    protocol: z.string().optional(),
    settings: z.record(z.string(), z.any()).optional(),
@@ -125,8 +129,9 @@ export const XraySchema = z.object({
        "AsIs", "UseIP", "UseIPv6v4", "UseIPv6", "UseIPv4v6", "UseIPv4",
        "ForceIP", "ForceIPv6v4", "ForceIPv6", "ForceIPv4v6", "ForceIPv4"
    ]).optional()
-    })).optional(),
-    transport: z.object({
+});
+
+const TransportSchema = z.object({
    network: z.enum(["raw", "xhttp", "kcp", "grpc", "ws", "httpupgrade"]).optional(),
    security: z.enum(["none", "tls", "reality"]).optional(),
    tlsSettings: z.object({
@@ -196,12 +201,14 @@ export const XraySchema = z.object({
        tcpMptcp: z.boolean().optional(),
        tcpNoDelay: z.boolean().optional()
    }).optional()
-    }).optional(),
-    stats: z.object({
+}).optional();
+
+const StatsSchema = z.object({
    // StatsObject currently doesn't require any parameters
    // Internal statistics will be enabled as long as this object exists
-    }).optional(),
-    reverse: z.object({
+}).optional();
+
+const ReverseSchema = z.object({
    bridges: z.array(z.object({
        tag: z.string().optional(),
        domain: z.string().optional()
@@ -210,8 +217,9 @@ export const XraySchema = z.object({
        tag: z.string().optional(),
        domain: z.string().optional()
    })).optional()
-    }).optional(),
-    fakedns: z.union([
+}).optional();
+
+const FakeDnsSchema = z.union([
    z.object({
        ipPool: z.string().optional(),
        poolSize: z.number().optional()
@@ -220,17 +228,20 @@ export const XraySchema = z.object({
        ipPool: z.string(),
        poolSize: z.number().optional()
    }))
-    ]).optional(),
-    metrics: z.object({
+]).optional();
+
+const MetricsSchema = z.object({
    tag: z.string().optional()
-    }).optional(),
-    observatory: z.object({
+}).optional();
+
+const ObservatorySchema = z.object({
    subjectSelector: z.array(z.string()).optional(),
    probeUrl: z.string().optional(),
    probeInterval: z.string().optional(),
    enableConcurrency: z.boolean().optional()
-    }).optional(),
-    burstObservatory: z.object({
+}).optional();
+
+const BurstObservatorySchema = z.object({
    subjectSelector: z.array(z.string()).optional(),
    pingConfig: z.object({
        destination: z.string().optional(),
@@ -239,7 +250,23 @@ export const XraySchema = z.object({
        sampling: z.number().optional(),
        timeout: z.string().optional()
    }).optional()
-    }).optional()
-})
+}).optional();
+
+export const XraySchema = z.object({
+    log: LogSchema,
+    api: ApiSchema,
+    dns: DnsSchema,
+    routing: RoutingSchema,
+    policy: PolicySchema,
+    inbounds: z.array(InboundSchema).optional(),
+    outbounds: z.array(OutboundSchema).optional(),
+    transport: TransportSchema,
+    stats: StatsSchema,
+    reverse: ReverseSchema,
+    fakedns: FakeDnsSchema,
+    metrics: MetricsSchema,
+    observatory: ObservatorySchema,
+    burstObservatory: BurstObservatorySchema
+});

 export type xrayConfig = z.infer<typeof XraySchema>;