跳转至

XHTTP / SplitHTTP 高级字段 完整字段索引

由配置源码生成

本页由 scripts/config-reference.pycore-config 的公开 Serde 结构生成,覆盖 YAML/JSON 实际接受的字段、重命名、别名、默认规则和 枚举写法。修改配置模型后必须重新生成;CI 会拒绝缺字段或过期页面。

XHTTP、下载通道、REALITY、TLS、XMUX、FinalMask 和包变换的完整长尾字段。

全手册当前覆盖 828 个字段55 个枚举类型。 行为说明和跨字段约束请同时阅读同分类下的人工手册页面。

XhttpListener

XHTTP 服务端监听配置。 settings 直接复用出站使用的完整 [XhttpConfig],不会把字段降级为 serde_json::Value 或字符串 map。TLS 的 cert / key 都是文件路径; 文件读取留给运行时,配置编译阶段负责要求路径非空且成对出现。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
enabled 布尔值 可选;默认 true 控制该配置块是否启用;关闭时保留配置但不启动对应运行时能力。 源码
address 字符串 可选;默认 127.0.0.1 host
bind
监听或连接使用的主机/IP 地址;是否允许域名由所在协议和校验阶段决定。 源码
port 0-65535 整数 必填 监听或连接使用的端口;0 是否允许由所在配置块校验。 源码
cleartext 布尔值 可选;默认 false 明确允许无 TLS 的 HTTP/1.1 或 h2c。默认 false,避免静默降级。 源码
allow-unauthenticated-non-loopback 布尔值 可选;默认 false allow_unauthenticated_non_loopback
allowUnauthenticatedNonLoopback
Raw 服务端尚未提供协议级认证;监听非回环地址时必须显式确认风险。 源码
tls XhttpListenTls(可选) 可选;默认不设置 XhttpListenertls 参数。解析类型为 XhttpListenTls(可选);组合约束由 wuther-core check 校验。 源码
alpn XhttpListenAlpn 列表 可选;默认 vec![XhttpListenAlpn::H2, XhttpListenAlpn::Http1] http/1.1
h2
h3
XhttpListeneralpn 参数。解析类型为 XhttpListenAlpn 列表;组合约束由 wuther-core check 校验。 源码
target XhttpListenTarget(可选) 可选;默认不设置 XHTTP 传输解封后的固定 TCP 目标。 VLESS、VMess、Trojan 等代理协议拥有各自的认证、编解码和 UDP 语义,必须在各协议监听中显式选择 XHTTP 传输;这里不会注册一个 没有真实服务端实现的 inner-protocol 枚举。 源码
tag 字符串(可选) 可选;默认不设置 用于显示、日志和其它配置项引用的稳定名称。 源码
accept-queue 非负整数 可选;默认 256 accept_queue
backlog
XhttpListeneraccept-queue 参数。解析类型为 非负整数;组合约束由 wuther-core check 校验。 源码
max-active-relays 非负整数 可选;默认 256 max_active_relays
maxActiveRelays
单个监听允许同时保持的活动 relay 上限。 源码
max-active-connections 非负整数 可选;默认 1024 max_active_connections
maxActiveConnections
单个监听允许同时保持的底层 TCP/TLS/QUIC 连接上限。 源码
max-concurrent-streams 非负整数 可选;默认 128 max_concurrent_streams
maxConcurrentStreams
单个 H2/H3 底层连接允许同时处理的 HTTP 流上限。 源码
max-active-http-streams 非负整数 可选;默认 1024 max_active_http_streams
maxActiveHttpStreams
单个监听跨全部底层连接允许同时处理的 HTTP 流上限。 源码
http-idle-timeout 时长 可选;默认 90s http_idle_timeout
httpIdleTimeout
已无活动 HTTP 请求/流时,底层连接可保持空闲的最长时间。 源码
cors-origins 字符串 列表(可选) 可选;默认不设置 cors_origins
corsOrigins
浏览器 CORS 策略。缺省时使用 XrayCompatible;显式空数组禁用 CORS; 非空数组为 allowlist,* 必须独占。 源码
streamSettings crate::NodeStreamSettings(可选) 可选;默认不设置 stream_settings Xray-compatible listener socket policy and final masks. TCP masks are applied before TLS; UDP masks and QUIC parameters are applied below H3. 源码
settings XhttpConfig 可选;使用类型默认值 config
xhttpSettings
xhttp-settings
splithttpSettings
splithttp-settings
XhttpListenersettings 参数。解析类型为 XhttpConfig;组合约束由 wuther-core check 校验。 源码

XhttpListenTarget

XHTTP Raw 内层透明字节隧道的固定目标。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
host 字符串 必填 address 监听或连接使用的主机/IP 地址;是否允许域名由所在协议和校验阶段决定。 源码
port 0-65535 整数 必填 监听或连接使用的端口;0 是否允许由所在配置块校验。 源码

XhttpListenTls

XhttpListenTls 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
cert 字符串(可选) 可选;默认不设置 certificate
cert-path
cert_path
旧版单证书 PEM 路径;与 certificates 中的 encipherment 条目互斥。 源码
key 字符串(可选) 可选;默认不设置 private-key
private_key
key-path
key_path
旧版单私钥 PEM 路径。 源码
settings(展开) XhttpDownloadTlsSettings 可选;使用类型默认值 Xray TLS 全量字段(证书、版本、套件、曲线、ECH、key log 等)。 源码
requireClientCertificate 布尔值(可选) 可选;默认不设置 require-client-certificate
require_client_certificate
使用 usage=verify 证书作为客户端 CA 并强制双向 TLS。 源码

XhttpRange

Xray Int32Range 的无损配置表示。 接受 JSON/YAML 整数(64)或范围字符串("64-128"),序列化时使用 同样的规范形式。XHTTP 的范围均为非负 int32;反向范围和溢出值直接报错, 不做静默交换。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
from 非负整数 必填 XhttpRangefrom 参数。解析类型为 非负整数;组合约束由 wuther-core check 校验。 源码
to 非负整数 必填 XhttpRangeto 参数。解析类型为 非负整数;组合约束由 wuther-core check 校验。 源码

XhttpXmuxConfig

XhttpXmuxConfig 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
maxConcurrency XhttpRange(可选) 可选;默认不设置 max-concurrency
max_concurrency
对应资源或并发量的硬上限,用于限制内存、连接或任务扩张。 源码
maxConnections XhttpRange(可选) 可选;默认不设置 max-connections
max_connections
对应资源或并发量的硬上限,用于限制内存、连接或任务扩张。 源码
cMaxReuseTimes XhttpRange(可选) 可选;默认不设置 c-max-reuse-times
c_max_reuse_times
XhttpXmuxConfigcMaxReuseTimes 参数。解析类型为 XhttpRange(可选);组合约束由 wuther-core check 校验。 源码
hMaxRequestTimes XhttpRange(可选) 可选;默认不设置 h-max-request-times
h_max_request_times
XhttpXmuxConfighMaxRequestTimes 参数。解析类型为 XhttpRange(可选);组合约束由 wuther-core check 校验。 源码
hMaxReusableSecs XhttpRange(可选) 可选;默认不设置 h-max-reusable-secs
h_max_reusable_secs
XhttpXmuxConfighMaxReusableSecs 参数。解析类型为 XhttpRange(可选);组合约束由 wuther-core check 校验。 源码
hKeepAlivePeriod 整数(可选) 可选;默认不设置 h-keep-alive-period
h_keep_alive_period
XhttpXmuxConfighKeepAlivePeriod 参数。解析类型为 整数(可选);组合约束由 wuther-core check 校验。 源码

