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
This commit is contained in:
2026-01-04 14:30:07 +08:00
parent eeedce5b5c
commit 154823b2c4
2 changed files with 538 additions and 478 deletions

View File

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

View File

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