title: 基于Nginx搭建WebDAV服务
categories:
- [IT,网络,服务]
tags:
- WebDAV
- Nginx
comments: true
date: 2022-11-09 17:19:46
description:
在搭建 Joplin 笔记服务的时候,发现了可以通过 WebDAV 服务来实现云笔记的功能,所以本篇就来介绍一下,怎么快速搭建 WebDAV 服务。
WebDAV (Web-based Distributed Authoring and Versioning) 一种基于 HTTP 1.1协议的通信协议。它扩展了HTTP 1.1,在GET、POST、HEAD等几个HTTP标准方法以外添加了一些新的方法,使应用程序可对[Web Server](https://baike.baidu.com/item/Web Server/9306055?fromModule=lemma_inlink)直接读写,并支持写文件锁定(Locking)及解锁(Unlock),还可以支持文件的版本控制。
从我的角度,简单地理解为,类似于FTP服务,提供网络文件交互服务。可以使用用户名和密码来控制访问,通过特定的客户端,可以直接存储、下载、编辑文件。
搭建与配置
这里我是用宝塔面板来实现整个过程的,知晓原理后,也可以用其他类似的手段实现。
官方安装示例 [Nginx http_dav_module](Module ngx_http_dav_module (nginx.org))
重新安装 Nginx
在宝塔面板,Nginx 安装中选择 编译安装,并点击 添加自定义模块。
添加自定义模块
模块名称:http_dav_module
模块描述:webdev
模块参数:--with-http_dav_module --add-module=/root/nginx-dav-ext-module
前置脚本:git clone https://github.com/arut/nginx-dav-ext-module.git /root/nginx-dav-ext-module
nginx-dav-ext-module 介绍
标准的 ngx_http_dav_module 提供了部分WebDAV实现,仅支持GET、HEAD、PUT、DELETE、MKCOL、COPY和MOVE方法。要在 Nginx 中获得完整的 WebDAV 支持,您需要启用 ngx_http_dav_module 以及此模块(nginx-dav-ext-module)以补充缺少的方法,如:PROPFIND,OPTIONS,LOCK,UNLOCK。
部署 WebDAV 网站服务
添加一个新网站
在配置文件中添加以下内容(别忘了还要添加第二行代码,就在server
上面添加):
http {
dav_ext_lock_zone zone=foo:1m; # 默认锁超时值为 1 分钟
...
server {
...
location / {
root /www/wwwroot/webdav;
client_body_temp_path /www/wwwroot/webdav/client_temp;
#client_max_body_size 102400M;#大文件支持
dav_methods PUT DELETE MKCOL COPY MOVE;
create_full_put_path on;
dav_access user:rw group:rw all:r;
autoindex on;
# 需要 nginx-dav-ext-module 才有下面的选项
dav_ext_methods PROPFIND OPTIONS LOCK UNLOCK;
dav_ext_lock zone=foo;
}
}
}
在 网站目录 加入密码保护即可
应用
接下来,就可以在需要 WebDAV 服务的地方使用了。
比如:Joplin
WebDAV URL:就是你访问那个 WebDAV 网站的地址
用户名和密码:就是刚才设置的密码访问