XhttpSignedRange

Xray finalmask 使用的有符号范围。接受整数或 "from-to" 字符串。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
left 整数 必填 XhttpSignedRangeleft 参数。解析类型为 整数;组合约束由 wuther-core check 校验。 源码
right 整数 必填 XhttpSignedRangeright 参数。解析类型为 整数;组合约束由 wuther-core check 校验。 源码

XhttpDownloadTlsCertificate

XhttpDownloadTlsCertificate 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
certificateFile 字符串(可选) 可选;默认不设置 文件或 URL 路径;相对路径按运行进程的工作目录解析。 源码
certificate 字符串 列表(可选) 可选;默认不设置 XhttpDownloadTlsCertificatecertificate 参数。解析类型为 字符串 列表(可选);组合约束由 wuther-core check 校验。 源码
keyFile 字符串(可选) 可选;默认不设置 文件或 URL 路径;相对路径按运行进程的工作目录解析。 源码
key 字符串 列表(可选) 可选;默认不设置 XhttpDownloadTlsCertificatekey 参数。解析类型为 字符串 列表(可选);组合约束由 wuther-core check 校验。 源码
usage XhttpTlsCertificateUsage(可选) 可选;默认不设置 encipherment
verify
issue
XhttpDownloadTlsCertificateusage 参数。解析类型为 XhttpTlsCertificateUsage(可选);组合约束由 wuther-core check 校验。 源码
ocspStapling 非负整数(可选) 可选;默认不设置 XhttpDownloadTlsCertificateocspStapling 参数。解析类型为 非负整数(可选);组合约束由 wuther-core check 校验。 源码
oneTimeLoading 布尔值(可选) 可选;默认不设置 XhttpDownloadTlsCertificateoneTimeLoading 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
buildChain 布尔值(可选) 可选;默认不设置 XhttpDownloadTlsCertificatebuildChain 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码

XhttpDownloadCustomSockopt

XhttpDownloadCustomSockopt 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
system 字符串(可选) 可选;默认不设置 XhttpDownloadCustomSockoptsystem 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
network 字符串(可选) 可选;默认不设置 XhttpDownloadCustomSockoptnetwork 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
level 字符串(可选) 可选;默认不设置 XhttpDownloadCustomSockoptlevel 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
opt 字符串(可选) 可选;默认不设置 XhttpDownloadCustomSockoptopt 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
value 字符串(可选) 可选;默认不设置 XhttpDownloadCustomSockoptvalue 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
type 字符串(可选) 可选;默认不设置 XhttpDownloadCustomSockopttype 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码

XhttpDownloadHappyEyeballs

XhttpDownloadHappyEyeballs 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
prioritizeIPv6 布尔值(可选) 可选;默认不设置 XhttpDownloadHappyEyeballsprioritizeIPv6 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
tryDelayMs 非负整数(可选) 可选;默认不设置 XhttpDownloadHappyEyeballstryDelayMs 参数。解析类型为 非负整数(可选);组合约束由 wuther-core check 校验。 源码
interleave 非负整数(可选) 可选;默认不设置 XhttpDownloadHappyEyeballsinterleave 参数。解析类型为 非负整数(可选);组合约束由 wuther-core check 校验。 源码
maxConcurrentTry 非负整数(可选) 可选;默认不设置 对应资源或并发量的硬上限,用于限制内存、连接或任务扩张。 源码

XhttpMaskTransformArg

XhttpMaskTransformArg 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
type XhttpMaskPacketEncoding(可选) 可选;默认不设置 array
str
hex
base64
XhttpMaskTransformArgtype 参数。解析类型为 XhttpMaskPacketEncoding(可选);组合约束由 wuther-core check 校验。 源码
bytes XhttpMaskPacket(可选) 可选;默认不设置 Bytes(Vec<u8>)
Text(String)
XhttpMaskTransformArgbytes 参数。解析类型为 XhttpMaskPacket(可选);组合约束由 wuther-core check 校验。 源码
u64 非负整数(可选) 可选;默认不设置 XhttpMaskTransformArgu64 参数。解析类型为 非负整数(可选);组合约束由 wuther-core check 校验。 源码
reuse 字符串(可选) 可选;默认不设置 XhttpMaskTransformArgreuse 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
metadata 字符串(可选) 可选;默认不设置 XhttpMaskTransformArgmetadata 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
transform XhttpMaskTransform(可选) 可选;默认不设置 XhttpMaskTransformArgtransform 参数。解析类型为 XhttpMaskTransform(可选);组合约束由 wuther-core check 校验。 源码

XhttpMaskTransform

XhttpMaskTransform 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
op 字符串(可选) 可选;默认不设置 XhttpMaskTransformop 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
args XhttpMaskTransformArg 列表 可选;默认空 XhttpMaskTransformargs 参数。解析类型为 XhttpMaskTransformArg 列表;组合约束由 wuther-core check 校验。 源码

XhttpMaskTcpItem

XhttpMaskTcpItem 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
delay XhttpSignedRange(可选) 可选;默认不设置 XhttpMaskTcpItemdelay 参数。解析类型为 XhttpSignedRange(可选);组合约束由 wuther-core check 校验。 源码
rand 整数(可选) 可选;默认不设置 XhttpMaskTcpItemrand 参数。解析类型为 整数(可选);组合约束由 wuther-core check 校验。 源码
randRange XhttpSignedRange(可选) 可选;默认不设置 XhttpMaskTcpItemrandRange 参数。解析类型为 XhttpSignedRange(可选);组合约束由 wuther-core check 校验。 源码
capture 字符串(可选) 可选;默认不设置 XhttpMaskTcpItemcapture 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
type XhttpMaskPacketEncoding(可选) 可选;默认不设置 array
str
hex
base64
XhttpMaskTcpItemtype 参数。解析类型为 XhttpMaskPacketEncoding(可选);组合约束由 wuther-core check 校验。 源码
reuse 字符串(可选) 可选;默认不设置 XhttpMaskTcpItemreuse 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
transform XhttpMaskTransform(可选) 可选;默认不设置 XhttpMaskTcpItemtransform 参数。解析类型为 XhttpMaskTransform(可选);组合约束由 wuther-core check 校验。 源码
packet XhttpMaskPacket(可选) 可选;默认不设置 Bytes(Vec<u8>)
Text(String)
XhttpMaskTcpItempacket 参数。解析类型为 XhttpMaskPacket(可选);组合约束由 wuther-core check 校验。 源码

XhttpHeaderCustomTcp

