selcarpa/spary
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
- 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:
selcarpa
2026-01-04 14:30:07 +08:00
parent eeedce5b5c
commit 154823b2c4
2 changed files with 538 additions and 478 deletions
Download Patch File Download Diff File Expand all files Collapse all files

123
src/utils/core/configurator/schema/v2fly.schema.ts
View File

@@ -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>;

89
src/utils/core/configurator/schema/xray.schema.ts
View File

@@ -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>;