Nginx 编译及安装第三方模块

2025-08-10

Debian 默认安装的 Nginx 对 WebDav 的支持有限，需要重新进行编译和安装第三方功能模块，以下是具体流程 ( 以安装 WebDav 模块为例 )：

1 安装必要的依赖

1 2	`sudo apt update sudo apt install build-essential libpcre3 libpcre3-dev zlib1g zlib1g-dev libssl-dev wget`

2 下载 Nginx 源代码

从官方站点 https://nginx.org/download/ 挑选需要的 nginx 源代码，本文以 nginx 1.28.0 stable 为例。

cd /usr/local/src
wget http://nginx.org/download/nginx-x.x.x.tar.gz # 替换 x.x.x 为你所需的版本号
tar -zxvf nginx-x.x.x.tar.gz
cd nginx-x.x.x/

# 以下仅供参考
cd /usr/local/src
wget http://nginx.org/download/nginx-1.28.0.tar.gz
tar -zxvf nginx-1.28.0.tar.gz
cd nginx-1.28.0/

3 配置和编译必要模块

进入 nginx 的源码文件夹后，执行以下命令，安装 nginx-dav-ext-module 功能拓展模块，将克隆的第三方模块文件夹放在 nginx 源码文件夹内准备编译。

1	`git clone https://github.com/arut/nginx-dav-ext-module`

克隆完成后，开始编译，执行以下脚本：

./configure  \  # 准备构建软件包的命令，会生成一个或多个 Makefile 文件，这些文件定义了如何编译和安装相关软件；

--prefix=/usr/local/nginx  \  # 指定 Nginx 安装的基础目录

--sbin-path=/usr/local/nginx/sbin/nginx  \  # 主执行文件（可执行程序）的位置，这个路径下的二进制文件可通过命令行直接启动或停止 Nginx 服务

--conf-path=/usr/local/nginx/nginx.conf  \  # 主配置文件的位置，Nginx 启动时会读取这个配置文件来确定其行为和设置

--error-log-path=/usr/local/nginx/logs/error.log  \  # 错误日志的存放位置

--http-log-path=/usr/local/nginx/logs/access.log  \  # 访问日志的存放位置

--pid-path=/usr/local/nginx/logs/nginx.pid  \  # PID 文件的位置，保存当前运行中的 Nginx 进程 ID，有助于管理服务，如重启或关闭特定实例

# 自带功能模块筛选（本文针对 WebDav 模块，所选模块仅供参考）

--with-http_ssl_module  \  # 启用 HTTP SSL 模块，用于支持 HTTPS

--with-http_v2_module  \  # 启用 HTTP/2 协议支持模块

--with-http_v3_module \  # 启用 HTTP/3 协议支持模块

--with-threads \  # 允许使用多线程模式，以提高性能

--with-stream  \  # 支持 TCP 和 UDP 流量代理

--with-http_gzip_static_module  \  # 使 Nginx 能够直接发送预先压缩好的 .gz 文件，提高传输效率

--with-mail  \  # 启用简单邮件传输协议 (SMTP)、互联网消息访问协议 (IMAP) 和邮局协议版本 3 (POP3)

--with-http_dav_module  \  # 启用 WebDAV 功能，使得可以通过 Web 接口进行文件管理操作

# 附加第三方模块如下:

--add-module=../nginx-dav-ext-module  \  # 添加扩展 WebDAV 模块，提供更多关于锁定、属性等 DAV 操作的功能

--add-module=../headers-more-nginx-module  \  # 可以更灵活地设置或清除响应头信息