meta-json-schema/CHANGELOG.md

JSON Schema for Clash Meta

## v1.19.25

### Changes

- 移除: vless `xhttp` 下载配置移除未使用的配置项 `no-grpc-header`、`x-padding-bytes`、`x-padding-obfs-mode`、`x-padding-key`、`x-padding-header`、`x-padding-placement`、`x-padding-method`、`uplink-http-method`、`session-placement`、`session-key`、`seq-placement`、`seq-key`、`uplink-data-placement`、`uplink-data-key`、`uplink-chunk-size`、`sc-max-each-post-bytes`、`sc-min-posts-interval-ms`
- 新增: listener shadowsocks 新增配置项 `simple-obfs`
- 新增: hysteria2 新增配置项 `realm-opts`
- 新增: listener hysteria2 新增配置项 `realm-opts`
- 新增: inbound 新增 hysteria2-realm `listeners` 配置项
- 新增: proxy 新增 `openvpn`、`tailscale`、`gost-relay` 协议

### Bug Fixes

- 修复: 补充 shadowsocks/trojan `alpn` 配置项的默认值
- 修复: `exclude-filter` 现有描述描述应为支持使用 `重音符` 分隔多个关键词或正则表达式
- 修复: 补充 shadowsocks `listeners` 缺失 `kcp-tun` 配置项

## v1.19.24

### Changes

- 调整: vless `xhttp` 配置项 `sc-max-each-post-bytes` 支持配置范围
- 调整: vless `xhttp` 复用配置新增配置项 `h-keep-alive-period`
- 新增: masque 新增配置项 `skip-cert-verify`、`network`
- 调整: hysteria2 配置项 `hop-interval` 支持配置范围
- 新增: hysteria2/tuic/trusttunnel/masque 新增配置项 `bbr-profile`
- 新增: listener hysteria2/tuic/trusttunnel 新增配置项 `bbr-profile`
- 新增: vless `xhttp` 新增配置项 `sc-min-posts-interval-ms`、`x-padding-obfs-mode`、`x-padding-key`、`x-padding-header`、`x-padding-placement`、`x-padding-method`、`uplink-http-method`、`session-placement`、`session-key`、`seq-placement`、`seq-key`、`uplink-data-placement`、`uplink-data-key`、`uplink-chunk-size`
- 新增: listener vless `xhttp` 新增配置项 `sc-max-buffered-posts`、`x-padding-bytes`、`x-padding-obfs-mode`、`x-padding-key`、`x-padding-header`、`x-padding-placement`、`x-padding-method`、`uplink-http-method`、`session-placement`、`session-key`、`seq-placement`、`seq-key`、`uplink-data-placement`、`uplink-data-key`、`uplink-chunk-size`
- 新增: listener mieru 新增配置项 `user-hint-is-mandatory`

### Bug Fixes

- 修复: outbound 的 `fingerprint` 配置项描述错误
- 修复: wireguard 的 `ip` 、`ipv6` 配置项应支持配置为 CIDR 格式

---

## v1.19.23

### Changes

- 新增: 约束 masque 的 `ip` 、`ipv6` 至少填一项
- 新增: vless `xhttp` 新增配置项 `reuse-settings`、`sc-max-each-post-bytes`
- 新增: listener vless `xhttp` 新增配置项 `sc-stream-up-server-secs`、`no-sse-header`、`sc-max-each-post-bytes`
- 新增: vmess/vless/trojan `grpc-opts` 新增配置项 `max-connections`、`min-streams`、`max-streams`
- 新增: trusttunnel 新增配置项 `max-connections`、`min-streams`、`max-streams`
- 新增: sing-tun 新增配置项 `include-mac-address`、`exclude-mac-address`

### Bug Fixes

- 修复: TUN 缺失 `auto-redirect-iproute2-fallback-rule-index` 配置项
- 修复: vmess 缺失 `skip-cert-verify` 配置项
- 修复: masque 的 `ip` 、`ipv6` 配置项应支持配置为 CIDR 格式
- 修复: 部分配置项的类型错误/过时、默认值错误/过时
- 修复: `rule-provider` 的 `inline` 类型规则的 `AND` 、`OR`、`NOT` 的 target 不应存在
- 修复: `fake-ip-filter` 的 `rule` 模式下的规则不应支持 `AND` 、`OR`、`NOT`
- 修复: 规则 `DOMAIN-REGEX`、`PROCESS-NAME-REGEX`、`PROCESS-PATH-REGEX` 的 `payload` 应支持含有逗号

---

## v1.19.22

### Changes

