macOS原生支持mount_webdav命令挂载WebDAV,需用https地址、钥匙串存凭据或-i交互输入,挂载点须为空目录;Finder中Cmd+K连接更友好,推荐日常使用,命令行适合脚本集成。

macOS 系统原生支持通过 mount_webdav 命令将 WebDAV 服务挂载为本地磁盘,无需第三方软件。关键在于正确构造 URL、处理认证、规避常见挂载限制(如 Finder 不显示、权限异常、自动断开等)。
确认 WebDAV 地址与认证方式
WebDAV 地址需以 https:// 开头(不支持 http),路径结尾建议不带斜杠(如 https://dav.example.com/remote.php/webdav)。macOS 默认使用 HTTP Basic 认证,部分服务(如 Nextcloud、ownCloud)要求先在钥匙串中保存凭据,或在命令中显式传入用户名密码(不推荐明文)。
- 若服务启用双因素认证(2FA),需使用应用专用密码(如 iCloud、Google Drive 的“应用专用密码”)
- 企业环境若使用 SAML 或 OAuth 登录,通常无法直接挂载,需改用官方客户端或反向代理转为标准 WebDAV
- 可先用 Safari 手动访问该地址,确认能弹出登录框并成功列出文件,再执行挂载
使用 mount_webdav 命令挂载
终端执行挂载前,需确保目标挂载点(本地目录)已存在且为空:
mkdir -p ~/WebDAV-Mount sudo mount_webdav -i https://dav.example.com/remote.php/webdav ~/WebDAV-Mount
加 -i 参数会交互式提示输入用户名和密码,凭据自动存入钥匙串,后续自动复用。不加 -i 则需提前在钥匙串中创建对应服务器的“互联网密码”条目。
- 挂载后可用
df -h查看是否成功,应出现类似webdav://dav.example.com/...的条目 - 若提示
Operation not permitted,检查系统完整性保护(SIP)未禁用,且挂载点不在受保护目录(如/System、/usr)内 - 若提示
Connection failed,检查防火墙、网络策略是否放行 443 端口,或服务端是否启用 CORS 和 PROPFIND 方法
让挂载卷在 Finder 中可见并保持连接
默认挂载的 WebDAV 卷不会出现在 Finder 侧边栏,但可在“前往 → 连接服务器”(Cmd+K)中输入相同 URL 手动连接——此时 Finder 会创建一个独立会话,图标更友好,且支持拖拽上传。
- 为实现开机自动挂载,可将挂载命令写入 shell 脚本,并添加为登录项(系统设置 → 用户与群组 → 登录项),注意避免 sudo 密码交互
- WebDAV 连接空闲约 15 分钟可能断开,可配合
launchd定期检测并重挂(例如每 10 分钟运行一次mount | grep webdav || mount_webdav ...) - Finder 连接方式(Cmd+K)比命令行挂载对中文文件名、特殊字符兼容性更好,推荐日常使用;命令行挂载更适合脚本集成或后台同步
卸载与故障排查
正常卸载使用:sudo umount ~/WebDAV-Mount。若提示 Resource busy,说明有进程正在访问该目录(如 Terminal 当前路径、Finder 窗口打开、Spotlight 正在索引),可先关闭相关应用,或强制卸载:sudo umount -f ~/WebDAV-Mount。
- 挂载后无法写入?检查服务端 WebDAV 配置是否开启
PROPPATCH、PUT、MKCOL权限,以及 macOS 文件名长度限制(最长 255 字符) - 文件时间戳不准?WebDAV 协议本身不保证精确修改时间同步,属正常行为,不影响内容一致性
- 频繁掉线?尝试在挂载命令后加
-o nobrowse(隐藏挂载点)或改用-o automounted提升稳定性









