如何用Ubuntu排查Nginx问题

Ubuntu 下 Nginx 问题排查实操手册

一、快速定位流程

• 检查配置语法：sudo nginx -t（若自定义配置路径：sudo nginx -t -c /path/nginx.conf）。通过后再进行重启或热加载。
• 查看服务状态：sudo systemctl status nginx，失败时用 sudo journalctl -xeu nginx 获取详细报错。
• 实时看错误日志：sudo tail -f /var/log/nginx/error.log，优先从最新错误入手。
• 验证端口监听：ss -tulnp | grep ':80\|:443'（或 netstat -tulnp | grep ':80\|:443'）。
• 访问验证：本地 curl -I http://127.0.0.1 或外网 curl -Iv https://你的域名，观察状态码与响应头。
• 防火墙放行：sudo ufw allow 80,443/tcp；云服务器还需在安全组放行对应端口。

二、常见故障与处理要点

三、日志与配置验证

• 配置验证与热加载
  • 语法：sudo nginx -t；成功后 sudo systemctl reload nginx（零停机）。
• 错误日志要点
  • 路径：/var/log/nginx/error.log；实时跟踪：sudo tail -f /var/log/nginx/error.log。
  • 典型行：
    • bind() to 0.0.0.0:80 failed → 端口冲突；
    • Permission denied → 权限/属主/路径问题；
    • connect() failed (111: Connection refused) → 上游未启动或端口错误；
    • upstream timed out → 上游慢或超时阈值过低。
• 访问日志分析
  • 路径：/var/log/nginx/access.log；常用：tail -f 实时看、awk 统计 Top IP/URL，用于定位异常流量与错误集中点。
• 深入调试
  • 进程跟踪：sudo strace -p <worker_pid> -s 1024 -e trace=file,network 可快速看到文件访问拒绝或连接被拒等系统调用失败点。

四、进阶排查与优化

• 上游连通性细化
  • TCP：ss -tulpn | grep :9000、telnet 127.0.0.1 9000；
  • Unix 套接字：确认 socket 文件存在且路径正确，Nginx 与上游运行用户/组一致，必要时调整权限或以 socket 组运行。
• 代理与路径细节
  • proxy_pass 末尾斜杠会影响路径拼接；按需选择 proxy_pass http://127.0.0.1:3000; 与 proxy_pass http://127.0.0.1:3000/;。
• 安全与策略
  • Ubuntu 默认多启用 AppArmor；若确认策略过严导致拒绝，可先检查状态并调整策略或临时停用用于排查（生产谨慎）。
• 防火墙与云安全组
  • sudo ufw status 与云控制台安全组同时核对 80/443 放行状态。
• 日志轮转与容量
  • 配置 /etc/logrotate.d/nginx 自动轮转，防止磁盘被日志撑满。

五、一键排查脚本示例

#!/usr/bin/env bash
set -Eeuo pipefail

echo "=== 1) 配置语法 ==="
sudo nginx -t

echo -e "\n=== 2) 服务状态 ==="
sudo systemctl status nginx --no-pager || true
sudo journalctl -xeu nginx --no-pager -n 50 || true

echo -e "\n=== 3) 监听端口 ==="
ss -tulnp | grep ':80\|:443' || echo "未检测到 80/443 监听"

echo -e "\n=== 4) 错误日志尾部 ==="
sudo tail -n 50 /var/log/nginx/error.log || echo "无法读取错误日志"

echo -e "\n=== 5) 访问日志最新 10 行 ==="
sudo tail -n 10 /var/log/nginx/access.log || echo "无法读取访问日志"

echo -e "\n=== 6) 防火墙状态 ==="
sudo ufw status || echo "ufw 未安装或未启用"

echo -e "\n=== 7) 本机连通性测试 ==="
curl -I http://127.0.0.1 || echo "本机访问 127.0.0.1 失败"

• 使用方法：保存为 nginx-debug.sh，chmod +x nginx-debug.sh，执行 ./nginx-debug.sh。
• 建议同时在外网执行：curl -Iv https://你的域名 核对 TLS 握手与返回码。