Nginx 配置速查
Nginx 常用配置速查：共 26 条，涵盖基础配置、静态与反向代理、重写跳转、压缩缓存、安全限流五组片段， 支持搜索与分类筛选，点击即可复制。全部为静态数据，浏览器本地展示。
基础配置
主配置与 server 块的基本结构。
| 配置片段 | 说明 |
|---|---|
| 按 CPU 核心数自动设置工作进程数 | |
| 单进程最大并发连接数 | |
| 定义监听端口与域名 | |
| 站点根目录 | |
| 默认首页文件，按顺序查找 | |
| 引入子配置文件 |
静态与反向代理
托管静态资源或把请求转发给后端应用。
| 配置片段 | 说明 |
|---|---|
| 静态文件优先，找不到回退首页（SPA 常用） | |
| 反向代理到本地后端服务 | |
| 转发原始请求的 Host | |
| 把真实客户端 IP 传给后端 | |
| 追加代理链，便于后端取真实 IP | |
| 等待后端响应的超时时间 |
重写与跳转
HTTPS 跳转、旧路径迁移与域名归一。
| 配置片段 | 说明 |
|---|---|
| 全站 301 跳转到 HTTPS | |
| 旧路径永久跳转到新路径 | |
| 精确匹配的临时跳转 | |
| 裸域跳转到带 www 域名 |
压缩与缓存
减小传输体积、减轻重复请求。
| 配置片段 | 说明 |
|---|---|
| 开启 gzip 压缩 | |
| 指定需要压缩的响应类型 | |
| 按扩展名给静态资源设置 30 天缓存 | |
| 强缓存带指纹的资源 |
安全与限流
限流、安全响应头与访问控制。
| 配置片段 | 说明 |
|---|---|
| 定义基于 IP 的限流区 | |
| 应用限流，允许突发 20 个请求 | |
| 防止页面被跨站 iframe 嵌套 | |
| 禁止浏览器 MIME 类型嗅探 | |
| 拒绝指定 IP，放行其余 | |
| 开启 HTTP 基础认证 |
使用说明
Nginx 配置文件平时不常写，需要时又容易忘指令名和写法。这份速查表覆盖 server / location 基础、反向代理、静态资源、gzip、缓存、HTTPS 与重定向等高频片段，随用随查。
- 按关键词搜索，如「proxy」「gzip」「443」「redirect」。
- 点分类标签切换主题，如「反向代理」「安全与 HTTPS」。
- 点击左侧指令或配置片段复制，粘贴到自己的 nginx.conf 中修改。
常见问题
- proxy_pass 结尾带不带斜杠有区别吗？
- 有。proxy_pass 后带路径或带斜杠时，会替换匹配到的 location 前缀；不带时则原样透传，行为差别较大，务必按速查表中的说明核对。