- 新增: vmess/vless/trojan `grpc-opts` 新增配置项 `ping-interval`
- 新增: vless 支持 `xhttp` 传输协议，并新增配置项 `xhttp-opts`
- 新增: listener vless 支持 `xhttp` 传输协议，并新增配置项 `xhttp-config`
- 新增: 兼容安卓端 `clash-for-android` 配置项 [#11](https://github.com/dongchengjie/meta-json-schema/issues/11)
- 新增: 兼容 [Smart](https://github.com/vernesong/mihomo/blob/Alpha/adapter/outboundgroup/smart.go) 代理组相关配置项
- 新增: sudoku `table-type` 支持 `up_ascii_down_entropy`、`up_entropy_down_ascii`

### Bug Fixes

- 修复: 补充 vless 缺失 `udp` 配置项

---

## v1.19.21

### Changes

- 调整: listener vmess 配置项 `alterId` 为可选项
- 新增: proxy 新增 `trusttunnel` 协议
- 新增: inbound 新增 trusttunnel `listeners` 配置项
- 新增: mieru 新增配置项 `traffic-pattern`
- 新增: sudoku HTTP掩码支持 `ws` 模式
- 调整: sudoku HTTP掩码相关配置 迁移至 `httpmask` 配置项
- 新增: sudoku `listeners` 新增配置项 `fallback`

### Bug Fixes

- 修复: `proxy-server-nameserver` 在未显式配置 `respect-rules` 或 `proxy-server-nameserver-policy` 时变为必填项

---

## v1.19.20

### Changes

- 新增: `ech-opts` 新增配置项 `query-server-name`
- 新增: proxy 新增 `masque` 协议
- 调整: 调整 sudoku 配置项描述
- 新增: DNS 新增配置项 `proxy-server-nameserver-policy`

### Bug Fixes

- 修复: `reality-opts` 的 `short-id` 配置项应为可选项
- 修复: `fake-ip-filter-mode` 未配置时，错误地使用了 `rule` 规则进行校验

---

## v1.19.19

### Changes

- 新增: sudoku `listeners` 新增配置项 `disable-http-mask`、`http-mask-mode`、`path-root`
- 新增: sudoku 新增配置项 `http-mask-mode`、`http-mask-tls`、`http-mask-host`、`path-root`、`http-mask-multiplex`
- 移除: sudoku 移除配置项 `http-mask-strategy`
- 新增: `rule-provider` 新增 HTTP 配置项 `header`
- 新增: `fake-ip-filter-mode` 支持 `rule` 模式
- 新增: `fake-ip-filter` 支持配置规则，以此决定返回 `fake-ip` 或 `real-ip`
- 新增: ss kcptun插件支持 `aes-128-gcm` 加密、新增 `ratelimit`、`framesize` 配置项
- 新增: 新增 `PROCESS-NAME-WILDCARD`、`PROCESS-PATH-WILDCARD`
- 移除: 即将弃用 `global-client-fingerprint`
- 新增: trojan/vmess/vless grpc-opts 新增 `grpc-user-agent` 配置项

### Bug Fixes

- 修复: `proxy-provider` 和 `rule-provider` 配置的 `size-limit` 单位描述错误
- 修复: `SRC-IP-ASN` 错误地拼写成 `SCR-IP-ASN`

---

## v1.19.18

### Changes

- 移除: sudoku `listeners` 移除配置项 `seed`
- 新增: sudoku `listeners` 新增配置项 `enable-pure-downlink`、`custom-table`、`custom-tables`
- 新增: sudoku 新增配置项 `enable-pure-downlink`、`custom-table`、`custom-tables`、`http-mask-strategy`

---

## v1.19.17

### Changes

- 调整: mieru 出站传输层协议支持 UDP
- 新增: DNS 新增 `fake-ip-ttl` 配置项
- 新增: proxy 新增 `sudoku` 协议
- 新增: inbound 新增 sudoku `listeners` 配置项
- 移除: 彻底移除 `relay` 代理组，使用 `dialer-proxy` 代替

---

## v1.19.16

### Changes

- 新增: DNS 新增 `fake-ip-range6` 配置项
- 新增: inbound 新增 mieru `listeners` 配置项

---

## v1.19.15

### Changes

- 调整: 回退 mieru 弃用的 `port-range` 字段

---

## v1.19.14

### Changes

- 调整: 更新 vless `encryption` 客户端配置描述
- 新增: wireguard 新增 `s3`、`s4` 配置项（AmneziaWG v2.0）
- 调整: wireguard 的 `h1`、`h2`、`h3`、`h4` 配置项类型调整为字符串（AmneziaWG v2.0）
- 新增: TUN 新增 `disable-icmp-forwarding` 配置项
- 移除: hy1/hy2/tuic 移除 `ca`、`ca-str` 配置项（使用 fingerprint 代替）
- 新增: anytls/http/hy/hy2/ss/socks/trojan/tuic/vless/vmess 新增 `certificate`、`private-key` 配置项
- 新增: listener anytls/http/hy2/mixed/socks/trojan/tuic/vless/vmess 新增 `client-auth-type`、`client-auth-cert` 配置项
- 新增: ss 新增 `kcptun` 插件相关配置项支持
- 调整: mieru 弃用 `port-range` 字段（功能合并到 `port`）
- 移除: vless 移除配置项 `ws-path`

---

## v1.19.13

### Changes

- 新增: vless 新增 `encryption` 配置项（vless encryption 客户端配置）
- 新增: listener vless 新增 `encryption` 配置项（vless encryption 服务端配置）
- 新增: mieru 新增 `handshake-mode` 配置项（握手模式）
- 新增: wireguard 新增 `i1`、`i2`、`i3`、`i4`、`i5`、`j1`、`j2`、`j3`、`itime` 配置项（AmneziaWG v1.5）

---

## v1.19.12

### Changes

- 新增: 规则 新增 `DOMAIN-WILDCARD` 规则的支持（匹配域名通配符）
- 新增: TUN 新增 Darwin 平台特殊配置 `recvmsgx` 和 `sendmsgx`
- 新增: DNS 新增 配置项 `cache-max-size` （最大缓存大小）

---

## v1.19.11

### Changes

- 新增: TUN 新增 `loopback-address` 配置项

### Bug Fixes

- 修复: `sniffer` 配置的 `force-domain` 配置项不支持 `geosite:` 和 `rule-set:`

---

## v1.19.10

### Changes

- 调整: 路由规则的参数部分（no-resolve、src），其前后支持任意个数的空格
- 调整: IPv6 支持 `IPv4-mapped IPv6` 格式

### Bug Fixes

- 修复: `external-controller-cors` 配置的 `allow-origins` 配置项误写成 `allow-origin`
- 修复: TUN 配置项 `inet4-address`、`inet6-address` 类型应为 CIDR 数组

---

## v1.19.9

### Changes

- 新增: reality 新增 `support-x25519mlkem768` 配置项
- 新增: anytls/shadowsocks/trojan/vmess/vless/hysteria/hysteria2/tuic 协议 新增 `ech-opts` 配置项
- 新增: listener anytls/http/hysteria2/mixed/socks/trojan/tuic/vless/vmess 新增 `ech-key` 配置项
- 新增: tls(external-controller-tls) 新增 `ech-key` 配置项

---

## v1.19.6

### Changes

- 新增: `shadowsocks` 的 `shadow-tls` 插件 新增 `alpn` 配置项
- 新增: listener `shadowsocks` 新增 `shadow-tls` 配置项
- 移除: 代理组移除 `routing-mark` 、`interface-name` 配置项

### Bug Fixes

- 修复: 域名正则宽松，支持单段/自定义域名，如：localhost、internal 等

---

## v1.19.5

### Changes

- 新增: TUN 新增 `exclude-src-port`、`exclude-src-port-range`、`exclude-dst-port`、`exclude-dst-port-range` 配置项

---

## v1.19.4

### Changes

- 新增: ss 协议 新增 `gost-plugin` 插件支持
- 新增: mieru 协议 新增 `udp` 支持

### Bug Fixes

- 修复: 代理组类型配置项 `type` 枚举重复显示

---

## v1.19.3

### Changes

- 调整: `external-ui-url` 补充说明支持的压缩包格式
- 新增: proxy 新增 `anytls` 协议
- 新增: inbound 新增 anytls、trojan `listeners` 配置项
- 新增: inbound（trojan、vless、vmess） 部分新增 `grpc-service-name` 配置项
- 调整: inbound 端口支持使用 ports 格式
- 调整: inbound （socks5、http、mixed）支持 tls 配置

### Bug Fixes

- 修复: inbound （socks5、http、mixed）缺失 `reality-config` 配置项

---

## v1.19.2

### Changes

- 新增: hy2 新增 `initial-stream-receive-window`、`max-stream-receive-window`、`initial-connection-receive-window`、`max-connection-receive-window` quic-go 配置项
- 新增: inbound 新增 vless `listeners` 配置项

### Bug Fixes

- 修复: 枚举 `cipher` 缺失加密方法 `2022-blake3-aes-128-ccm`、`2022-blake3-aes-256-ccm`、`2022-blake3-chacha8-poly1305`、`chacha20-poly1305`、`chacha8-ietf-poly1305`、`xchacha8-ietf-poly1305`、`zero`

---

## v1.19.1

### Changes

- 新增: rule-providers 新增 `inline` 内联规则配置
- 新增: proxy-providers 新增 `inline` 内联 proxies 配置
- 调整: outbound 的 `header` 配置项宽松，不再限制 value 的类型为 string

### Bug Fixes

- 修复: `tuic` V4 的 `token` 配置项类型错误

---

## v1.19.0

### Changes

- 新增: proxy-provider 新增 `size-limit` 配置项
- 新增: proxy 新增 `mieru` 协议

---

## v1.18.10

### Changes

- 新增: DNS 新增 `direct-nameserver`、`direct-nameserver-follow-policy` 配置项

### Bug Fixes

- 修复: `skip-auth-prefixes`、`lan-allowed-ips`、`lan-disallowed-ips` 类型错误

---

## v1.18.9

### Changes

- 新增: 全局配置新增 `etag-support` 开关
- 新增: 外部控制器 新增 `external-controller-pipe` 配置项，支持从 Windows namedpipe 访问 API
- 新增: 外部控制器 新增 `external-controller-cors` 配置跨域响应头
- 新增: proxy-provider 的 `override` 配置项新增 `proxy-name` 配置项，支持正则替换代理名称
- 新增: `wireguard` 新增 `amnezia-wg-option` 配置项

---

## v1.18.8

### Changes

- 新增: 添加对 [clash-nyanpasu](https://github.com/libnyanpasu/clash-nyanpasu) Merge Schema 的支持 [#1](https://github.com/dongchengjie/meta-json-schema/pull/1)
- 新增: `http`、`socks`、`mixed` 入站配置 新增 `users` 认证配置项
- 新增: `sniff` 新增 `skip-src-address`、`skip-dst-address` 配置项
- 新增: `dns` 新增 `fake-ip-filter-mode` 配置项
- 调整: 规则 `GEOIP`、`IP-ASN`、`IP-CIDR`、`IP-CIDR6`、`IP-SUFFIX`、`RULE-SET` 支持追加 `,src` 选项

---

## v1.18.7

### Changes

- 调整: `tun` 配置项 `route-exclude-address` 描述
- 调整: 支持部分 `chacha8` 加密方法
- 新增: 全局配置新增 `external-doh-server`，支持配置提供本地 DOH 服务
- 新增: 规则集新增 `mrs` 格式
- 新增: 全局配置新增 `keep-alive-idle` 和 `disable-keep-alive` 保持连接相关配置
- 移除: 不再支持 `ebpf` 配置

---

## v1.18.6

### Changes

- 新增: `trojan`出站配置 新增配置项 `ss-opts` 以支持 Shadowsocks AEAD 加密
- 新增: `dns` 新增配置项 `respect-rules`
- 新增: `wireguard` 配置项 `refresh-server-ip-interval`
- 调整: `rules` 正则表达式
- 新增: `proxy-provider` 新增覆写配置项 `tfo`、`mptcp`、`udp-over-tcp`
- 调整: `tun` 弃用配置项 `inet4-route-address`、`inet6-route-address`、`inet4-route-exclude-address`、`inet6-route-exclude-address`，使用 `route-address`、`route-exclude-address` 代替
- 调整: `tun` 配置项 `table-index` 重命名为 `iproute2-table-index`
- 新增: `tun` 新增配置项 `iproute2-rule-index`、`auto-redirect`、`auto-redirect-input-mark`、`auto-redirect-output-mark`、`route-address-set`、`route-exclude-address-set`

### Bug Fixes

- 修复: `bind-address` 类型错误
- 修复: 字符串数组提示错误
- 修复: `route-address` 和 `route-exclude-address` 格式错误

---

## v1.18.5

### Changes

- 新增: `dns` 新增配置项 `use-system-hosts`
- 调整: 调整部分配置描述
- 移除: Clash Verge Merge 配置移除`prepend-rule-providers`、`prepend-proxy-providers`、`append-rule-providers`、`append-proxy-providers`
- 新增: `sniffer` 未配置 `sniff` 警告
- 新增: `vless` 使用旧版 `XTLS` 协议警告
- 新增: `rules` 新增规则 `PROCESS-NAME-REGEX` 、 `PROCESS-PATH-REGEX`

### Bug Fixes

- 修复: cipher 缺少 `none`
- 修复: `default-nameserver`类型错误
- 修复: `nameserver-policy` 不支持配置单个 DNS 服务器字符串
- 修复: 域名通配格式错误

---

## v1.18.4

### Changes

- 新增: `proxy-providers` 新增配置项 `header`
- 调整: `proxy-providers`,`proxy-group` 配置项 `health-check`的`interval` 和 `timeout` 属性类型变更(`integer` --> `string`), 支持配置时间单位
- 新增: 新增配置项`external-controller-unix`,允许使用 Unix Socket 访问 API

### Bug Fixes

- 字符串数组类型错误
- 监听地址支持`:port`
- sniffer 的 http ports 类型错误

---

## v1.18.3

### Features

- 首个 JSON Schema 版本

---