🟩
Nginx 指令速查
Nginx 常用配置指令速查。
本地处理 · 不上传
加载工具中…
相关：nginx · 配置 · 反向代理 · 指令
Nginx 指令速查列出常用配置指令与其作用，涵盖 server、location、代理、缓存与限流。Nginx 配置的匹配规则容易踩坑。
使用步骤
- 按 server、location、代理、缓存分类找指令
- 确认它允许出现在哪个上下文块中
- 改完先跑 nginx -t 校验语法
- 再用 reload 而不是 restart 使配置生效
使用场景
- 编写与调整 Nginx 配置
- 理解 location 匹配规则
- 配置反向代理
- 排查配置不生效的问题
小贴士
- location 的匹配有优先级：精确匹配、前缀匹配、正则匹配的顺序并非按书写顺序，这是配置不生效的头号原因。
- proxy_pass 后的地址末尾有无斜杠会改变路径的拼接方式，这个细节导致的 404 极为常见。
- 改完配置务必先执行 nginx -t 测试语法，通过后再 reload。直接 reload 错误配置会导致服务中断。
常见问题
location 为什么没匹配上？
因为匹配有优先级而非按书写顺序：精确匹配（=）优先，然后是最长前缀匹配，正则匹配（~）在前缀匹配之后但会覆盖普通前缀。理解这个顺序是排查的第一步。
proxy_pass 后要不要加斜杠？
影响很大。带斜杠时会去掉 location 匹配的前缀再拼接，不带则保留完整路径转发。这个差别导致的路径错误与 404 是 Nginx 配置中最经典的坑。
改了配置没生效？
确认执行了 nginx -s reload 而不只是保存文件。reload 前应先用 nginx -t 测试语法。此外还要检查是否有其他 server 块因 server_name 匹配优先而抢先处理了请求。
Nginx 指令速查是免费的吗？
是。本站所有工具完全免费，无需注册登录、无广告干扰，打开即用。
使用Nginx 指令速查，我的数据安全吗？
安全。该工具在你的浏览器本地完成处理，输入内容不会上传到服务器，隐私更有保障。