在 Debian 上,Nginx 可以安装的模块主要分为 官方仓库中的预编译模块、第三方模块(需编译) 以及 动态模块(dynamic modules)。下面按常见分类说明。
Debian(以及 Ubuntu)把 Nginx 拆成了主包 + 很多模块包,通常以 nginx-* 或 libnginx-* 命名。
apt install nginx
nginx-full # 包含大多数常用模块
nginx-light # 轻量版
nginx-extras # 包含更多第三方/扩展模块
(不同 Debian 版本略有差异)
nginx-module-geoip / libnginx-mod-http-geoipnginx-module-image-filternginx-module-xsltnginx-module-perlnginx-module-mailnginx-module-streamlibnginx-mod-http-lua(部分版本)libnginx-mod-http-uploadprogresslibnginx-mod-http-auth-pamlibnginx-mod-http-dav-extlibnginx-mod-http-echolibnginx-mod-http-fancyindexlibnginx-mod-http-headers-morelibnginx-mod-http-ndklibnginx-mod-http-set-misclibnginx-mod-http-subs-filterlibnginx-mod-http-upstream-fair查看可用模块:
apt search nginx | grep module
不论哪种 Debian 包,以下模块通常都已包含:
mailstream从 Nginx 1.9.11+ 开始支持 .so 动态加载。
Debian 很多模块就是 动态模块:
load_module modules/ngx_http_lua_module.so;
查看已装动态模块:
ls /usr/lib/nginx/modules/
如果 Debian 仓库没有,你可以:
nginx-extras + 源码编译apt install nginx-extras
nginx -V # 查看编译参数
./configure --add-module=/path/module
make
make install
常见第三方模块:
✅ 优先:
apt install nginx-extras
apt install libnginx-mod-*
✅ 不够再:
如果你愿意,可以告诉我:
我可以给你精确可安装的模块清单 + 配置示例。