Cloud Blox

Appearance

WebDAV 协议 ​

本文介绍如何开通与使用 WebDAV 访问存储桶内文件，包括账号、连接地址、客户端配置与日志查看。该功能可能受版本或功能开关控制，若菜单中无相关入口，请确认已开通 WebDAV 能力。

适用场景 ​

  • 希望通过 WebDAV 协议挂载存储桶为「网络磁盘」，在文件管理器、备份软件、同步工具中使用时，可开通 WebDAV。
  • 常见支持 WebDAV 的客户端：Windows 资源管理器、macOS 访达、RaiDrive、Cyberduck、rclone 等。

开通与账号 ​

  1. 在管理后台进入 对象存储 → 存储桶列表，点击目标存储桶进入桶详情。
  2. 在桶设置中找到 WebDAV 或 WebDAV 账号 相关 Tab。
  3. 若系统已开启 WebDAV 功能，可在此为当前桶创建 WebDAV 账号：填写用户名、密码（及可选根路径等），保存后即生成一个仅能访问该桶（及指定路径）的账号。
  4. 每个桶可创建多个 WebDAV 账号，便于不同人员或设备使用不同账号；账号数可能受系统配置上限限制。

连接地址 ​

  1. 在桶的 WebDAV 设置页或「连接地址」入口中，可查看该桶的 WebDAV 地址。
  2. 地址通常包含协议（http/https）、主机（域名或 IP）、端口及路径；路径可能包含桶名或由服务端按 Host/路径解析到桶。请以页面上显示的为准。
  3. 将「连接地址」与刚创建的用户名、密码一并提供给 WebDAV 客户端使用。

客户端配置 ​

  1. Windows：在「此电脑」右键「映射网络驱动器」或「添加一个网络位置」，选择「自定义网络位置」，输入 WebDAV 地址（须含存储桶路径，如 https://dav.example.com/桶名）；按提示输入用户名与密码。若使用 HTTPS 且出现错误 0x80070043，请按下方「Windows 报错 0x80070043」处理。
  2. macOS：访达 → 前往 → 连接服务器，输入 WebDAV 地址，连接时输入用户名与密码。
  3. RaiDrive / Cyberduck / rclone：在添加 WebDAV 类型存储时，填写连接地址、用户名、密码，保存后即可挂载或浏览。
  4. 若连接失败，请检查：地址与端口是否正确、账号密码是否无误、防火墙与网络是否放行、服务端是否已开启 WebDAV 端口。

macOS 访达提示「连接服务器时出现问题」 ​

  • 若使用「连接服务器」时提示连接 localhost 或服务器出错，请确认：
    1. 地址必须带存储桶名：例如 http://你的域名:端口/存储桶名，不要只填 http://域名:端口。
    2. 先输完整地址再连接：在「连接服务器」框中输入完整 WebDAV 地址后点连接，再在弹出框中输入该桶的 WebDAV 用户名与密码。
    3. Cyberduck 能连而访达不能时，多为访达先发 OPTIONS 再认证；服务端已支持未认证 OPTIONS 以便访达正常完成协议发现，请更新到最新版本后重试。

Windows 报错 0x80070043（找不到网络名） ​

使用 HTTPS 地址（如 https://dav.1132111.com/cn-1-test）映射网络驱动器时，Windows 10/11 可能报错 0x80070043，提示「找不到网络名」。多为系统对 WebDAV 的 Basic 认证限制导致，可按以下步骤处理：

  1. 启用 WebDAV Basic 认证（需管理员权限）

    • 按 Win+R，输入 regedit 打开注册表。
    • 展开到：HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters。
    • 将 BasicAuthLevel 的值改为 2（0=仅 HTTP，1=HTTPS 仅 SSL 通道，2=HTTPS 允许 Basic）。若不存在则新建 DWORD（32 位）值，名称 BasicAuthLevel，数值 2。
    • 以管理员身份打开 CMD 或 PowerShell，执行：
      net stop WebClient
      net start WebClient

  2. 将你的 WebDAV 服务器加入认证转发列表（可选，部分环境必须）

    • 在同一注册表路径下，新建 多字符串值，名称 AuthForwardServerList。
    • 编辑，添加一行你的 DAV 主机，例如：https://dav.1132111.com（或按实际域名）。
    • 再次重启 WebClient 服务。

  3. 其他检查

    • 确认「WebClient」服务已启动（ Win+R → services.msc → 找到 WebClient → 启动）。
    • 地址必须带存储桶路径，如 https://dav.1132111.com/cn-1-test，不要漏掉 /cn-1-test。
    • 若证书为自签名，需在 Windows 中信任该证书，否则也可能出现类似错误。

完成上述设置后，再尝试「映射网络驱动器」或「添加网络位置」，输入完整地址并填写该桶的 WebDAV 用户名与密码。

macOS 访达盘内复制失败、出现 0 字节或错误 100004 ​

在 macOS 访达通过「连接服务器」挂载的 WebDAV 盘里做复制时，可能提示「复制失败」或「意外错误（错误代码 100004）」并在目标位置生成 0 字节 文件；同一操作在 Cyberduck 等客户端下通常正常。这是 访达 WebDAV 客户端的复制实现（多采用“先 GET 再 PUT”而非 WebDAV COPY）与部分环境下的兼容性问题，服务端无法单独修正。

建议：在 Mac 上需要可靠复制/移动时，使用 Cyberduck 等连接同一 WebDAV 地址后操作；或仅在访达挂载盘内做浏览与单文件编辑，复制用 Cyberduck 完成。已产生的 0 字节文件可在访达或管理后台中删除。

查看 WebDAV 日志 ​

  1. 在桶的 WebDAV 设置页一般提供「操作日志」或「WebDAV 日志」入口。
  2. 可查看该桶下各 WebDAV 账号的访问记录（如时间、路径、方法、状态码、客户端 IP 等），便于审计与排错。
  3. 部分产品还支持按账号筛选日志，便于定位某账号的使用情况。