Migration
1.9.0
Unstable
This version is still under development, and the following migration guide may be changed in the future.
domain_suffix
behavior update
For historical reasons, sing-box's domain_suffix
rule matches literal prefixes instead of the same as other projects.
sing-box 1.9.0 modifies the behavior of domain_suffix
: If the rule value is prefixed with .
,
the behavior is unchanged, otherwise it matches (domain|.+\.domain)
instead.
process_path
format update on Windows
The process_path
rule of sing-box is inherited from Clash,
the original code uses the local system's path format (e.g. \Device\HarddiskVolume1\folder\program.exe
),
but when the device has multiple disks, the HarddiskVolume serial number is not stable.
sing-box 1.9.0 make QueryFullProcessImageNameW output a Win32 path (such as C:\folder\program.exe
),
which will disrupt the existing process_path
use cases in Windows.
1.8.0
Migrate cache file from Clash API to independent options
References
Migrate GeoIP to rule sets
References
GeoIP / Route / Route Rule / DNS Rule / Rule Set
Tip
sing-box geoip
commands can help you convert custom GeoIP into rule sets.
{
"route": {
"rules": [
{
"ip_is_private": true,
"outbound": "direct"
},
{
"rule_set": "geoip-cn",
"outbound": "direct"
},
{
"rule_set": "geoip-us",
"rule_set_ipcidr_match_source": true,
"outbound": "block"
}
],
"rule_set": [
{
"tag": "geoip-cn",
"type": "remote",
"format": "binary",
"url": "https://raw.githubusercontent.com/SagerNet/sing-geoip/rule-set/geoip-cn.srs",
"download_detour": "proxy"
},
{
"tag": "geoip-us",
"type": "remote",
"format": "binary",
"url": "https://raw.githubusercontent.com/SagerNet/sing-geoip/rule-set/geoip-us.srs",
"download_detour": "proxy"
}
]
},
"experimental": {
"cache_file": {
"enabled": true // required to save Rule Set cache
}
}
}
Migrate Geosite to rule sets
References
Geosite / Route / Route Rule / DNS Rule / Rule Set
Tip
sing-box geosite
commands can help you convert custom Geosite into rule sets.
{
"route": {
"rules": [
{
"rule_set": "geosite-cn",
"outbound": "direct"
}
],
"rule_set": [
{
"tag": "geosite-cn",
"type": "remote",
"format": "binary",
"url": "https://raw.githubusercontent.com/SagerNet/sing-geosite/rule-set/geosite-cn.srs",
"download_detour": "proxy"
}
]
},
"experimental": {
"cache_file": {
"enabled": true // required to save Rule Set cache
}
}
}