必须在编译时添加--with-debug参数，否则error_log debug配置无效；再于server或location块中设error_log path debug，并确保路径权限正确、配合debug_connection限流。

要在 Linux 上通过源码编译 Nginx 并启用调试日志（debug log），关键在于编译时显式添加 --with-debug 参数。默认安装包或常规编译不包含 debug 支持，缺少该选项会导致配置中设置 error_log ... debug 无效，Nginx 启动时会报错或静默降级为 warn/error 级别。

编译前确认依赖和环境

确保系统已安装基础编译工具及可选模块依赖：

• gcc、make、perl、libpcre3-dev（或 pcre-devel）、zlib1g-dev（或 zlib-devel）
• 如需 HTTPS 支持，额外安装 openssl-dev（或 libssl-dev）
• 若使用自定义 PCRE/zlib 源码（非系统包），需用 --with-pcre=PATH 和 --with-zlib=PATH 显式指定路径

configure 阶段必须加入 --with-debug

进入 Nginx 源码目录后，执行 configure 命令时务必包含该参数。示例：

Browser Setup (No-Root Linux)

在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...

下载

./configure \
  --prefix=/usr/local/nginx \
  --with-http_ssl_module \
  --with-pcre \
  --with-zlib \
  --with-debug

注意：--with-debug 不是可选开关，而是编译期硬依赖。它会启用内部调试宏、增加日志钩子、保留断言逻辑，影响二进制体积和运行时开销。未加此参数，后续任何配置都无法激活 debug 日志。

编译安装与验证

完成 configure 后，执行标准流程：

• make && sudo make install
• 检查是否成功：运行 /usr/local/nginx/sbin/nginx -V 2>&1 | grep -o with-debug，有输出即表示已内置支持
• 启动前先测试配置：nginx -t，避免因 debug 日志路径不可写导致失败

配置文件中启用 debug 日志输出

编译成功只是前提，还需在 nginx.conf 中设置日志级别：

• 全局或 server 块内添加：error_log /var/log/nginx/debug.log debug;
• 路径需确保 Nginx 工作用户（如 nginx 或 www-data）有写权限
• 如只想对某 IP 调试，可用 debug_connection 192.168.1.100; 限制范围，减少日志量
• 修改后 reload：nginx -s reload