Remotely-Save插件WebDAV同步故障排查与解决方案

问题背景

近期Remotely-Save插件在5.22版本更新后，部分用户反馈WebDAV同步功能出现异常。主要表现为：

1. 同步操作失败但连接测试正常
2. 降级到5.20版本后恢复正常
3. 403权限错误（部分用户报告）

技术分析

经过深入分析，发现该问题主要涉及以下技术要点：

1. 权限验证机制升级

5.22版本对WebDAV的权限验证机制进行了增强，新增了写权限检查功能。这导致：

• 当服务端目录没有正确配置写权限时，同步会失败
• 之前的版本可能只检查读权限，因此能"正常"工作但实际存在隐患

2. 路径处理逻辑变更

新版本对WebDAV的基础路径(Base Directory)处理更加严格：

• 需要确保用户对指定路径有完整权限
• 路径深度限制可能导致某些特殊目录结构无法访问

解决方案

1. 服务端配置检查

确保WebDAV服务端满足以下条件：

• 目标目录具有正确的读写权限（chmod 755/775）
• 运行服务的用户（如nginx）对目录有所有权
• 如果使用容器部署，注意volume挂载权限

2. 客户端设置调整

在Remotely-Save插件中：

• 确认Base Directory设置正确
• 检查deny/allow列表配置
• 推荐升级到最新版本（5.24+已修复相关问题）

最佳实践建议

1. 权限最小化原则：为WebDAV目录设置精确的权限控制
2. 版本升级策略：升级前备份重要数据
3. 日志分析：出现问题时检查Obsidian控制台日志
4. 测试环境验证：重要变更先在测试环境验证

技术延伸

WebDAV协议在文件同步场景中的优势：

• 标准HTTP/HTTPS协议，穿透性强
• 支持文件锁定等高级功能
• 跨平台兼容性好

对于自建WebDAV服务的用户，建议：

1. 使用nginx等成熟方案
2. 配置SSL加密
3. 实现合理的CORS策略
4. 设置适当的请求大小限制

总结

Remotely-Save插件的这次版本迭代反映了软件开发中常见的兼容性问题。通过理解底层机制和正确配置，用户可以充分发挥WebDAV同步方案的稳定性和可靠性。建议用户保持插件更新，同时注意服务端环境的正确配置。