XhttpHeaderCustomTcp 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
clients Vec<XhttpMaskTcpItem> 列表 可选;默认空 XhttpHeaderCustomTcpclients 参数。解析类型为 Vec<XhttpMaskTcpItem> 列表;组合约束由 wuther-core check 校验。 源码
servers Vec<XhttpMaskTcpItem> 列表 可选;默认空 XhttpHeaderCustomTcpservers 参数。解析类型为 Vec<XhttpMaskTcpItem> 列表;组合约束由 wuther-core check 校验。 源码
errors Vec<XhttpMaskTcpItem> 列表 可选;默认空 XhttpHeaderCustomTcperrors 参数。解析类型为 Vec<XhttpMaskTcpItem> 列表;组合约束由 wuther-core check 校验。 源码

XhttpFragmentMask

XhttpFragmentMask 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
packets 字符串(可选) 可选;默认不设置 XhttpFragmentMaskpackets 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
length XhttpSignedRange(可选) 可选;默认不设置 XhttpFragmentMasklength 参数。解析类型为 XhttpSignedRange(可选);组合约束由 wuther-core check 校验。 源码
delay XhttpSignedRange(可选) 可选;默认不设置 XhttpFragmentMaskdelay 参数。解析类型为 XhttpSignedRange(可选);组合约束由 wuther-core check 校验。 源码
lengths XhttpSignedRange 列表 可选;默认空 XhttpFragmentMasklengths 参数。解析类型为 XhttpSignedRange 列表;组合约束由 wuther-core check 校验。 源码
delays XhttpSignedRange 列表 可选;默认空 XhttpFragmentMaskdelays 参数。解析类型为 XhttpSignedRange 列表;组合约束由 wuther-core check 校验。 源码
maxSplit XhttpSignedRange(可选) 可选;默认不设置 对应资源或并发量的硬上限,用于限制内存、连接或任务扩张。 源码

XhttpSudokuMask

XhttpSudokuMask 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
password 字符串(可选) 可选;默认不设置 敏感认证材料;不要写入公开仓库、日志或截图。 源码
ascii 字符串(可选) 可选;默认不设置 XhttpSudokuMaskascii 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
customTable 字符串(可选) 可选;默认不设置 custom_table XhttpSudokuMaskcustomTable 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
customTables 字符串 列表 可选;默认空 custom_tables XhttpSudokuMaskcustomTables 参数。解析类型为 字符串 列表;组合约束由 wuther-core check 校验。 源码
paddingMin 非负整数(可选) 可选;默认不设置 padding_min XhttpSudokuMaskpaddingMin 参数。解析类型为 非负整数(可选);组合约束由 wuther-core check 校验。 源码
paddingMax 非负整数(可选) 可选;默认不设置 padding_max XhttpSudokuMaskpaddingMax 参数。解析类型为 非负整数(可选);组合约束由 wuther-core check 校验。 源码

XhttpXmcMask

XhttpXmcMask 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
hostname 字符串(可选) 可选;默认不设置 XhttpXmcMaskhostname 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
usernames 字符串 列表 可选;默认空 XhttpXmcMaskusernames 参数。解析类型为 字符串 列表;组合约束由 wuther-core check 校验。 源码
password 字符串(可选) 可选;默认不设置 敏感认证材料;不要写入公开仓库、日志或截图。 源码

XhttpMaskUdpItem

XhttpMaskUdpItem 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
rand 整数(可选) 可选;默认不设置 XhttpMaskUdpItemrand 参数。解析类型为 整数(可选);组合约束由 wuther-core check 校验。 源码
randRange XhttpSignedRange(可选) 可选;默认不设置 XhttpMaskUdpItemrandRange 参数。解析类型为 XhttpSignedRange(可选);组合约束由 wuther-core check 校验。 源码
capture 字符串(可选) 可选;默认不设置 XhttpMaskUdpItemcapture 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
type XhttpMaskPacketEncoding(可选) 可选;默认不设置 array
str
hex
base64
XhttpMaskUdpItemtype 参数。解析类型为 XhttpMaskPacketEncoding(可选);组合约束由 wuther-core check 校验。 源码
reuse 字符串(可选) 可选;默认不设置 XhttpMaskUdpItemreuse 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
transform XhttpMaskTransform(可选) 可选;默认不设置 XhttpMaskUdpItemtransform 参数。解析类型为 XhttpMaskTransform(可选);组合约束由 wuther-core check 校验。 源码
packet XhttpMaskPacket(可选) 可选;默认不设置 Bytes(Vec<u8>)
Text(String)
XhttpMaskUdpItempacket 参数。解析类型为 XhttpMaskPacket(可选);组合约束由 wuther-core check 校验。 源码

XhttpHeaderCustomUdp

XhttpHeaderCustomUdp 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
mode 字符串(可选) 可选;默认不设置 XhttpHeaderCustomUdpmode 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
client XhttpMaskUdpItem 列表 可选;默认空 XhttpHeaderCustomUdpclient 参数。解析类型为 XhttpMaskUdpItem 列表;组合约束由 wuther-core check 校验。 源码
server XhttpMaskUdpItem 列表 可选;默认空 监听或连接使用的主机/IP 地址;是否允许域名由所在协议和校验阶段决定。 源码

XhttpMkcpLegacyMask

XhttpMkcpLegacyMask 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
header 字符串(可选) 可选;默认不设置 XhttpMkcpLegacyMaskheader 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
value 字符串(可选) 可选;默认不设置 XhttpMkcpLegacyMaskvalue 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码

XhttpNoiseItem

XhttpNoiseItem 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
rand XhttpSignedRange(可选) 可选;默认不设置 XhttpNoiseItemrand 参数。解析类型为 XhttpSignedRange(可选);组合约束由 wuther-core check 校验。 源码
randRange XhttpSignedRange(可选) 可选;默认不设置 XhttpNoiseItemrandRange 参数。解析类型为 XhttpSignedRange(可选);组合约束由 wuther-core check 校验。 源码
type XhttpMaskPacketEncoding(可选) 可选;默认不设置 array
str
hex
base64
XhttpNoiseItemtype 参数。解析类型为 XhttpMaskPacketEncoding(可选);组合约束由 wuther-core check 校验。 源码
packet XhttpMaskPacket(可选) 可选;默认不设置 Bytes(Vec<u8>)
Text(String)
XhttpNoiseItempacket 参数。解析类型为 XhttpMaskPacket(可选);组合约束由 wuther-core check 校验。 源码
delay XhttpSignedRange(可选) 可选;默认不设置 XhttpNoiseItemdelay 参数。解析类型为 XhttpSignedRange(可选);组合约束由 wuther-core check 校验。 源码

XhttpNoiseMask

XhttpNoiseMask 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
reset XhttpSignedRange(可选) 可选;默认不设置 XhttpNoiseMaskreset 参数。解析类型为 XhttpSignedRange(可选);组合约束由 wuther-core check 校验。 源码
noise XhttpNoiseItem 列表 可选;默认空 XhttpNoiseMasknoise 参数。解析类型为 XhttpNoiseItem 列表;组合约束由 wuther-core check 校验。 源码

