Nginx配置文件详解【20260611】001篇
文章目录
- 1) Nginx 配置文件在哪里、怎么加载
- 2) 配置的“层级结构”(最重要)
- 最外层(main)常见项
- 3) events { }:连接模型
- 4) http { }:HTTP 全局默认值(你会反复复用)
- 5) server { }:虚拟主机(按域名/端口区分站点)
- 最小骨架
- 6) location { }:URI 路由(最容易被用错的地方)
- 匹配规则优先级(记住这个顺序就不会乱)
- 常见写法对照
- 7) root vs alias(90% 的静态资源坑在这里)
- 用 root(更推荐、更直观)
- 用 alias(只在特定 location 映射“目录别名”,新手更容易踩雷)
- 8) try_files:解决 SPA / 找不到文件 / 转发入口
- SPA(前端路由 history 模式)标准写法
- 9) 反向代理(最常见生产用法)
- proxy_pass 的“斜杠陷阱”(老司机也翻车)
- 10) 一个“可直接改着用”的完整模板(静态 + API 反代)
- 11) 排错清单(看这里基本能定位 80% 问题)
下面按“配置从哪来 → 文件怎么组织 → 语法块/指令含义 → 关键坑位 → 可直接抄的模板”把 Nginx 配置文件讲清楚(以常见Nginx 1.18+ / 1.24+为准,不同版本只是少量指令新旧差异)。
1) Nginx 配置文件在哪里、怎么加载
主流 Linux 发行版默认路径一般是:
/etc/nginx/nginx.conf # 主配置文件 /etc/nginx/conf.d/*.conf # 推荐放“站点级”配置 /etc/nginx/sites-enabled/* # 有些系统用这个(软链到 sites-available)加载顺序本质只有一条规则:nginx.conf 里用 include 把其他文件拉进来。
你可以看到类似:
http { include /etc/nginx/mime.types; include /etc/nginx/conf.d/*.conf; }所以你新建一个
/etc/nginx/conf.d/myapp.conf再nginx -s reload,Nginx 就会读到它。
