nginx 默认不支持 echo-nginx-module,需源码编译集成:下载 v0.61 版本解压,获取原编译参数并追加 --add-module=路径,重新 configure、make、make install,最后验证模块存在并测试 location 中 echo 指令生效。

下载并解压 echo 模块
从官方仓库获取稳定版源码(推荐 v0.61):
-
下载:
wget https://github.com/openresty/echo-nginx-module/archive/v0.61.tar.gz -
解压:
tar zxvf v0.61.tar.gz -
记下路径,例如:
/opt/echo-nginx-module-0.61(后续配置要用到)
获取当前 Nginx 编译参数
避免遗漏原有模块或配置路径,先查看已安装 Nginx 的 configure 参数:
- 运行:
/usr/local/nginx/sbin/nginx -V(路径按你实际安装位置调整) - 复制输出中
configure arguments:后面整行内容 - 在该行末尾追加:
--add-module=/opt/echo-nginx-module-0.61
重新编译并安装
进入原始 Nginx 源码目录(不是安装目录),执行:
-
配置:
./configure [刚才复制的全部参数] --add-module=/opt/echo-nginx-module-0.61 -
编译:
make -j$(nproc)(加快速度,不加-j也可) -
安装(覆盖旧二进制):
make install
nginx 可执行文件,建议提前备份原二进制(如 cp /usr/local/nginx/sbin/nginx{,.bak})
验证与测试
确认模块已生效,并快速验证功能:
- 检查是否包含模块:
/usr/local/nginx/sbin/nginx -V 2>&1 | grep echo(应有echo-nginx-module字样) - 在
nginx.conf的某个server块中添加:
location /test-echo {
default_type text/plain;
echo "Hello from echo module!";
echo_flush;
}
- 重载配置:
/usr/local/nginx/sbin/nginx -s reload - 测试访问:
curl http://localhost/test-echo→ 应返回Hello from echo module!