XhttpSalamanderMask

XhttpSalamanderMask 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
password 字符串(可选) 可选;默认不设置 敏感认证材料;不要写入公开仓库、日志或截图。 源码
packetSize XhttpSignedRange(可选) 可选;默认不设置 XhttpSalamanderMaskpacketSize 参数。解析类型为 XhttpSignedRange(可选);组合约束由 wuther-core check 校验。 源码

XhttpXdnsMask

XhttpXdnsMask 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
domain XhttpMaskDomain(可选) 可选;默认不设置 One(String)
Many(Vec<String>)
XhttpXdnsMaskdomain 参数。解析类型为 XhttpMaskDomain(可选);组合约束由 wuther-core check 校验。 源码
domains 字符串 列表 可选;默认空 XhttpXdnsMaskdomains 参数。解析类型为 字符串 列表;组合约束由 wuther-core check 校验。 源码
resolvers 字符串 列表 可选;默认空 XhttpXdnsMaskresolvers 参数。解析类型为 字符串 列表;组合约束由 wuther-core check 校验。 源码

XhttpXicmpMask

XhttpXicmpMask 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
dgram 布尔值(可选) 可选;默认不设置 XhttpXicmpMaskdgram 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
ips 字符串 列表 可选;默认空 XhttpXicmpMaskips 参数。解析类型为 字符串 列表;组合约束由 wuther-core check 校验。 源码

XhttpRealmMask

XhttpRealmMask 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
url 字符串(可选) 可选;默认不设置 XhttpRealmMaskurl 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
stunServers 字符串 列表 可选;默认空 XhttpRealmMaskstunServers 参数。解析类型为 字符串 列表;组合约束由 wuther-core check 校验。 源码
tlsConfig XhttpDownloadTlsSettings(可选) 可选;默认不设置 XhttpRealmMasktlsConfig 参数。解析类型为 XhttpDownloadTlsSettings(可选);组合约束由 wuther-core check 校验。 源码

XhttpUdpHop

XhttpUdpHop 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
ports XhttpPortList(可选) 可选;默认不设置 One(u16)
List(String)
XhttpUdpHopports 参数。解析类型为 XhttpPortList(可选);组合约束由 wuther-core check 校验。 源码
interval XhttpSignedRange(可选) 可选;默认不设置 XhttpUdpHopinterval 参数。解析类型为 XhttpSignedRange(可选);组合约束由 wuther-core check 校验。 源码

XhttpQuicParams

XhttpQuicParams 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
congestion 字符串(可选) 可选;默认不设置 XhttpQuicParamscongestion 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
debug 布尔值(可选) 可选;默认不设置 XhttpQuicParamsdebug 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
bbrProfile 字符串(可选) 可选;默认不设置 XhttpQuicParamsbbrProfile 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
brutalUp 字符串(可选) 可选;默认不设置 XhttpQuicParamsbrutalUp 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
brutalDown 字符串(可选) 可选;默认不设置 XhttpQuicParamsbrutalDown 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
udpHop XhttpUdpHop(可选) 可选;默认不设置 XhttpQuicParamsudpHop 参数。解析类型为 XhttpUdpHop(可选);组合约束由 wuther-core check 校验。 源码
initStreamReceiveWindow 非负整数(可选) 可选;默认不设置 XhttpQuicParamsinitStreamReceiveWindow 参数。解析类型为 非负整数(可选);组合约束由 wuther-core check 校验。 源码
maxStreamReceiveWindow 非负整数(可选) 可选;默认不设置 对应资源或并发量的硬上限,用于限制内存、连接或任务扩张。 源码
initConnectionReceiveWindow 非负整数(可选) 可选;默认不设置 XhttpQuicParamsinitConnectionReceiveWindow 参数。解析类型为 非负整数(可选);组合约束由 wuther-core check 校验。 源码
maxConnectionReceiveWindow 非负整数(可选) 可选;默认不设置 对应资源或并发量的硬上限,用于限制内存、连接或任务扩张。 源码
maxIdleTimeout 整数(可选) 可选;默认不设置 超时上限;时长字段接受 mssmh 等 humantime 写法。 源码
keepAlivePeriod 整数(可选) 可选;默认不设置 XhttpQuicParamskeepAlivePeriod 参数。解析类型为 整数(可选);组合约束由 wuther-core check 校验。 源码
disablePathMTUDiscovery 布尔值(可选) 可选;默认不设置 XhttpQuicParamsdisablePathMTUDiscovery 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
maxIncomingStreams 整数(可选) 可选;默认不设置 对应资源或并发量的硬上限,用于限制内存、连接或任务扩张。 源码

XhttpFinalMask

