WebDAV 渠道添加说明

适合什么场景

• 你有 NAS、网盘或对象存储服务提供的 WebDAV 地址。
• 你希望把图片上传到自己的 WebDAV 目录里。
• 你希望配置和凭据保存在 D1 上传渠道表 upload_channels 中，不直接放在前端页面里长期暴露。

添加前要准备什么

需要准备	用途
WebDAV Endpoint	服务端 WebDAV 地址，例如 https://nas.example.com/dav
用户名	登录 WebDAV 服务使用
密码	登录 WebDAV 服务使用
鉴权模式	默认 Basic，也可以按服务端要求选择 Digest 或自动协商
存储目录	文件保存目录，默认 imgbed

入口位置

1. 进入系统配置。
2. 打开上传设置。
3. 点击右上角“添加渠道”。
4. 选择 WebDAV。

字段说明

字段	作用	是否必填
渠道名称	用来区分当前 WebDAV 渠道，例如 koofr、nas	是
Endpoint	WebDAV 服务地址，需要填写完整 https:// 地址	是
用户名	WebDAV 登录用户名	是
密码	WebDAV 登录密码	是
鉴权模式	一般选 Basic；服务端要求摘要认证时选 Digest	是
存储目录	文件保存目录，默认 imgbed	否

以 fie.nl.tab.digital 为例

1. 创建应用密码

进入账号安全设置，找到应用程序密码，创建一个新的应用密码。

创建完成后，复制并保存这串新应用程序密码。这个密码通常只显示一次，关闭页面后就看不到了。

2. 回图床填写 WebDAV 配置

回到图床后台添加 WebDAV 渠道，按下面方式填写：

页面字段	填写内容
Endpoint	https://fie.nl.tab.digital/ 提供的 WebDAV 地址
用户名	你的 WebDAV 用户名
密码	刚才创建的新应用程序密码
鉴权模式	一般先选 Basic
存储目录	默认 imgbed，也可以改成自己的目录

大文件上传能力

WebDAV 渠道现在走真会话分块。

小文件会直接上传为一个完整文件；超过 64 MiB 的文件会自动切成 10 MiB 左右的分块，分别上传到远端分块目录。

这里不要求 WebDAV 服务支持 partial update（部分更新）或按偏移写入。系统不会在远端把分块重新合成一个文件，而是保存分块清单，读取文件时再按清单顺序读取分块并拼接返回。

简单理解：

文件大小	上传方式	远端保存形态
小于等于 64 MiB	普通上传	一个完整文件
大于 64 MiB	真会话分块上传	一个分块目录，里面保存多个分块文件

分块目录只影响远端存储结构，不会改变图床里的文件链接。用户访问时仍然使用原来的 /file/... 地址。

添加步骤

1. 打开上传设置页面。
2. 点击“添加渠道”。
3. 选择 WebDAV。
4. 渠道名称填一个自己能看懂的名字，例如 koofr。
5. Endpoint 填 WebDAV 地址，例如 https://app.koofr.net/dav/Koofr。
6. 填写用户名和密码。
7. 鉴权模式默认选 Basic。
8. 存储目录默认 imgbed，也可以改成自己的目录。
9. 点击保存。
10. 保存后查看渠道卡片，再查询容量或上传测试文件确认连接可用。

添加完成后怎么检查

检查项	检查方式
渠道卡片是否出现	保存后，上传设置页面应显示 WebDAV 渠道卡片
渠道是否启用	卡片右上角开关应保持开启
凭据是否保存	详情页能看到 Endpoint、用户名、鉴权模式、存储目录
小文件上传是否正常	上传一张测试图片，确认 WebDAV 目录里出现文件
大文件上传规则	超过 64 MiB 会走分块上传，远端会保存分块目录和分块文件
容量查询是否可用	点击查询，如果服务端支持容量信息，会显示已用容量和总容量

常见问题

WebDAV 大文件为什么会出现分块目录？

这是现在的大文件保存方式。

超过 64 MiB 的文件不会在远端合成一个大文件，而是保存为分块目录。图床会记录分块清单，访问时按顺序读取分块并返回完整内容。

大文件上传失败先检查什么？

先检查 Endpoint、用户名、密码和存储目录是否正确，再检查 WebDAV 服务是否允许创建目录、写入文件、读取文件。

如果容量查询失败，但小文件上传正常，通常是服务端不支持或限制容量信息查询，不一定代表上传不可用。

鉴权模式怎么选？

一般先用 Basic。

如果服务端明确要求摘要认证，就选 Digest。

不确定时可以选自动协商。

一句话流程速查

准备 WebDAV 地址、用户名、密码
-> 打开上传设置
-> 添加渠道
-> 选择 WebDAV
-> 填写 Endpoint / 用户名 / 密码
-> 鉴权模式默认 Basic
-> 存储目录默认 imgbed
-> 保存
-> 查询容量
-> 上传测试文件