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 nginx | systemd 环境启动服务 | |
systemctl reload nginx | systemd 环境平滑重载配置 | |
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 nginx | CentOS / 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.logserver { 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; }grep " 50[0-9] " /var/log/nginx/access.log | tail -20 && tail -f /var/log/nginx/error.logmv 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 抢先匹配
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
Vim命令速查
模式切换、光标移动、编辑删除、搜索替换、寄存器宏、分屏窗口、配置与技巧等 Vim 常用命令速查手册
关于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 服务学习复习。