Remotely Save插件WebDAV连接问题深度解析与解决方案

问题背景

在Obsidian笔记软件中使用Remotely Save插件时，部分用户遇到了WebDAV服务器连接异常的问题。主要表现为：

1. 连接测试失败，提示"Unable to establish connection"
2. 同步操作无法正常完成
3. 不同平台(Windows/iOS)表现一致

技术分析

WebDAV协议基础

WebDAV(Web Distributed Authoring and Versioning)是基于HTTP协议的扩展协议，主要用于远程文件管理。其核心操作包括：

• PROPFIND：获取资源属性
• MKCOL：创建集合(目录)
• PUT/GET：文件上传下载
• LOCK/UNLOCK：文件锁定机制

常见连接失败原因

1. 认证方式不匹配：Digest认证与Basic认证配置错误
2. Depth头缺失：WebDAV操作缺少必要的Depth头信息
3. URL路径问题：末尾斜杠处理不当
4. 服务器权限配置：目录读写权限设置错误

解决方案实践

认证类型选择

推荐使用Basic认证方式，配置要点：

• 确保服务器配置AUTH_TYPE=Basic
• 用户名密码采用Base64编码传输
• 启用HTTPS保证传输安全

Depth头设置关键

必须显式设置Depth头为1：

headers: {
    'Depth': '1'
}

这是WebDAV协议中目录操作的必要参数，缺失会导致403错误。

服务器配置建议

推荐两种经过验证的Docker方案：

1. Nginx方案：

• 使用dgraziotin/nginx-webdav-nononsense镜像
• 配置简单，性能较好
• 注意设置正确的volume挂载点

2. Apache方案：

• 使用bytemark/webdav镜像
• 功能全面，支持更多WebDAV特性
• 需要额外处理UTF-8编码问题

客户端配置规范

1. URL格式：http://server:port/path（末尾不加斜杠）
2. 基础目录：保持为空或指定具体子目录
3. 连接测试：先确保curl测试通过再配置插件

典型问题排查流程

1. 使用curl验证基础连接：

curl -v -X PROPFIND -H "Depth: 1" http://server/path

2. 检查服务器日志确认认证流程
3. 验证目录创建权限：

curl -X MKCOL http://server/newdir

4. 逐步增加Obsidian配置复杂度

总结

WebDAV同步问题的核心在于协议实现的规范性。通过规范服务器配置、正确设置Depth头、选择合适的认证方式，可以确保Remotely Save插件的稳定运行。建议用户在自建服务时优先考虑Nginx方案，并严格遵循WebDAV协议规范。

对于持续出现的问题，建议收集以下信息：

• 服务器访问日志
• curl测试完整输出
• 插件调试日志
• 服务器配置详情