Webdav云端
约 1699 字大约 6 分钟
2026-11-01
WebDAV 云端用于连接支持 WebDAV 协议的网盘或自建服务，例如坚果云、Koofr、AList 等。添加并启用账户后，可以在奕澄Markdown中浏览和管理云端文件，也可以将云端 Markdown 下载到本地镜像目录编辑并回传。
不同服务商的 WebDAV 地址、鉴权方式和权限可能不同。以下步骤以应用当前配置界面为准，实际兼容性请以你的服务商和连接结果为准。
准备连接信息
开始前，请从服务商处确认：
- WebDAV 服务器地址，包括协议、域名或 IPv4、端口和根目录。
- 用于 WebDAV 登录的账户与密码。
- 账户是否具有目标目录的读取、创建、上传和删除权限。
如果服务商要求使用“应用密码”或单独授权的第三方客户端密码，请使用该密码，不要直接使用账户登录密码。
添加 WebDAV 账户
- 打开 设置 > 云端设置 > 账户管理。
- 在页面顶部将协议切换为
webdav。 - 点击右上角新建按钮，选择 新建账户。
- 按下表填写信息。
- 打开 是否启用，点击顶部确认按钮保存。
| 配置项 | 填写说明 |
|---|---|
| 账户昵称 | 自定义的账户名称，同时用作本地镜像目录名称。建议使用简短、唯一的名称，不要包含 / 等路径分隔符 |
| 域名/IPv4 | 只填写服务器域名或 IPv4，例如 dav.jianguoyun.com，不要带 https://、端口或后续目录 |
| 端口号 | 按服务商地址填写；HTTPS 常见为 443，HTTP 常见为 80，自定义服务使用实际端口 |
| username | WebDAV 登录账户 |
| password | WebDAV 密码或服务商生成的应用密码 |
| 根目录 | 服务器地址后的 WebDAV 路径，例如 /dav/；不填写时默认为 / |
| 直链域名 | 可选项，用于需要公开访问或云端图床的场景，不影响普通云端文件浏览与同步 |
| 强制HTTPS | 服务器使用 HTTPS 时打开；使用 HTTP 时关闭 |
| 是否启用 | 打开后，该账户才会出现在云端浏览器的可用账户中 |
根目录会自动规范为带首尾 / 的形式。例如输入 dav，会按 /dav/ 处理。
坚果云地址示例
假设服务商提供的完整 WebDAV 地址为：
https://dav.jianguoyun.com/dav/可拆分为：
账户昵称：坚果云
域名/IPv4：dav.jianguoyun.com
端口号：443
username：你的账户
password：你的应用密码
根目录：/dav/
强制HTTPS：开启
是否启用：开启配置页面上方会显示地址和完整路径，保存前请检查拼接结果是否与服务商提供的 WebDAV 地址一致。其他服务的根目录不一定包含 /dav/，不要直接套用。
浏览和管理云端文件
- 从应用侧边栏进入 云端。
- 在顶部选择
webdav，再选择要使用的已启用账户。 - 点击文件夹进入目录；电脑端可使用鼠标双击。
- 使用顶部刷新按钮重新加载当前目录。
常用操作如下：
- 新建：在底部新建 Markdown 或文件夹。
- 导入：将本机文件、图库图片等导入当前云端目录。
- 打开：点击 Markdown 或 PDF 后，先下载到本地镜像目录，再进入编辑或预览。
- 文件菜单：长按文件，或在电脑端右键文件，可使用下载、编辑、预览、复制、移动、重命名、删除和复制下载地址等功能；实际项目以文件类型为准。
- 文件夹菜单：可重命名或删除文件夹。
复制、移动、重命名和删除会直接修改云端内容。删除文件夹前请特别确认其中是否仍有需要的文档。
编辑并同步 Markdown
从云端打开 Markdown 后，应用会将文件下载到当前账户的本地镜像目录。编辑时：
- 云端文档同步为自动：本地保存后，将当前文档回传到对应的 WebDAV 位置。
- 云端文档同步为手动：在编辑器顶部云端菜单选择 上传文档到云端。
- 图片未显示：确认文中使用相对路径后，执行 资源下载到本地。
- 插图需要回传：将 云端资源上传 设为自动，或手动执行 资源上传到云端。
三项设置的详细区别见 云端概述。
直链域名（可选）
普通云端浏览和文档同步使用 WebDAV 账户鉴权，不需要配置直链域名。只有需要将文件作为免登录的公网 URL 使用，例如配置云端图床时，才需要关注此项。
- WebDAV 下载地址通常需要认证，不天然等于公开直链。
- 服务商或 CDN 必须允许匿名访问对应文件，直链才能在浏览器或其他设备上直接打开。
- 可填写服务商提供的公开访问域名，使用 测试直链 检查当前配置；测试成功后仍需保存账户才会生效。
- 测试会实际执行上传、匿名访问和清理操作，请在有权写入的测试目录中进行。
- 当前界面对坚果云账户提示不支持直链。
不要为了让直链可访问而无意公开整个私人目录。
连接与使用问题排查
云端列表没有账户
检查账户管理顶部是否选择了 webdav，并确认账户已保存且 是否启用 已打开。
无法连接或目录为空
依次检查：
- 域名中是否误填了
http://、https://、端口或根目录。 - 强制HTTPS与端口是否匹配。
- 根目录是否与服务商标注的 WebDAV 路径完全一致。
- 设备是否能访问该服务器；自建服务还需检查局域网、防火墙和端口映射。
提示鉴权失败
核对 username、password，以及服务商是否要求应用密码。修改凭据后保存账户，再返回云端刷新。
可以浏览但不能新建或上传
检查目标目录的写入权限、剩余配额和服务商限制。文档同步失败时，本地镜像文件仍会保留，可修复问题后手动执行 上传文档到云端。
文档中的图片没有显示
确认图片路径相对于 Markdown 的位置正确，且图片已经存在于 WebDAV 对应目录。随后执行 资源下载到本地；已有本地缓存不会仅因云端图片变化而自动更新。