WebDAV 详细介绍和使用文档
1. WebDAV 是什么
WebDAV，全称是 Web Distributed Authoring and Versioning，中文常译为“基于 Web 的分布式创作与版本控制协议”。
简单理解：
WebDAV 可以让你像访问本地硬盘一样，通过网络访问、上传、下载和管理远程服务器、NAS 或网盘里的文件。
它基于 HTTP/HTTPS 协议扩展而来，常用于网盘挂载、NAS 文件访问、手机照片备份、笔记同步、文档管理和私有云存储。
2. WebDAV 能做什么
WebDAV 支持常见的文件管理操作，包括：
- 查看远程文件和文件夹
- 上传文件
- 下载文件
- 新建文件夹
- 删除文件或文件夹
- 重命名文件
- 移动文件
- 复制文件
- 多设备访问同一份文件
- 给第三方软件提供同步存储位置
常见使用方式是：配置好 WebDAV 地址、用户名和密码后，在电脑或手机上直接像打开文件夹一样访问远程文件。
3. 常见使用场景
3.1 家庭 NAS 文件访问
如果家里有 NAS，可以开启 WebDAV 服务，实现：
- 外出时访问家中文件
- 手机查看 NAS 照片
- 平板播放 NAS 视频
- 公司电脑临时下载家庭资料
- 异地备份重要文件
3.2 网盘挂载
部分网盘或私有云支持 WebDAV。配置完成后，可以把网盘挂载成电脑里的一个网络磁盘。
例如：
此电脑
├── C盘
├── D盘
└── WebDAV网盘
3.3 手机照片备份
一些手机 App 支持 WebDAV 上传，可以设置：
- 拍照后自动上传
- 每晚自动同步相册
- 只在 Wi-Fi 下备份
- 只备份照片或视频
- 上传到 NAS 或服务器指定目录
3.4 笔记和配置同步
很多笔记软件、阅读软件、密码管理器或工具软件支持 WebDAV 同步。
适合用于：
- 多设备同步笔记
- 同步阅读进度
- 同步密码库文件
- 同步软件配置文件
4. WebDAV 的优点
4.1 通用性强
WebDAV 是开放协议，不绑定某一家厂商，很多系统、NAS 和软件都支持。
4.2 使用简单
配置完成后，用户可以像使用普通文件夹一样上传、下载和管理文件。
4.3 支持多平台
常见平台基本都可以使用 WebDAV：
| 平台 | 支持情况 |
|---|---|
| Windows | 支持 |
| macOS | 支持 |
| Linux | 支持 |
| iPhone / iPad | 通常通过 App 支持 |
| Android | 通常通过 App 支持 |
| NAS | 普遍支持 |
| 服务器 | 支持 |
4.4 适合私有化存储
如果不想把文件全部放在公共云盘，可以把 WebDAV 部署在：
- 家庭 NAS
- VPS 服务器
- 公司内网服务器
- 私有云平台
4.5 可配合 HTTPS 加密
使用 HTTPS 后，传输过程会被加密，比明文 HTTP 更安全。
5. WebDAV 的缺点和注意事项
5.1 大量小文件同步可能较慢
WebDAV 适合普通文件访问，但不太适合频繁同步大量小文件，例如程序依赖目录、缓存目录、大型代码仓库等。
5.2 不适合频繁直接编辑大型文件
如果直接在 WebDAV 目录中编辑大型文件，可能会遇到保存慢、冲突、锁定失败或网络中断导致文件损坏的问题。
建议：重要文件先下载到本地编辑，再上传。
5.3 权限配置要谨慎
WebDAV 如果暴露到公网，需要特别注意安全：
- 不要使用弱密码
- 尽量开启 HTTPS
- 不要开放匿名写入
- 不要直接共享根目录
- 给不同用户设置不同权限
5.4 Windows 原生体验一般
Windows 自带 WebDAV 功能，但有时可能出现连接慢、认证失败、路径兼容问题或文件大小限制。长期使用建议考虑第三方 WebDAV 客户端。
6. 使用 WebDAV 需要哪些信息
使用 WebDAV 通常需要以下信息：
6.1 WebDAV 地址
格式通常是：
协议://服务器地址:端口/路径
示例：
https://example.com/dav/
https://nas.example.com:5006/
http://192.168.1.100:5005/
6.2 用户名
用于登录 WebDAV 服务，例如：
admin
zhangsan
photo_backup
6.3 密码
用于身份验证。建议使用强密码，避免使用 123456、admin、生日、手机号等简单密码。
6.4 端口
常见端口如下：
| 协议 | 常见端口 |
|---|---|
| HTTP | 80 |
| HTTPS | 443 |
| NAS WebDAV | 5005 / 5006 等 |
不同设备可能不一样，以实际配置为准。
7. WebDAV 地址示例
7.1 局域网 NAS
http://192.168.1.100:5005/
适合在家里局域网访问。
7.2 HTTPS NAS
https://192.168.1.100:5006/
比 HTTP 更安全。
7.3 域名访问
https://nas.example.com/webdav/
适合外网访问。
7.4 指定目录访问
https://cloud.example.com/dav/files/user/
部分私有云或网盘会使用类似路径。
8. Windows 使用 WebDAV
8.1 方法一：映射网络驱动器
适合希望把 WebDAV 当成一个盘符使用的用户。
操作步骤：
- 打开“此电脑”。
- 点击“映射网络驱动器”。
- 选择一个盘符，例如
Z:。 - 在文件夹地址中输入 WebDAV 地址，例如：
https://example.com/dav/
- 勾选“登录时重新连接”。
- 点击“完成”。
- 输入用户名和密码。
- 连接成功后，会出现一个新的网络磁盘。
8.2 方法二：添加网络位置
操作步骤：
- 打开“此电脑”。
- 右键空白处。
- 选择“添加一个网络位置”。
- 点击“下一步”。
- 选择“选择自定义网络位置”。
- 输入 WebDAV 地址。
- 输入用户名和密码。
- 设置名称。
- 完成。
8.3 Windows 注意事项
- 推荐使用 HTTPS 地址。
- 如果连接失败，检查 WebClient 服务是否开启。
- 自签名证书可能导致连接失败。
- 如果经常使用，可以考虑 RaiDrive、Mountain Duck 等第三方工具。
9. macOS 使用 WebDAV
macOS 原生支持 WebDAV。
操作步骤：
- 打开 Finder。
- 点击顶部菜单“前往”。
- 选择“连接服务器”。
- 输入 WebDAV 地址，例如：
https://example.com/dav/
- 点击“连接”。
- 输入用户名和密码。
- 连接成功后，会在 Finder 中显示远程目录。
快捷键：
Command + K
10. iPhone / iPad 使用 WebDAV
iOS 原生“文件”App 对 WebDAV 支持有限，通常建议使用支持 WebDAV 的第三方 App。
通用步骤：
- 打开支持 WebDAV 的 App。
- 找到“添加服务器”或“添加云服务”。
- 选择 WebDAV。
- 输入服务器地址。
- 输入用户名和密码。
- 保存配置。
- 开始访问文件。
常见用途：
- 文件管理
- 阅读器同步
- 笔记同步
- 相册备份
- 视频播放
11. Android 使用 WebDAV
Android 通常需要第三方文件管理器或同步工具。
通用步骤：
- 安装支持 WebDAV 的文件管理器或同步工具。
- 打开 App。
- 添加网络存储。
- 选择 WebDAV。
- 输入地址、用户名、密码。
- 连接后即可上传、下载和管理文件。
12. 命令行测试 WebDAV
如果需要排查问题，可以使用 curl 测试。
12.1 查看目录
curl -u 用户名:密码 -X PROPFIND https://example.com/dav/
12.2 上传文件
curl -u 用户名:密码 -T test.txt https://example.com/dav/test.txt
12.3 下载文件
curl -u 用户名:密码 -o test.txt https://example.com/dav/test.txt
12.4 删除文件
curl -u 用户名:密码 -X DELETE https://example.com/dav/test.txt
12.5 创建目录
curl -u 用户名:密码 -X MKCOL https://example.com/dav/new-folder/
13. WebDAV 常见方法说明
WebDAV 基于 HTTP 扩展，常见方法如下：
| 操作 | 方法 |
|---|---|
| 查看文件 | GET |
| 上传文件 | PUT |
| 删除文件 | DELETE |
| 创建目录 | MKCOL |
| 查看目录属性 | PROPFIND |
| 移动文件 | MOVE |
| 复制文件 | COPY |
| 文件锁定 | LOCK |
| 文件解锁 | UNLOCK |
普通用户不需要记住这些，了解即可。
14. WebDAV 与 FTP 的区别
| 对比项 | WebDAV | FTP |
|---|---|---|
| 基础协议 | HTTP/HTTPS | FTP 协议 |
| 安全性 | HTTPS 较安全 | FTP 明文，需 FTPS/SFTP |
| 防火墙兼容性 | 较好 | 有时较麻烦 |
| 系统兼容性 | 较好 | 通常需要客户端 |
| 适合场景 | 网盘、同步、NAS | 服务器文件传输 |
简单建议：普通家庭或办公文件访问，优先考虑 WebDAV + HTTPS。
15. WebDAV 与 SMB 的区别
SMB 常用于 Windows 文件共享和局域网共享。
| 对比项 | WebDAV | SMB |
|---|---|---|
| 常见用途 | 远程文件访问、网盘 | 局域网文件共享 |
| 外网访问 | 更方便 | 不建议直接暴露公网 |
| 局域网速度 | 一般 | 通常更快 |
| 安全配置 | HTTPS 较方便 | 公网风险较高 |
| 适合设备 | 多平台 | Windows/NAS 常见 |
建议：
- 家里局域网内传大文件：优先 SMB。
- 外网访问文件：优先 WebDAV + HTTPS。
- 手机和 App 同步：WebDAV 更常见。
16. 安全使用建议
16.1 尽量使用 HTTPS
推荐：
https://example.com/dav/
不推荐公网使用：
http://example.com/dav/
HTTP 是明文传输，账号密码和文件内容可能被截获。
16.2 使用强密码
建议密码包含：
- 大写字母
- 小写字母
- 数字
- 特殊符号
- 至少 12 位
16.3 不要开放匿名写入
匿名写入可能被别人上传垃圾文件或恶意文件。
建议：
- 关闭匿名访问
- 只读账号单独设置
- 写入账号限制目录
16.4 不同人使用不同账号
不要全家或全公司共用管理员账号。
建议权限示例：
| 用户 | 权限 |
|---|---|
| 管理员 | 全部权限 |
| 家人 | 指定目录读写 |
| 临时用户 | 只读或限时 |
| 备份账号 | 只允许写入备份目录 |
16.5 不要暴露敏感根目录
不建议直接共享：
/
建议只共享指定目录：
/照片
/文档
/备份
16.6 配合防火墙或 VPN
如果条件允许，可以限制：
- 只允许家庭公网 IP 访问
- 只允许 VPN 访问
- 只允许内网访问
- 只开放必要端口
17. 常见问题排查
17.1 连接不上 WebDAV
可能原因：
- 地址写错。
- 端口没开。
- 服务没有启动。
- 路由器没有端口转发。
- 防火墙拦截。
- HTTPS 证书异常。
- 用户名或密码错误。
建议检查顺序：
确认地址 → 确认端口 → 确认账号密码 → 确认服务状态 → 确认网络
17.2 提示用户名或密码错误
可能原因：
- 用户名输错。
- 密码输错。
- 密码包含特殊字符导致复制错误。
- 账号没有 WebDAV 权限。
- 服务端关闭了该账号访问。
建议：
- 先在网页端或 NAS 后台确认账号可用。
- 重新复制密码。
- 检查是否开启 WebDAV 权限。
17.3 能看到目录，但不能上传
可能原因：
- 当前账号只有只读权限。
- 目标目录不允许写入。
- 磁盘空间不足。
- 文件名不合法。
- 单文件大小超过限制。
建议：
- 检查账号权限。
- 换一个目录测试。
- 上传一个小文件测试。
- 查看服务端空间是否已满。
17.4 上传速度很慢
可能原因：
- 网络带宽不足。
- 服务器性能较弱。
- 大量小文件。
- 手机后台限制。
- 使用了公网中转。
- HTTPS 加密开销。
建议：
- 优先在 Wi-Fi 下使用。
- 大量小文件先压缩再上传。
- 避免边编辑边同步。
- 检查 NAS 或服务器 CPU 占用。
17.5 Windows 无法连接
可以尝试：
- 确认使用 HTTPS 地址。
- 检查 WebClient 服务是否开启。
- 不使用自签名证书，或手动信任证书。
- 尝试第三方 WebDAV 客户端。
- 检查 Windows 是否限制上传文件大小。
17.6 文件名乱码
可能原因：
- 客户端编码兼容不好。
- 服务端编码设置异常。
- 文件名包含特殊字符。
建议避免使用以下特殊符号：
\ / : * ? " < > |
18. 常见部署方式
18.1 NAS 自带 WebDAV
很多 NAS 系统自带 WebDAV 服务。
优点：
- 配置简单
- 图形界面操作
- 适合家庭用户
适合：群晖、威联通、绿联 NAS、极空间、TrueNAS 等。
18.2 Nextcloud / ownCloud
这类私有云系统通常自带 WebDAV。
优点：
- 功能完整
- 支持用户管理
- 支持网页端
- 支持同步客户端
适合个人私有云或小团队文件协作。
18.3 Nginx 搭建 WebDAV
适合有服务器经验的用户。
优点：
- 性能较好
- 可控性强
- 适合 Linux 服务器
缺点：
- 配置门槛较高
- 权限和安全需要自己处理
18.4 Apache 搭建 WebDAV
Apache 原生模块支持 WebDAV。
优点：
- 成熟稳定
- 文档丰富
适合传统服务器环境或企业内网文件共享。
18.5 轻量 WebDAV 服务程序
适合：
- 临时共享文件
- 小型服务器
- Docker 部署
- 简单个人服务
19. 推荐目录结构
建议按用途分类：
/WebDAV
├── 照片
├── 文档
├── 家庭资料
├── 工作资料
├── 手机备份
├── 电脑备份
└── 临时共享
这样方便管理，也方便给不同账号分配权限。
20. 推荐使用习惯
- 重要资料不要只放一份，至少保留本地和远程两份。
- 不要多人同时编辑同一个文件，避免冲突。
- 给自动备份单独创建账号。
- 临时共享目录要定期清理。
- 外网访问务必使用 HTTPS。
- 不要给普通账号管理员权限。
- 定期检查登录记录和异常访问。
21. WebDAV 配置记录模板
可以用下面的模板记录自己的 WebDAV 信息：
WebDAV 名称：
WebDAV 地址：
用户名：
密码：
端口：
使用协议：HTTP / HTTPS
访问范围：局域网 / 外网
权限：只读 / 读写
用途：文件访问 / 照片备份 / 笔记同步 / 其他
示例：
WebDAV 名称：家庭 NAS
WebDAV 地址：https://nas.example.com:5006/
用户名：photo_backup
密码：********
端口：5006
使用协议：HTTPS
访问范围：外网
权限：只允许写入照片备份目录
用途：手机照片自动备份
22. 给家庭用户的推荐方案
22.1 局域网内访问大文件
推荐：
NAS + SMB
适合：电视播放影片、电脑传大文件、家里设备访问共享文件夹。
22.2 外网访问文件
推荐：
NAS + WebDAV + HTTPS
适合：出门访问家中文件、手机备份照片、平板读取文档。
22.3 多设备同步笔记或配置
推荐：
支持 WebDAV 的软件 + 单独同步目录
适合：笔记同步、阅读进度同步、密码库同步、软件配置同步。
23. 流程图与架构图 Mermaid 示例
下面这些 Mermaid 图可以直接放在支持 Mermaid 的 Markdown 编辑器、知识库、GitLab、部分 GitHub 页面、Obsidian、Typora、语雀、飞书文档插件或其他文档平台中渲染。
23.1 WebDAV 基本访问架构图
flowchart LR
A[用户设备\nWindows / macOS / 手机 / 平板] -->|输入 WebDAV 地址| B[WebDAV 客户端]
B -->|HTTP / HTTPS 请求| C[WebDAV 服务]
C -->|读写文件| D[(远程存储\nNAS / 服务器 / 私有云 / 网盘)]
D -->|返回文件或目录信息| C
C -->|响应结果| B
B -->|展示为文件夹或网盘| A
说明：
- 用户通过电脑、手机或 App 发起访问。
- WebDAV 客户端负责把文件操作转换成 WebDAV 请求。
- WebDAV 服务端负责权限验证和文件读写。
- 后端存储可以是 NAS、服务器硬盘、私有云或网盘空间。
23.2 WebDAV 登录与访问流程
flowchart TD
A[开始使用 WebDAV] --> B[准备 WebDAV 地址]
B --> C[输入用户名和密码]
C --> D{认证是否成功?}
D -- 否 --> E[检查地址、账号、密码和权限]
E --> C
D -- 是 --> F[读取远程目录]
F --> G{需要执行什么操作?}
G -- 查看文件 --> H[下载或预览文件]
G -- 上传文件 --> I[上传到指定目录]
G -- 新建目录 --> J[创建文件夹]
G -- 删除文件 --> K[删除指定文件]
H --> L[操作完成]
I --> L
J --> L
K --> L
说明：
- 首次连接时，最容易出错的是地址、端口、账号密码和权限。
- 认证成功后，就可以进行上传、下载、新建、删除等文件操作。
23.3 文件上传流程
sequenceDiagram
participant U as 用户
participant C as WebDAV 客户端
participant S as WebDAV 服务端
participant FS as 存储系统
U->>C: 选择要上传的文件
C->>S: PUT 上传请求
S->>S: 校验账号权限
alt 权限通过
S->>FS: 写入文件
FS-->>S: 写入成功
S-->>C: 返回上传成功
C-->>U: 显示上传完成
else 权限不足或空间不足
S-->>C: 返回错误信息
C-->>U: 提示上传失败
end
说明：
- 上传文件通常对应 WebDAV 的
PUT操作。 - 如果账号没有写入权限，或者磁盘空间不足，上传会失败。
23.4 文件下载流程
sequenceDiagram
participant U as 用户
participant C as WebDAV 客户端
participant S as WebDAV 服务端
participant FS as 存储系统
U->>C: 点击下载或打开文件
C->>S: GET 下载请求
S->>S: 校验读取权限
alt 权限通过
S->>FS: 读取文件内容
FS-->>S: 返回文件数据
S-->>C: 返回文件内容
C-->>U: 保存或打开文件
else 文件不存在或权限不足
S-->>C: 返回错误信息
C-->>U: 提示无法下载
end
说明：
- 下载文件通常对应 HTTP/WebDAV 的
GET操作。 - 如果文件不存在、路径错误或账号没有读取权限，会下载失败。
23.5 手机照片自动备份流程
flowchart TD
A[手机拍摄新照片] --> B{是否满足备份条件?}
B -- 否 --> C[等待下一次检测]
B -- 是 --> D[备份 App 扫描新照片]
D --> E[连接 WebDAV 服务]
E --> F{登录是否成功?}
F -- 否 --> G[提示账号或网络异常]
F -- 是 --> H[上传照片到备份目录]
H --> I{上传是否成功?}
I -- 否 --> J[记录失败并稍后重试]
I -- 是 --> K[标记已备份]
K --> L[备份完成]
常见备份条件包括：
- 连接到 Wi-Fi。
- 手机正在充电。
- 电量高于指定比例。
- 只在夜间或空闲时备份。
- 只备份指定相册。
23.6 家庭 NAS 外网访问推荐架构
flowchart LR
A[外出设备\n手机 / 笔记本] -->|HTTPS| B[域名\nnas.example.com]
B --> C[路由器 / 防火墙]
C -->|端口转发或反向代理| D[家庭 NAS]
D --> E[WebDAV 服务]
E --> F[(共享目录\n照片 / 文档 / 备份)]
G[管理员] -->|后台设置| D
G -->|创建单独账号| E
G -->|限制目录权限| F
建议：
- 外网访问尽量使用 HTTPS。
- 不建议直接暴露 NAS 管理后台。
- WebDAV 账号建议单独创建，不要使用管理员账号。
- 只开放需要访问的目录。
23.7 WebDAV 与 SMB、FTP 选择流程
flowchart TD
A[需要文件访问或同步] --> B{主要在哪里使用?}
B -- 家里局域网 --> C{是否经常传大文件?}
C -- 是 --> D[优先考虑 SMB]
C -- 否 --> E[SMB 或 WebDAV 都可以]
B -- 外网访问 --> F{是否能使用 HTTPS?}
F -- 是 --> G[优先考虑 WebDAV + HTTPS]
F -- 否 --> H[建议先配置 HTTPS / VPN]
B -- 服务器运维传输 --> I{是否已有 SFTP 环境?}
I -- 是 --> J[优先考虑 SFTP]
I -- 否 --> K[WebDAV 或 FTP/SFTP 按环境选择]
简单结论：
- 家庭局域网大文件：优先 SMB。
- 外网访问和 App 同步：优先 WebDAV + HTTPS。
- 服务器运维：常用 SFTP。
- 传统 FTP 不建议明文公网使用。
23.8 WebDAV 权限设计示意图
flowchart TD
A[WebDAV 服务] --> B[管理员账号]
A --> C[家庭成员账号]
A --> D[照片备份账号]
A --> E[临时共享账号]
B --> B1[全部目录读写]
C --> C1[家庭资料目录读写]
C --> C2[照片目录只读或读写]
D --> D1[只能写入手机备份目录]
E --> E1[只读临时共享目录]
B1 --> F[(全部文件)]
C1 --> G[(家庭资料)]
C2 --> H[(照片)]
D1 --> I[(手机备份)]
E1 --> J[(临时共享)]
建议：
- 管理员账号只用于管理，不建议日常同步使用。
- 手机自动备份账号只给备份目录权限。
- 临时共享账号尽量只读，并设置有效期。
- 不同用途使用不同账号，便于追踪和限制风险。
23.9 常见故障排查流程
flowchart TD
A[WebDAV 使用异常] --> B{能否连接服务器?}
B -- 否 --> C[检查地址、端口、网络、防火墙]
C --> D{服务是否正常运行?}
D -- 否 --> E[启动或重启 WebDAV 服务]
D -- 是 --> F[检查路由器端口转发 / HTTPS 证书]
B -- 是 --> G{能否登录?}
G -- 否 --> H[检查用户名、密码、账号状态]
H --> I[确认账号已开启 WebDAV 权限]
G -- 是 --> J{能否看到目录?}
J -- 否 --> K[检查目录路径和读取权限]
J -- 是 --> L{能否上传文件?}
L -- 否 --> M[检查写入权限、磁盘空间、文件名限制]
L -- 是 --> N[检查速度、稳定性和客户端兼容性]
排查建议：
- 先确认地址和端口。
- 再确认账号密码。
- 再确认目录权限。
- 最后检查客户端兼容性和网络质量。
23.10 推荐实施流程
flowchart TD
A[计划使用 WebDAV] --> B[确定使用场景]
B --> C{使用场景是什么?}
C -- 手机备份 --> D[创建手机备份目录]
C -- 文件访问 --> E[创建文档 / 照片 / 共享目录]
C -- 软件同步 --> F[创建单独同步目录]
D --> G[创建专用账号]
E --> G
F --> G
G --> H[设置最小必要权限]
H --> I[启用 HTTPS]
I --> J[在客户端添加 WebDAV]
J --> K[上传小文件测试]
K --> L{测试是否成功?}
L -- 否 --> M[按故障排查流程修正]
M --> K
L -- 是 --> N[正式使用]
N --> O[定期检查日志、空间和备份]
这套流程适合家庭用户或小团队首次启用 WebDAV。
24. 总结
WebDAV 是一种非常实用的网络文件访问协议。
一句话总结：
WebDAV 可以让远程服务器、NAS 或网盘像本地文件夹一样被访问和管理。
它适合：
- 家庭 NAS 访问
- 手机照片备份
- 多设备文件同步
- 私有云文件管理
- 办公文档共享
使用时重点注意三件事：
- 尽量使用 HTTPS。
- 账号密码要安全。
- 权限不要给太大。
家庭用户推荐方案：
WebDAV + HTTPS + 单独账号 + 指定目录权限
这样既方便，也相对安全。
