icon: material/delete-alert

Deprecated Feature List

1.14.0

Legacy `download_detour` remote rule-set option

Legacy download_detour remote rule-set option is deprecated, use http_client instead.

Old field will be removed in sing-box 1.16.0.

Implicit default HTTP client

Implicit default HTTP client using the default outbound for remote rule-sets is deprecated. Configure http_clients and route.default_http_client explicitly.

Old behavior will be removed in sing-box 1.16.0.

Legacy dialer options in Tailscale endpoint

Legacy dialer options in Tailscale endpoints are deprecated, use control_http_client instead.

Old fields will be removed in sing-box 1.16.0.

Inline ACME options in TLS

Inline ACME options (tls.acme) are deprecated and can be replaced by the ACME certificate provider, check Migration.

Old fields will be removed in sing-box 1.16.0.

Legacy `strategy` DNS rule action option

Legacy strategy DNS rule action option is deprecated.

Old fields will be removed in sing-box 1.16.0.

Legacy `rule_set_ip_cidr_accept_empty` DNS rule item

Legacy rule_set_ip_cidr_accept_empty DNS rule item is deprecated, check Migration.

Old fields will be removed in sing-box 1.16.0.

`independent_cache` DNS option

independent_cache DNS option is deprecated. The DNS cache now always keys by transport, making this option unnecessary, check Migration.

Old fields will be removed in sing-box 1.16.0.

`store_rdrc` cache file option

store_rdrc cache file option is deprecated, check Migration.

Old fields will be removed in sing-box 1.16.0.

Legacy Address Filter Fields in DNS rules

Legacy Address Filter Fields (ip_cidr, ip_is_private without match_response) in DNS rules are deprecated, check Migration.

Old behavior will be removed in sing-box 1.16.0.

1.12.0

Legacy DNS server formats

DNS servers are refactored, check Migration.

Old formats were removed in sing-box 1.14.0.

`outbound` DNS rule item

Legacy outbound DNS rules are deprecated and can be replaced by dial fields, check Migration.

Legacy ECH fields

ECH support has been migrated to use stdlib in sing-box 1.12.0, which does not come with support for PQ signature schemes, so pq_signature_schemes_enabled has been deprecated and no longer works.

Also, dynamic_record_sizing_disabled has nothing to do with ECH, was added by mistake, has been deprecated and no longer works.

These fields were removed in sing-box 1.13.0.

1.11.0

Legacy special outbounds

Legacy special outbounds (block / dns) are deprecated and can be replaced by rule actions, check Migration.

Old fields were 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 were 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.

Old fields were removed in sing-box 1.13.0.

WireGuard outbound

WireGuard outbound is deprecated and can be replaced by endpoint, check Migration.

Old outbound was removed in sing-box 1.13.0.

GSO option in TUN

GSO has no advantages for transparent proxy scenarios, is deprecated and no longer works in TUN.

Old fields were 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 were 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 were removed 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 was 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 was 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.