Remotely-Save插件Webdav子路径同步问题分析与解决方案

问题背景

在Obsidian笔记管理系统中，Remotely-Save插件作为一款流行的同步工具，近期被发现存在一个影响Webdav协议下子路径同步的兼容性问题。当用户尝试将笔记同步至配置了子路径的Webdav服务器时（例如https://webdav.example.com/somepath/），系统会抛出路径校验错误："Error: "/../Notes" doesn't starts with "/Notes/""

技术分析

该问题源于路径规范化处理逻辑的缺陷。在Webdav协议实现中，当服务器地址包含子路径时：

1. 原始路径拼接时未正确处理子路径前缀
2. 路径校验模块对规范化后的路径进行了错误的绝对路径判断
3. 相对路径解析时未考虑基础路径的上下文

开发者通过版本0.5.25修复了该问题，主要改进包括：

• 重构了路径拼接算法
• 优化了子路径场景下的校验逻辑
• 增强了对各类Webdav服务器配置的兼容性

典型配置示例

以Caddy服务器为例，推荐配置如下：

http://localhost:7070 {
    route /dav/* {
        basicauth {
            user $2a$14$3v.HuXc0R/DcIk8eRnjWfeuVLrMMcbA5DmIfOKzCUyxs0.SnrGyQS
        }
        root /path/to/storage
        uri strip_prefix /dav
        webdav
    }
}

对应Remotely-Save插件配置参数：

• 服务类型：Webdav
• 服务器地址：http://localhost:7070/dav
• 认证方式：Basic Auth
• 用户名/密码：user/password

最佳实践建议

1. 版本控制：确保使用0.5.25及以上版本插件
2. 路径规范：建议使用英文路径名，避免特殊字符
3. 权限设置：Webdav目录需具备读写权限
4. 连接测试：首次配置后建议执行手动同步测试
5. 日志检查：如遇问题可查看Obsidian控制台日志

技术影响

该修复显著提升了插件在复杂Webdav部署环境下的兼容性，特别有利于：

• 需要多租户隔离的SaaS场景
• 企业内网共享存储配置
• 基于反向代理的复杂网络架构

建议所有使用Webdav子路径配置的用户及时升级插件版本，以获得更稳定的同步体验。