GeekIt

Nginx命令速查

服务管理、配置指令、反向代理、HTTPS、限流缓存等 136 条常用命令

共 136 条命令与指令 · 8 类场景 · 点击右侧图标可复制

命令 / 指令说明复制
nginx -v查看 Nginx 版本号(-V 额外显示编译参数)
nginx -V 2>&1 | tr " " "\n"逐行查看编译参数,确认模块是否带 --with-http_ssl_module 等
nginx -t校验配置语法,改配置后必须执行的第一条命令
nginx -T | less输出完整生效配置(含 include 展开),排查配置从哪来
nginx -t -c /etc/nginx/nginx.conf校验指定配置文件
nginx启动 Nginx(未设置 systemd 时使用)
nginx -s reload平滑重载配置,不中断现有连接
nginx -s quit优雅停止,处理完现有请求后退出
nginx -s stop快速停止,立即中断连接
nginx -s reopen重新打开日志文件,日志切割后使用
systemctl start nginxsystemd 环境启动服务
systemctl reload nginxsystemd 环境平滑重载配置
systemctl enable --now nginx设置开机自启并立即启动
systemctl status nginx查看服务状态与最近报错
journalctl -u nginx -n 200 --no-pager查看 Nginx 服务日志(systemd 启动方式)
ss -lntp | grep nginx确认端口监听进程与地址
ps -ef | grep nginx查看 master/worker 进程是否正常
kill -HUP $(cat /run/nginx.pid)向 master 进程发 HUP 信号重载配置(等价 reload)
yum install -y nginx 与 apt install -y nginxCentOS / Ubuntu 安装 Nginx
yum copr enable @nginx/stable 与 dnf install nginx按官方仓库安装较新版本
命令 / 指令说明复制
nginx -t && nginx -s reload校验通过再重载,避免错误配置导致服务中断
include /etc/nginx/conf.d/*.conf;在 http 块内引入站点配置,便于分文件管理
worker_processes auto;按 CPU 核数自动设置工作进程数
worker_connections 10240;单 worker 最大连接数,位于 events 块
worker_rlimit_nofile 65535;提高 worker 进程的文件句柄上限,高并发必调
keepalive_timeout 65;长连接保持时间,减少握手开销
keepalive_requests 1000;单条长连接最大处理请求数
client_max_body_size 100m;允许的上传大小,解决 413 Request Entity Too Large
client_header_timeout 30s; 与 client_body_timeout 30s;读写请求头/体的超时时间
sendfile on; 与 tcp_nopush on;静态文件零拷贝传输,提升吞吐
tcp_nodelay on;小包立即发送,降低长连接延迟
server_tokens off;隐藏响应头中的 Nginx 版本号,降低信息暴露
types_hash_max_size 2048;MIME 类型表大小,避免大量 mime 配置告警
server_name example.com www.example.com;绑定域名,多域名空格分隔
listen 80 default_server;设为默认站点,兜底未匹配域名的请求
include mime.types;加载 MIME 类型映射,缺失会导致 CSS/JS 被当下载
命令 / 指令说明复制
root /data/www/site;站点根目录,自动拼接 location 路径
index index.html index.htm;默认首页文件顺序
location / { try_files $uri $uri/ /index.html; }SPA 前端路由回退到 index.html
location /assets/ { alias /data/static/assets/; }alias 直接替换 location 路径(root 是拼接)
location ~* \.(js|css|png|jpg|gif)$ { expires 7d; }按扩展名匹配并单独设置缓存策略
location = /health { return 200 "ok"; }精确匹配健康检查接口,返回固定内容
location ^~ /static/ { }前缀匹配且不再匹配正则 location
rewrite ^/old/(.*)$ /new/$1 permanent;301 永久重定向并保留路径参数
rewrite ^/api/(.*)$ /$1 break;内部改写不重定向,常用于后端前缀去除
return 301 https://$host$request_uri;HTTP 全站跳转 HTTPS
return 404;直接返回状态码,屏蔽敏感路径
autoindex on;开启目录列表,仅限内网临时使用
error_page 404 /404.html;自定义错误页面
error_page 500 502 503 504 /50x.html;统一配置 5xx 错误页
add_header X-Frame-Options SAMEORIGIN always;防点击劫持,always 保证错误响应也带上
命令 / 指令说明复制
location /api/ { proxy_pass http://127.0.0.1:8080/; }反向代理到后端,末尾斜杠决定是否保留前缀
proxy_set_header Host $host;透传原始域名,后端生成链接不出错
proxy_set_header X-Real-IP $remote_addr;把真实客户端 IP 传给后端
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;追加代理链 IP,便于日志溯源
proxy_set_header X-Forwarded-Proto $scheme;告诉后端原始协议,避免 HTTPS 判断错误
proxy_http_version 1.1;启用 HTTP/1.1,WebSocket 与长连接必需
proxy_set_header Upgrade $http_upgrade; 与 proxy_set_header Connection "upgrade";WebSocket 代理标准写法
proxy_connect_timeout 5s;与后端建立连接超时
proxy_read_timeout 60s;等待后端响应超时,长耗时接口需调大
proxy_send_timeout 60s;向后端发送请求超时
proxy_buffering on; 与 proxy_buffers 8 16k;开启响应缓冲,缓解后端慢速输出
proxy_next_upstream error timeout http_502;后端异常时自动切换到下一台
upstream app_pool { server 10.0.0.1:8080; server 10.0.0.2:8080; }定义后端服务器组
upstream app_pool { server 10.0.0.1:8080 weight=3; server 10.0.0.2:8080 weight=1; }加权轮询,按机器性能分配流量
upstream app_pool { ip_hash; server 10.0.0.1:8080; }按客户端 IP 做会话保持
upstream app_pool { least_conn; server 10.0.0.1:8080; }最少连接数调度,适合长连接业务
server 10.0.0.1:8080 max_fails=3 fail_timeout=30s;失败 3 次标记不可用 30 秒
server 10.0.0.1:8080 down; 与 backup;手动摘除节点或配置备用节点
proxy_pass http://app_pool/api/;代理到 upstream 名称,实现多机负载
add_header X-Upstream $upstream_addr always;响应头返回实际后端地址,排查转发问题
命令 / 指令说明复制
listen 443 ssl;监听 443 并开启 SSL(新版本推荐 listen 443 ssl http2)
ssl_certificate /etc/nginx/cert/fullchain.pem;证书链文件,必须包含中间证书
ssl_certificate_key /etc/nginx/cert/privkey.pem;私钥文件路径
ssl_protocols TLSv1.2 TLSv1.3;只启用安全协议版本,关闭 TLS1.0/1.1
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5;加密套件配置,兼顾安全与兼容
ssl_prefer_server_ciphers on;优先使用服务端加密套件顺序
ssl_session_cache shared:SSL:10m;共享会话缓存,减少握手开销
ssl_session_timeout 10m;会话缓存有效期
ssl_stapling on; 与 ssl_stapling_verify on;开启 OCSP Stapling 提升握手效率
resolver 223.5.5.5 8.8.8.8 valid=300s;OCSP 与动态解析所需 DNS
add_header Strict-Transport-Security "max-age=31536000" always;HSTS,强制浏览器走 HTTPS
server { listen 80; return 301 https://$host$request_uri; }HTTP 跳转 HTTPS 标准配置
openssl x509 -in fullchain.pem -noout -dates查看证书有效期,提前发现过期
openssl s_client -connect example.com:443 -servername example.com </dev/null模拟握手,验证证书链与协商协议
curl -Iv https://example.com查看 TLS 握手、协议版本与证书信息
certbot --nginx -d example.com -d www.example.com自动申请并配置 Let's Encrypt 证书
certbot renew --dry-run演练证书续期,确认定时任务可用
命令 / 指令说明复制
access_log /var/log/nginx/access.log main;访问日志路径与格式
error_log /var/log/nginx/error.log warn;错误日志路径与级别(调试时临时改 debug)
log_format main '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" $request_time $upstream_response_time';自定义日志格式,加入耗时字段便于分析
tail -f /var/log/nginx/error.log实时查看错误日志,排查 502/504
awk '{print $1}' access.log | sort | uniq -c | sort -rn | head统计访问量 Top IP
awk '{print $7}' access.log | sort | uniq -c | sort -rn | head统计请求量 Top URL
awk '$9>=500' access.log | tail -20筛出 5xx 响应记录
awk '{s+=$NF} END {print s/NR}' access.log按最后一列(request_time)估算平均耗时
grep -c " 499 " access.log统计 499(客户端提前断开)次数
grep "upstream timed out" error.log | tail定位后端超时(504)原因
grep "connect() failed" error.log | tail定位后端拒绝连接(502)原因
ss -lntp | grep -E ":80|:443"确认监听端口正常,排查端口被占用
curl -I -H "Host: example.com" http://127.0.0.1带 Host 本地探测虚拟主机配置
curl -o /dev/null -s -w "%{http_code} %{time_total}\n" https://example.com输出状态码与总耗时,快速拨测
nginx -T | grep -n "server_name"在全部生效配置中定位 server_name 冲突
ulimit -n查看句柄上限,报 too many open files 时必查
dmesg -T | tail -50查看内核日志,排查 OOM 或被系统 kill
命令 / 指令说明复制
limit_req_zone $binary_remote_addr zone=req_limit:10m rate=10r/s;在 http 块定义请求限流区,按 IP 计数
limit_req zone=req_limit burst=20 nodelay;在 location 应用限流,允许突发 20 个请求
limit_conn_zone $binary_remote_addr zone=conn_limit:10m;定义并发连接限流区
limit_conn conn_limit 20;单 IP 最大并发连接数
limit_req_status 429; 与 limit_conn_status 429;超限返回 429,便于监控区分
allow 10.0.0.0/8; deny all;IP 白名单,仅允许内网访问
deny 1.2.3.4;封禁指定 IP
auth_basic "Restricted"; 与 auth_basic_user_file /etc/nginx/.htpasswd;开启基础认证保护目录
htpasswd -c /etc/nginx/.htpasswd admin生成基础认证账号密码文件
location ~ /\.(git|svn|env) { deny all; }禁止访问敏感点文件
valid_referers none blocked example.com *.example.com;防盗链配置,配合 if ($invalid_referer) 返回 403
if ($invalid_referer) { return 403; }防盗链命中时拒绝请求
add_header X-Content-Type-Options nosniff always;禁止浏览器猜测 MIME 类型
add_header Content-Security-Policy "default-src 'self'" always;配置 CSP,降低 XSS 风险
set_real_ip_from 10.0.0.0/8; 与 real_ip_header X-Forwarded-For;前置 LB/CDN 场景还原真实客户端 IP
命令 / 指令说明复制
gzip on;开启 gzip 压缩
gzip_types text/css application/javascript application/json image/svg+xml;指定压缩的 MIME 类型,text/html 默认已压缩
gzip_min_length 1k;小于 1k 的响应不压缩,避免负收益
gzip_comp_level 5;压缩级别,1-9 折中选择,过高耗 CPU
gzip_vary on;输出 Vary: Accept-Encoding,便于 CDN 正确缓存
gzip_static on;优先使用预压缩的 .gz 文件,省 CPU
brotli on; 与 brotli_types text/css application/javascript;启用 Brotli 压缩(需编译 brotli 模块)
expires 30d;设置浏览器缓存过期时间
add_header Cache-Control "public, max-age=86400" always;精确控制缓存策略
add_header Cache-Control "no-store" always;对接口或 HTML 禁用缓存,避免脏数据
etag off;集群环境关闭 ETag,避免多机文件标识不一致
location ~* \.(js|css)$ { expires 30d; add_header Cache-Control "public"; }静态资源长期缓存(文件名带 hash 时最安全)
proxy_cache_path /data/cache levels=1:2 keys_zone=app_cache:10m max_size=10g inactive=60m;定义反向代理缓存目录与大小
proxy_cache app_cache; 与 proxy_cache_valid 200 10m;在 location 启用缓存并设置有效期
proxy_cache_bypass $http_cache_control;带 Cache-Control: no-cache 时绕过缓存
add_header X-Cache-Status $upstream_cache_status always;返回 HIT/MISS/EXPIRED,验证缓存是否生效

常用命令与配置组合

改配置标准流程nginx -t && nginx -s reload && tail -n 50 /var/log/nginx/error.log
HTTP 跳 HTTPSserver { listen 80; server_name example.com; return 301 https://$host$request_uri; }
反向代理模板location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; }
排查 5xx 请求grep " 50[0-9] " /var/log/nginx/access.log | tail -20 && tail -f /var/log/nginx/error.log
日志按天切割后重开mv access.log access.log.$(date +%F) && nginx -s reopen

典型报错排查思路

1. 502 Bad Gateway

后端未启动、端口不通、upstream 地址错;查 error.log 的 connect() failed

2. 504 Gateway Timeout

后端处理慢或 proxy_read_timeout 过小;看 upstream_response_time

3. 499 客户端断开

多为客户端主动取消或超时,检查后端响应耗时与网关超时配置

4. 413 Request Entity Too Large

调大 client_max_body_size,并确认前置 LB 限制

5. 改配置不生效

nginx -t 校验 + reload 是否成功,确认改的是生效的 include 文件

6. 静态资源 404

确认 root 与 alias 区别、末尾斜杠、以及是否有其他 location 抢先匹配

共 136 条 Nginx 命令与指令 · 按 Ctrl+F 或上方搜索框快速定位

关于Nginx命令速查

在线 Nginx 命令速查手册,按服务管理、配置结构与语法校验、静态站点与 URL 重写、反向代理与负载均衡、HTTPS 与证书、日志与排障、限流与访问安全、压缩与缓存等 8 类场景整理 100+ 条常用 Nginx 命令与配置指令,每条附中文说明,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 nginx -t、nginx -s reload、systemctl reload nginx、proxy_pass、proxy_set_header、upstream 负载均衡、try_files、rewrite、return、ssl_certificate、ssl_protocols、gzip、expires、limit_req_zone、allow/deny、auth_basic、log_format 等高频写法,并附 499/502/504/413 等典型报错排查思路。适用于 Nginx 部署上线、反向代理与 HTTPS 配置、动静分离、单机限流、日志分析与线上故障排查,以及运维面试与 Web 服务学习复习。

核心能力

  • 涵盖 nginx -t、nginx -s reload、systemctl reload nginx、proxy_pass、proxy_set_header、upstream 负载均衡、try_files、rewrite、return、ssl_certificate、ssl_protocols、gzip、expires、limit_req_zone、allow/deny、auth_basic、log_format 等高频写法,并附 499/502/504/413 等典型报错排查思路

适用场景

适用于 Nginx 部署上线、反向代理与 HTTPS 配置、动静分离、单机限流、日志分析与线上故障排查,以及运维面试与 Web 服务学习复习。Nginx命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

Nginx命令速查是免费的吗?需要注册或安装吗?
Nginx命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
Nginx命令速查支持哪些功能?
涵盖 nginx -t、nginx -s reload、systemctl reload nginx、proxy_pass、proxy_set_header、upstream 负载均衡、try_files、rewrite、return、ssl_certificate、ssl_protocols、gzip、expires、limit_req_zone、allow/deny、auth_basic、log_format 等高频写法,并附 499/502/504/413 等典型报错排查思路。
Nginx命令速查适合哪些场景使用?
适用于 Nginx 部署上线、反向代理与 HTTPS 配置、动静分离、单机限流、日志分析与线上故障排查,以及运维面试与 Web 服务学习复习。