Deprecated Feature List
1.11.0
Legacy special outbounds
Legacy special outbounds (block
/ dns
) are deprecated
and can be replaced by rule actions,
check Migration.
Old fields will be removed in sing-box 1.13.0.
Legacy inbound fields
Legacy inbound fields (inbound.<sniff/domain_strategy/...>
are deprecated
and can be replaced by rule actions,
check Migration.
Old fields will be removed in sing-box 1.13.0.
Destination override fields in direct outbound
Destination override fields (override_address
/ override_port
) in direct outbound are deprecated
and can be replaced by rule actions,
check Migration.
WireGuard outbound
WireGuard outbound is deprecated and can be replaced by endpoint, check Migration.
Old outbound will be removed in sing-box 1.13.0.
1.10.0
TUN address fields are merged
inet4_address
and inet6_address
are merged into address
,
inet4_route_address
and inet6_route_address
are merged into route_address
,
inet4_route_exclude_address
and inet6_route_exclude_address
are merged into route_exclude_address
.
Old fields will be removed in sing-box 1.12.0.
Match source rule items are renamed
rule_set_ipcidr_match_source
route and DNS rule items are renamed to
rule_set_ip_cidr_match_source
and will be remove in sing-box 1.11.0.
Drop support for go1.18 and go1.19
Due to maintenance difficulties, sing-box 1.10.0 requires at least Go 1.20 to compile.
1.8.0
Cache file and related features in Clash API
cache_file
and related features in Clash API is migrated to independent cache_file
options,
check Migration.
GeoIP
GeoIP is deprecated and will be removed in sing-box 1.12.0.
The maxmind GeoIP National Database, as an IP classification database, is not entirely suitable for traffic bypassing, and all existing implementations suffer from high memory usage and difficult management.
sing-box 1.8.0 introduces rule-set, which can completely replace GeoIP, check Migration.
Geosite
Geosite is deprecated and will be removed in sing-box 1.12.0.
Geosite, the domain-list-community
project maintained by V2Ray as an early traffic bypassing solution,
suffers from a number of problems, including lack of maintenance, inaccurate rules, and difficult management.
sing-box 1.8.0 introduces rule-set, which can completely replace Geosite, check Migration.
1.6.0
The following features will be marked deprecated in 1.5.0 and removed entirely in 1.6.0.
ShadowsocksR
ShadowsocksR support has never been enabled by default, since the most commonly used proxy sales panel in the illegal industry stopped using this protocol, it does not make sense to continue to maintain it.
Proxy Protocol
Proxy Protocol is added by Pull Request, has problems, is only used by the backend of HTTP multiplexers such as nginx, is intrusive, and is meaningless for proxy purposes.