XhttpFinalMask 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
tcp XhttpTcpMask 列表 可选;默认空 header-custom{ #[serde(default)] settings: XhttpHeaderCustomTcp, }
fragment{ #[serde(default)] settings: XhttpFragmentMask, }
sudoku{ #[serde(default)] settings: XhttpSudokuMask, }
xmc{ #[serde(default)] settings: XhttpXmcMask, }
XhttpFinalMasktcp 参数。解析类型为 XhttpTcpMask 列表;组合约束由 wuther-core check 校验。 源码
udp XhttpUdpMask 列表 可选;默认空 header-custom{ #[serde(default)] settings: XhttpHeaderCustomUdp, }
mkcp-legacy{ #[serde(default)] settings: XhttpMkcpLegacyMask, }
noise{ #[serde(default)] settings: XhttpNoiseMask, }
salamander{ #[serde(default)] settings: XhttpSalamanderMask, }
sudoku{ #[serde(default)] settings: XhttpSudokuMask, }
xdns{ #[serde(default)] settings: XhttpXdnsMask, }
xicmp{ #[serde(default)] settings: XhttpXicmpMask, }
realm{ #[serde(default)] settings: XhttpRealmMask, }
XhttpFinalMaskudp 参数。解析类型为 XhttpUdpMask 列表;组合约束由 wuther-core check 校验。 源码
quicParams XhttpQuicParams(可选) 可选;默认不设置 XhttpFinalMaskquicParams 参数。解析类型为 XhttpQuicParams(可选);组合约束由 wuther-core check 校验。 源码

XhttpDownloadTlsSettings

XhttpDownloadTlsSettings 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
certificates XhttpDownloadTlsCertificate 列表 可选;默认空 XhttpDownloadTlsSettingscertificates 参数。解析类型为 XhttpDownloadTlsCertificate 列表;组合约束由 wuther-core check 校验。 源码
serverName 字符串(可选) 可选;默认不设置 server-name
server_name
sni
XhttpDownloadTlsSettingsserverName 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
allowInsecure 布尔值(可选) 可选;默认不设置 allow-insecure
allow_insecure
insecure
skip-cert-verify
XhttpDownloadTlsSettingsallowInsecure 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
alpn 字符串 列表(可选) 可选;默认不设置 XhttpDownloadTlsSettingsalpn 参数。解析类型为 字符串 列表(可选);组合约束由 wuther-core check 校验。 源码
enableSessionResumption 布尔值(可选) 可选;默认不设置 enable-session-resumption
enable_session_resumption
XhttpDownloadTlsSettingsenableSessionResumption 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
disableSystemRoot 布尔值(可选) 可选;默认不设置 disable-system-root
disable_system_root
XhttpDownloadTlsSettingsdisableSystemRoot 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
minVersion 字符串(可选) 可选;默认不设置 min-version
min_version
对应范围或资源量的下限。 源码
maxVersion 字符串(可选) 可选;默认不设置 max-version
max_version
对应资源或并发量的硬上限,用于限制内存、连接或任务扩张。 源码
cipherSuites 字符串(可选) 可选;默认不设置 cipher-suites
cipher_suites
XhttpDownloadTlsSettingscipherSuites 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
fingerprint 字符串(可选) 可选;默认不设置 XhttpDownloadTlsSettingsfingerprint 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
rejectUnknownSni 布尔值(可选) 可选;默认不设置 rejectUnknownSNI
reject-unknown-sni
reject_unknown_sni
XhttpDownloadTlsSettingsrejectUnknownSni 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
curvePreferences 字符串 列表(可选) 可选;默认不设置 curve-preferences
curve_preferences
XhttpDownloadTlsSettingscurvePreferences 参数。解析类型为 字符串 列表(可选);组合约束由 wuther-core check 校验。 源码
masterKeyLog 字符串(可选) 可选;默认不设置 master-key-log
master_key_log
XhttpDownloadTlsSettingsmasterKeyLog 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
pinnedPeerCertSha256 字符串(可选) 可选;默认不设置 pinned-peer-cert-sha256
pinned_peer_cert_sha256
XhttpDownloadTlsSettingspinnedPeerCertSha256 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
verifyPeerCertByName 字符串(可选) 可选;默认不设置 verify-peer-cert-by-name
verify_peer_cert_by_name
XhttpDownloadTlsSettingsverifyPeerCertByName 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
echServerKeys 字符串(可选) 可选;默认不设置 ech-server-keys
ech_server_keys
XhttpDownloadTlsSettingsechServerKeys 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
echConfigList 字符串(可选) 可选;默认不设置 ech-config-list
ech_config_list
XhttpDownloadTlsSettingsechConfigList 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
echSockopt XhttpDownloadSocketSettings(可选) 可选;默认不设置 ech-sockopt
ech_sockopt
echSocketSettings
ech-socket-settings
ech_socket_settings
XhttpDownloadTlsSettingsechSockopt 参数。解析类型为 XhttpDownloadSocketSettings(可选);组合约束由 wuther-core check 校验。 源码

XhttpRealityLimitFallback

XhttpRealityLimitFallback 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
afterBytes 非负整数(可选) 可选;默认不设置 XhttpRealityLimitFallbackafterBytes 参数。解析类型为 非负整数(可选);组合约束由 wuther-core check 校验。 源码
bytesPerSec 非负整数(可选) 可选;默认不设置 XhttpRealityLimitFallbackbytesPerSec 参数。解析类型为 非负整数(可选);组合约束由 wuther-core check 校验。 源码
burstBytesPerSec 非负整数(可选) 可选;默认不设置 XhttpRealityLimitFallbackburstBytesPerSec 参数。解析类型为 非负整数(可选);组合约束由 wuther-core check 校验。 源码

XhttpDownloadRealitySettings

XhttpDownloadRealitySettings 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
masterKeyLog 字符串(可选) 可选;默认不设置 XhttpDownloadRealitySettingsmasterKeyLog 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
show 布尔值(可选) 可选;默认不设置 XhttpDownloadRealitySettingsshow 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
target XhttpRealityTarget(可选) 可选;默认不设置 Port(u16)
Address(String)
XhttpDownloadRealitySettingstarget 参数。解析类型为 XhttpRealityTarget(可选);组合约束由 wuther-core check 校验。 源码
dest XhttpRealityTarget(可选) 可选;默认不设置 Port(u16)
Address(String)
XhttpDownloadRealitySettingsdest 参数。解析类型为 XhttpRealityTarget(可选);组合约束由 wuther-core check 校验。 源码
type 字符串(可选) 可选;默认不设置 XhttpDownloadRealitySettingstype 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
xver 非负整数(可选) 可选;默认不设置 XhttpDownloadRealitySettingsxver 参数。解析类型为 非负整数(可选);组合约束由 wuther-core check 校验。 源码
serverNames 字符串 列表 可选;默认空 XhttpDownloadRealitySettingsserverNames 参数。解析类型为 字符串 列表;组合约束由 wuther-core check 校验。 源码
privateKey 字符串(可选) 可选;默认不设置 敏感认证材料;不要写入公开仓库、日志或截图。 源码
minClientVer 字符串(可选) 可选;默认不设置 对应范围或资源量的下限。 源码
maxClientVer 字符串(可选) 可选;默认不设置 对应资源或并发量的硬上限,用于限制内存、连接或任务扩张。 源码
maxTimeDiff 非负整数(可选) 可选;默认不设置 对应资源或并发量的硬上限,用于限制内存、连接或任务扩张。 源码
shortIds 字符串 列表 可选;默认空 XhttpDownloadRealitySettingsshortIds 参数。解析类型为 字符串 列表;组合约束由 wuther-core check 校验。 源码
mldsa65Seed 字符串(可选) 可选;默认不设置 XhttpDownloadRealitySettingsmldsa65Seed 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
limitFallbackUpload XhttpRealityLimitFallback(可选) 可选;默认不设置 XhttpDownloadRealitySettingslimitFallbackUpload 参数。解析类型为 XhttpRealityLimitFallback(可选);组合约束由 wuther-core check 校验。 源码
limitFallbackDownload XhttpRealityLimitFallback(可选) 可选;默认不设置 XhttpDownloadRealitySettingslimitFallbackDownload 参数。解析类型为 XhttpRealityLimitFallback(可选);组合约束由 wuther-core check 校验。 源码
serverName 字符串(可选) 可选;默认不设置 server-name
server_name
sni
XhttpDownloadRealitySettingsserverName 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
password 字符串(可选) 可选;默认不设置 敏感认证材料;不要写入公开仓库、日志或截图。 源码
publicKey 字符串(可选) 可选;默认不设置 public-key
public_key
XhttpDownloadRealitySettingspublicKey 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
shortId 字符串(可选) 可选;默认不设置 short-id
short_id
XhttpDownloadRealitySettingsshortId 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
fingerprint 字符串(可选) 可选;默认不设置 XhttpDownloadRealitySettingsfingerprint 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
mldsa65Verify 字符串(可选) 可选;默认不设置 XhttpDownloadRealitySettingsmldsa65Verify 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
spiderX 字符串(可选) 可选;默认不设置 spider-x
spider_x
XhttpDownloadRealitySettingsspiderX 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码

XhttpDownloadSocketSettings

XhttpDownloadSocketSettings 配置对象。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
mark 整数(可选) 可选;默认不设置 XhttpDownloadSocketSettingsmark 参数。解析类型为 整数(可选);组合约束由 wuther-core check 校验。 源码
tcpFastOpen XhttpTcpFastOpen(可选) 可选;默认不设置 tfo Enabled(bool)
QueueLength(i32)
XhttpDownloadSocketSettingstcpFastOpen 参数。解析类型为 XhttpTcpFastOpen(可选);组合约束由 wuther-core check 校验。 源码
tproxy XhttpTproxyMode(可选) 可选;默认不设置 off
tproxy
redirect
XhttpDownloadSocketSettingstproxy 参数。解析类型为 XhttpTproxyMode(可选);组合约束由 wuther-core check 校验。 源码
acceptProxyProtocol 布尔值(可选) 可选;默认不设置 XhttpDownloadSocketSettingsacceptProxyProtocol 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
tcpMptcp 布尔值(可选) 可选;默认不设置 tcp-mptcp
tcp_mptcp
mptcp
XhttpDownloadSocketSettingstcpMptcp 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
v6only 布尔值(可选) 可选;默认不设置 XhttpDownloadSocketSettingsv6only 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
interface 字符串(可选) 可选;默认不设置 XhttpDownloadSocketSettingsinterface 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
domainStrategy XhttpDomainStrategy(可选) 可选;默认不设置 domain-strategy
domain_strategy
ip-family
ip_family
AsIs
UseIP
UseIPv4
UseIPv6
UseIPv4v6
UseIPv6v4
ForceIP
ForceIPv4
ForceIPv6
ForceIPv4v6
ForceIPv6v4
XhttpDownloadSocketSettingsdomainStrategy 参数。解析类型为 XhttpDomainStrategy(可选);组合约束由 wuther-core check 校验。 源码
dialerProxy 字符串(可选) 可选;默认不设置 dialer-proxy
dialer_proxy
XhttpDownloadSocketSettingsdialerProxy 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
tcpKeepAliveInterval 整数(可选) 可选;默认不设置 tcp-keep-alive-interval
tcp_keep_alive_interval
周期性任务的执行间隔;时长字段接受 humantime 写法。 源码
tcpKeepAliveIdle 整数(可选) 可选;默认不设置 tcp-keep-alive-idle
tcp_keep_alive_idle
XhttpDownloadSocketSettingstcpKeepAliveIdle 参数。解析类型为 整数(可选);组合约束由 wuther-core check 校验。 源码
tcpWindowClamp 整数(可选) 可选;默认不设置 XhttpDownloadSocketSettingstcpWindowClamp 参数。解析类型为 整数(可选);组合约束由 wuther-core check 校验。 源码
tcpUserTimeout 整数(可选) 可选;默认不设置 tcp-user-timeout
tcp_user_timeout
超时上限;时长字段接受 mssmh 等 humantime 写法。 源码
tcpMaxSeg 整数(可选) 可选;默认不设置 tcp-max-seg
tcp_max_seg
XhttpDownloadSocketSettingstcpMaxSeg 参数。解析类型为 整数(可选);组合约束由 wuther-core check 校验。 源码
tcpCongestion 字符串(可选) 可选;默认不设置 tcp-congestion
tcp_congestion
XhttpDownloadSocketSettingstcpCongestion 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
penetrate 布尔值(可选) 可选;默认不设置 XhttpDownloadSocketSettingspenetrate 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
customSockopt XhttpDownloadCustomSockopt 列表 可选;默认空 XhttpDownloadSocketSettingscustomSockopt 参数。解析类型为 XhttpDownloadCustomSockopt 列表;组合约束由 wuther-core check 校验。 源码
addressPortStrategy XhttpAddressPortStrategy(可选) 可选;默认不设置 none
srvPortOnly
srvAddressOnly
srvPortAndAddress
txtPortOnly
txtAddressOnly
txtPortAndAddress
XhttpDownloadSocketSettingsaddressPortStrategy 参数。解析类型为 XhttpAddressPortStrategy(可选);组合约束由 wuther-core check 校验。 源码
happyEyeballs XhttpDownloadHappyEyeballs(可选) 可选;默认不设置 XhttpDownloadSocketSettingshappyEyeballs 参数。解析类型为 XhttpDownloadHappyEyeballs(可选);组合约束由 wuther-core check 校验。 源码
trustedXForwardedFor 字符串 列表 可选;默认空 XhttpDownloadSocketSettingstrustedXForwardedFor 参数。解析类型为 字符串 列表;组合约束由 wuther-core check 校验。 源码

XhttpDownloadSettings

Xray internet.StreamConfig 在 XHTTP downloadSettings 中可执行的强类型子集。 下载方向可指定独立目标、传输和安全参数;xhttpSettingstransport.xhttp 都是强类型 XHTTP 配置。兼容输入可同时提供两种别名, 但解析 extra 后的有效配置必须等价。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
address 字符串(可选) 可选;默认不设置 server 监听或连接使用的主机/IP 地址;是否允许域名由所在协议和校验阶段决定。 源码
host 字符串(可选) 可选;默认不设置 监听或连接使用的主机/IP 地址;是否允许域名由所在协议和校验阶段决定。 源码
port 0-65535 整数(可选) 可选;默认不设置 监听或连接使用的端口;0 是否允许由所在配置块校验。 源码
method 字符串(可选) 可选;默认不设置 XhttpDownloadSettingsmethod 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
network 字符串(可选) 可选;默认不设置 protocolName
protocol-name
protocol_name
XhttpDownloadSettingsnetwork 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
transport NodeTransport(可选) 可选;默认不设置 transportSettings
transport-settings
transport_settings
XhttpDownloadSettingstransport 参数。解析类型为 NodeTransport(可选);组合约束由 wuther-core check 校验。 源码
xhttpSettings XhttpConfig(可选) 可选;默认不设置 xhttp-settings
splithttpSettings
splithttp-settings
XhttpDownloadSettingsxhttpSettings 参数。解析类型为 XhttpConfig(可选);组合约束由 wuther-core check 校验。 源码
security 字符串(可选) 可选;默认不设置 XhttpDownloadSettingssecurity 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
tlsSettings XhttpDownloadTlsSettings(可选) 可选;默认不设置 tls-settings
tls_settings
XhttpDownloadSettingstlsSettings 参数。解析类型为 XhttpDownloadTlsSettings(可选);组合约束由 wuther-core check 校验。 源码
realitySettings XhttpDownloadRealitySettings(可选) 可选;默认不设置 reality-settings
reality_settings
XhttpDownloadSettingsrealitySettings 参数。解析类型为 XhttpDownloadRealitySettings(可选);组合约束由 wuther-core check 校验。 源码
alpn 字符串 列表(可选) 可选;默认不设置 XhttpDownloadSettingsalpn 参数。解析类型为 字符串 列表(可选);组合约束由 wuther-core check 校验。 源码
sockopt XhttpDownloadSocketSettings(可选) 可选;默认不设置 socketSettings
socket-settings
socket_settings
XhttpDownloadSettingssockopt 参数。解析类型为 XhttpDownloadSocketSettings(可选);组合约束由 wuther-core check 校验。 源码
finalmask XhttpFinalMask(可选) 可选;默认不设置 finalMask XhttpDownloadSettingsfinalmask 参数。解析类型为 XhttpFinalMask(可选);组合约束由 wuther-core check 校验。 源码

XhttpConfig

Xray XHTTP/SplitHTTP 完整配置。 字段规范名使用 Xray JSON camelCase;同时接受 Friendly YAML 使用过的 kebab-case 与早期 snake_case 名称。没有 Value/任意 map 逃生字段。

查看权威源码

YAML / JSON 字段 类型 必填与默认 兼容别名 取值 / 形态 解析与用途
host 字符串(可选) 可选;默认不设置 监听或连接使用的主机/IP 地址;是否允许域名由所在协议和校验阶段决定。 源码
path 字符串(可选) 可选;默认不设置 文件或 URL 路径;相对路径按运行进程的工作目录解析。 源码
mode 字符串(可选) 可选;默认不设置 XhttpConfigmode 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
headers 名称 → 字符串 映射(可选) 可选;默认不设置 XhttpConfigheaders 参数。解析类型为 名称 → 字符串 映射(可选);组合约束由 wuther-core check 校验。 源码
xPaddingBytes XhttpRange(可选) 可选;默认不设置 x-padding-bytes
x_padding_bytes
XhttpConfigxPaddingBytes 参数。解析类型为 XhttpRange(可选);组合约束由 wuther-core check 校验。 源码
xPaddingObfsMode 布尔值(可选) 可选;默认不设置 x-padding-obfs-mode
x_padding_obfs_mode
XhttpConfigxPaddingObfsMode 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
xPaddingKey 字符串(可选) 可选;默认不设置 x-padding-key
x_padding_key
XhttpConfigxPaddingKey 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
xPaddingHeader 字符串(可选) 可选;默认不设置 x-padding-header
x_padding_header
XhttpConfigxPaddingHeader 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
xPaddingPlacement 字符串(可选) 可选;默认不设置 x-padding-placement
x_padding_placement
XhttpConfigxPaddingPlacement 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
xPaddingMethod 字符串(可选) 可选;默认不设置 x-padding-method
x_padding_method
XhttpConfigxPaddingMethod 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
uplinkHTTPMethod 字符串(可选) 可选;默认不设置 uplinkHttpMethod
uplink-http-method
uplink_http_method
XhttpConfiguplinkHTTPMethod 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
sessionIDPlacement 字符串(可选) 可选;默认不设置 sessionIdPlacement
session-placement
session-id-placement
session_id_placement
XhttpConfigsessionIDPlacement 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
sessionIDKey 字符串(可选) 可选;默认不设置 sessionIdKey
session-key
session-id-key
session_id_key
XhttpConfigsessionIDKey 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
sessionIDTable 字符串(可选) 可选;默认不设置 sessionIdTable
session-table
session-id-table
session_id_table
XhttpConfigsessionIDTable 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
sessionIDLength XhttpRange(可选) 可选;默认不设置 sessionIdLength
session-length
session-id-length
session_id_length
XhttpConfigsessionIDLength 参数。解析类型为 XhttpRange(可选);组合约束由 wuther-core check 校验。 源码
seqPlacement 字符串(可选) 可选;默认不设置 seq-placement
seq_placement
XhttpConfigseqPlacement 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
seqKey 字符串(可选) 可选;默认不设置 seq-key
seq_key
XhttpConfigseqKey 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
uplinkDataPlacement 字符串(可选) 可选;默认不设置 uplink-data-placement
uplink_data_placement
XhttpConfiguplinkDataPlacement 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
uplinkDataKey 字符串(可选) 可选;默认不设置 uplink-data-key
uplink_data_key
XhttpConfiguplinkDataKey 参数。解析类型为 字符串(可选);组合约束由 wuther-core check 校验。 源码
uplinkChunkSize XhttpRange(可选) 可选;默认不设置 uplink-chunk-size
uplink_chunk_size
XhttpConfiguplinkChunkSize 参数。解析类型为 XhttpRange(可选);组合约束由 wuther-core check 校验。 源码
noGRPCHeader 布尔值(可选) 可选;默认不设置 noGrpcHeader
no-grpc-header
no_grpc_header
XhttpConfignoGRPCHeader 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
noSSEHeader 布尔值(可选) 可选;默认不设置 noSseHeader
no-sse-header
no_sse_header
XhttpConfignoSSEHeader 参数。解析类型为 布尔值(可选);组合约束由 wuther-core check 校验。 源码
scMaxEachPostBytes XhttpRange(可选) 可选;默认不设置 sc-max-each-post-bytes
sc_max_each_post_bytes
XhttpConfigscMaxEachPostBytes 参数。解析类型为 XhttpRange(可选);组合约束由 wuther-core check 校验。 源码
scMinPostsIntervalMs XhttpRange(可选) 可选;默认不设置 sc-min-posts-interval-ms
sc_min_posts_interval_ms
XhttpConfigscMinPostsIntervalMs 参数。解析类型为 XhttpRange(可选);组合约束由 wuther-core check 校验。 源码
scMaxBufferedPosts 整数(可选) 可选;默认不设置 sc-max-buffered-posts
sc_max_buffered_posts
XhttpConfigscMaxBufferedPosts 参数。解析类型为 整数(可选);组合约束由 wuther-core check 校验。 源码
scStreamUpServerSecs XhttpRange(可选) 可选;默认不设置 sc-stream-up-server-secs
sc_stream_up_server_secs
XhttpConfigscStreamUpServerSecs 参数。解析类型为 XhttpRange(可选);组合约束由 wuther-core check 校验。 源码
serverMaxHeaderBytes 整数(可选) 可选;默认不设置 server-max-header-bytes
server_max_header_bytes
XhttpConfigserverMaxHeaderBytes 参数。解析类型为 整数(可选);组合约束由 wuther-core check 校验。 源码
xmux XhttpXmuxConfig(可选) 可选;默认不设置 XhttpConfigxmux 参数。解析类型为 XhttpXmuxConfig(可选);组合约束由 wuther-core check 校验。 源码
downloadSettings XhttpDownloadSettings(可选) 可选;默认不设置 download-settings
downloadConfig
download-config
download_config
XhttpConfigdownloadSettings 参数。解析类型为 XhttpDownloadSettings(可选);组合约束由 wuther-core check 校验。 源码
extra XhttpConfig(可选) 可选;默认不设置 Xray 的兼容覆盖块。它仍是强类型 SplitHTTPConfig,不是任意 JSON。 源码

本分类枚举

XhttpListenSet

listen.xhttp 的单项/数组兼容表示。 源码

写法 兼容别名 含义
One(XhttpListener) 映射到 Rust 变体 XhttpListenSet::One
Many(Vec<XhttpListener>) 映射到 Rust 变体 XhttpListenSet::Many

XhttpListenAlpn

规范序列化值与 TLS ALPN wire name 保持一致。 源码

写法 兼容别名 含义
http/1.1 h1
http1
映射到 Rust 变体 XhttpListenAlpn::Http1
h2 http/2 映射到 Rust 变体 XhttpListenAlpn::H2
h3 http/3 映射到 Rust 变体 XhttpListenAlpn::H3

XhttpRealityTarget

XhttpRealityTarget 的可接受配置形态。 源码

写法 兼容别名 含义
Port(u16) 映射到 Rust 变体 XhttpRealityTarget::Port
Address(String) 映射到 Rust 变体 XhttpRealityTarget::Address

XhttpTcpFastOpen

XhttpTcpFastOpen 的可接受配置形态。 源码

写法 兼容别名 含义
Enabled(bool) 映射到 Rust 变体 XhttpTcpFastOpen::Enabled
QueueLength(i32) 映射到 Rust 变体 XhttpTcpFastOpen::QueueLength

XhttpTlsCertificateUsage

XhttpTlsCertificateUsage 的可接受配置形态。 源码

写法 兼容别名 含义
encipherment 映射到 Rust 变体 XhttpTlsCertificateUsage::Encipherment
verify 映射到 Rust 变体 XhttpTlsCertificateUsage::Verify
issue 映射到 Rust 变体 XhttpTlsCertificateUsage::Issue

XhttpTproxyMode

XhttpTproxyMode 的可接受配置形态。 源码

写法 兼容别名 含义
off 映射到 Rust 变体 XhttpTproxyMode::Off
tproxy 映射到 Rust 变体 XhttpTproxyMode::Tproxy
redirect 映射到 Rust 变体 XhttpTproxyMode::Redirect

XhttpDomainStrategy

XhttpDomainStrategy 的可接受配置形态。 源码

写法 兼容别名 含义
AsIs asis 映射到 Rust 变体 XhttpDomainStrategy::AsIs
UseIP useip 映射到 Rust 变体 XhttpDomainStrategy::UseIp
UseIPv4 useipv4 映射到 Rust 变体 XhttpDomainStrategy::UseIpv4
UseIPv6 useipv6 映射到 Rust 变体 XhttpDomainStrategy::UseIpv6
UseIPv4v6 useipv4v6 映射到 Rust 变体 XhttpDomainStrategy::UseIpv4v6
UseIPv6v4 useipv6v4 映射到 Rust 变体 XhttpDomainStrategy::UseIpv6v4
ForceIP forceip 映射到 Rust 变体 XhttpDomainStrategy::ForceIp
ForceIPv4 forceipv4 映射到 Rust 变体 XhttpDomainStrategy::ForceIpv4
ForceIPv6 forceipv6 映射到 Rust 变体 XhttpDomainStrategy::ForceIpv6
ForceIPv4v6 forceipv4v6 映射到 Rust 变体 XhttpDomainStrategy::ForceIpv4v6
ForceIPv6v4 forceipv6v4 映射到 Rust 变体 XhttpDomainStrategy::ForceIpv6v4

XhttpAddressPortStrategy

XhttpAddressPortStrategy 的可接受配置形态。 源码

写法 兼容别名 含义
none 映射到 Rust 变体 XhttpAddressPortStrategy::None
srvPortOnly srvportonly 映射到 Rust 变体 XhttpAddressPortStrategy::SrvPortOnly
srvAddressOnly srvaddressonly 映射到 Rust 变体 XhttpAddressPortStrategy::SrvAddressOnly
srvPortAndAddress srvportandaddress 映射到 Rust 变体 XhttpAddressPortStrategy::SrvPortAndAddress
txtPortOnly txtportonly 映射到 Rust 变体 XhttpAddressPortStrategy::TxtPortOnly
txtAddressOnly txtaddressonly 映射到 Rust 变体 XhttpAddressPortStrategy::TxtAddressOnly
txtPortAndAddress txtportandaddress 映射到 Rust 变体 XhttpAddressPortStrategy::TxtPortAndAddress

XhttpMaskPacketEncoding

XhttpMaskPacketEncoding 的可接受配置形态。 源码

写法 兼容别名 含义
array 映射到 Rust 变体 XhttpMaskPacketEncoding::Array
str 映射到 Rust 变体 XhttpMaskPacketEncoding::String
hex 映射到 Rust 变体 XhttpMaskPacketEncoding::Hex
base64 映射到 Rust 变体 XhttpMaskPacketEncoding::Base64

XhttpMaskPacket

XhttpMaskPacket 的可接受配置形态。 源码

写法 兼容别名 含义
Bytes(Vec<u8>) 映射到 Rust 变体 XhttpMaskPacket::Bytes
Text(String) 映射到 Rust 变体 XhttpMaskPacket::Text

XhttpMaskDomain

XhttpMaskDomain 的可接受配置形态。 源码

写法 兼容别名 含义
One(String) 映射到 Rust 变体 XhttpMaskDomain::One
Many(Vec<String>) 映射到 Rust 变体 XhttpMaskDomain::Many

XhttpPortList

XhttpPortList 的可接受配置形态。 源码

写法 兼容别名 含义
One(u16) 映射到 Rust 变体 XhttpPortList::One
List(String) 映射到 Rust 变体 XhttpPortList::List

XhttpTcpMask

XhttpTcpMask 的可接受配置形态。 源码

写法 兼容别名 含义
header-custom{ #[serde(default)] settings: XhttpHeaderCustomTcp, } 映射到 Rust 变体 XhttpTcpMask::HeaderCustom
fragment{ #[serde(default)] settings: XhttpFragmentMask, } 映射到 Rust 变体 XhttpTcpMask::Fragment
sudoku{ #[serde(default)] settings: XhttpSudokuMask, } 映射到 Rust 变体 XhttpTcpMask::Sudoku
xmc{ #[serde(default)] settings: XhttpXmcMask, } 映射到 Rust 变体 XhttpTcpMask::Xmc

XhttpUdpMask

XhttpUdpMask 的可接受配置形态。 源码

写法 兼容别名 含义
header-custom{ #[serde(default)] settings: XhttpHeaderCustomUdp, } 映射到 Rust 变体 XhttpUdpMask::HeaderCustom
mkcp-legacy{ #[serde(default)] settings: XhttpMkcpLegacyMask, } 映射到 Rust 变体 XhttpUdpMask::MkcpLegacy
noise{ #[serde(default)] settings: XhttpNoiseMask, } 映射到 Rust 变体 XhttpUdpMask::Noise
salamander{ #[serde(default)] settings: XhttpSalamanderMask, } 映射到 Rust 变体 XhttpUdpMask::Salamander
sudoku{ #[serde(default)] settings: XhttpSudokuMask, } 映射到 Rust 变体 XhttpUdpMask::Sudoku
xdns{ #[serde(default)] settings: XhttpXdnsMask, } 映射到 Rust 变体 XhttpUdpMask::Xdns
xicmp{ #[serde(default)] settings: XhttpXicmpMask, } 映射到 Rust 变体 XhttpUdpMask::Xicmp
realm{ #[serde(default)] settings: XhttpRealmMask, } 映射到 Rust 变体 XhttpUdpMask::Realm