diff --git a/docs/migration.md b/docs/migration.md index 3b006288..8a78869f 100644 --- a/docs/migration.md +++ b/docs/migration.md @@ -9,11 +9,22 @@ icon: material/arrange-bring-forward Apple platform clients migrated to a new Apple developer account, so the macOS standalone client is a new application, and profiles and settings are not inherited. -Before starting sing-box 1.14.0-rc.2 or later, they can be migrated using the following command: +Before starting sing-box 1.14.0-rc.2 or later, they can be migrated using the following commands: ```bash mv ~/Library/Group\ Containers/287TTNZF8L.io.nekohasekai.sfavt \ ~/Library/Group\ Containers/P8XK3KHB48.io.nekohasekai.sfamt +xattr -c ~/Library/Group\ Containers/P8XK3KHB48.io.nekohasekai.sfamt +rm ~/Library/Group\ Containers/P8XK3KHB48.io.nekohasekai.sfamt/.com.apple.containermanagerd.metadata.plist +``` + +If you have already migrated using an earlier version of this command and a permission prompt +appears at startup, run the following commands and restart the application: + +```bash +xattr -c ~/Library/Group\ Containers/P8XK3KHB48.io.nekohasekai.sfamt +rm ~/Library/Group\ Containers/P8XK3KHB48.io.nekohasekai.sfamt/.com.apple.containermanagerd.metadata.plist +tccutil reset All io.nekohasekai.sfamt.standalone ``` ### Migrate inline ACME to certificate provider diff --git a/docs/migration.zh.md b/docs/migration.zh.md index 4d003e1e..a710b17c 100644 --- a/docs/migration.zh.md +++ b/docs/migration.zh.md @@ -4,6 +4,28 @@ icon: material/arrange-bring-forward ## 1.14.0 +### 迁移 macOS standalone 客户端数据 + +Apple 平台客户端已迁移至新的 Apple 开发者账户,因此 macOS standalone 客户端是一个新应用, +配置文件与设置不会被继承。 + +在启动 sing-box 1.14.0-rc.2 或更高版本之前,可使用以下命令迁移: + +```bash +mv ~/Library/Group\ Containers/287TTNZF8L.io.nekohasekai.sfavt \ + ~/Library/Group\ Containers/P8XK3KHB48.io.nekohasekai.sfamt +xattr -c ~/Library/Group\ Containers/P8XK3KHB48.io.nekohasekai.sfamt +rm ~/Library/Group\ Containers/P8XK3KHB48.io.nekohasekai.sfamt/.com.apple.containermanagerd.metadata.plist +``` + +如果您已使用此命令的早期版本迁移,且启动时出现权限弹窗,请执行以下命令并重新启动应用: + +```bash +xattr -c ~/Library/Group\ Containers/P8XK3KHB48.io.nekohasekai.sfamt +rm ~/Library/Group\ Containers/P8XK3KHB48.io.nekohasekai.sfamt/.com.apple.containermanagerd.metadata.plist +tccutil reset All io.nekohasekai.sfamt.standalone +``` + ### 迁移内联 ACME 到证书提供者 TLS 中的内联 ACME 选项已废弃,且可以被证书提供者替代。