BorgBackup 文档更新：SSH仓库URL语法升级指南

在BorgBackup备份工具的最新版本演进中，SSH仓库URL的语法规范发生了重要变化。本文将为用户详细解析这一变更的技术背景及实际应用场景。

语法变更核心内容

传统版本中，BorgBackup允许通过SCP风格的语法指定远程仓库路径，例如：

user@host:path/to/repo

而现代版本(2.0+)则要求使用标准URL格式：

ssh://user@host/path/to/repo

特别值得注意的是相对路径的表示方式变化。在配合SSH authorized_keys中使用cd命令隐藏实际路径的场景下，新旧语法的差异尤为明显。

典型应用场景

在集中式备份服务器部署方案中，管理员通常会在authorized_keys文件中设置目录限制：

command="cd /backups && borg serve --restrict-to-path .",...

此时客户端需要使用特殊语法访问相对路径：

ssh://user@host/./repo

文档同步建议

基于版本兼容性考虑，建议：

1. 主文档统一采用URL语法作为标准示例
2. 在兼容性说明章节保留SCP语法参考
3. 对涉及路径限制的特殊用法进行重点标注

升级实践指导

对于从旧版本迁移的用户：

1. 检查现有脚本和配置中的仓库路径
2. 逐步替换为URL格式语法
3. 测试验证备份/恢复流程
4. 更新相关文档和自动化脚本

该变更体现了BorgBackup向标准化协议发展的趋势，建议新用户直接采用URL语法以获得最佳兼容性。