版本与升级:怎么看更新、怎么安全升级
版本以 GitHub 发行页为准;升级前备份、看变更说明,几个已移除或弃用的旧功能要单独注意。
版本以哪里为准
本站正文不固定写某个版本号,因为版本一直在变。每次下载、升级前,以 GitHub 发行页的最新稳定版为准;发行页上的更新说明会写清这个版本改了什么、废弃了什么。不要把旧文章里写死的版本号当成“当前最新”长期引用。
看版本时分清三件事:客户端版本、内核版本、配置适用的版本。客户端升级了,不代表配置自动兼容新内核;配置报错时,报错里提到的版本才是要核对的那一个。
安全升级的固定流程
- 备份:把现有配置、远程配置 URL 和必要的设置留一份能恢复的副本。
- 看变更说明:重点看废弃、移除和迁移部分,不要只看新功能。
- 先升级一台设备验证:确认能启动、能选节点、能访问目标,再升级其他设备。
- 出问题先回滚再定位:不要在生产配置上反复改字段,先回到能用的版本,再按变更说明逐项迁移。
几个旧功能的变化,新手容易踩
- ShadowsocksR(SSR):当前版本不支持,支持已在 sing-box 1.6.0 移除。SSR 和 Shadowsocks 是不同协议,改扩展名或转换订阅格式,不能把 SSR 节点变成 Shadowsocks 节点,需要服务端提供客户端支持的协议。
- 旧 GeoIP、Geosite:在 1.8.0 弃用、1.12.0 移除,现在用规则集(rule-set)维护 IP 或域名规则。旧配置引用这些功能时报错,要迁移规则和引用方式,不能只把文件改名。
- macOS 1.14 迁移:SFM 换成新应用后,旧配置和设置不会自动继承,见《macOS 安装》的迁移一节。
- 服务端 TLS:1.14 已把旧的内联 ACME 配置标为弃用,新方案按官方 ACME 证书提供方的说明来,旧教程的 TLS 字段不要直接搬进新配置。
客户端更新和配置刷新不是一回事
- 更新客户端:换客户端程序本身。
- 刷新配置:重新下载远程配置 URL 返回的内容。
刷新成功不保证新配置兼容或节点在线,刷新完还要重新选中、启动、验证;更新客户端后,旧配置里的字段也可能需要按新版本调整。两件事分开做,出问题才好定位。