读懂并写出第一份 Nginx 配置
🎯 引言
网页文件已经准备好,但 Nginx 还不知道在哪个端口接收请求、从哪里读取文件。本篇写出第一份完整配置,让这些决定都有明确的位置。
🧱 先认识配置语言
Nginx 配置由指令构成,一条指令就是一项设置,例如 worker_processes 1;。指令名后面是参数,普通指令以分号结尾;配置块用大括号包住一组指令。# 后面是注释,给人看,不会执行。
配置块不是随便嵌套的文件夹,每种指令都有允许出现的位置,也叫上下文:
| 位置 | 负责什么 |
|---|---|
| 最外层 | 实例总体设置,例如进程和日志 |
events | 连接处理设置 |
http | HTTP 请求的公共设置 |
server | 一组地址、端口和站点规则 |
location | 站点内某类路径的处理规则 |
服务器运行中的程序实例叫进程。Nginx 的主进程读取配置、管理工作进程;工作进程实际处理连接。入门阶段用一个工作进程即可,不需要先调优数量。
🛠 编写主配置
用 vim "$HOME/nginx-course/conf/nginx.conf" 新建主配置,保存以下完整内容:
worker_processes 1;
pid logs/nginx.pid;
error_log logs/error.log notice;
events {
worker_connections 256;
}
http {
include /etc/nginx/mime.types;
default_type application/octet-stream;
access_log logs/access.log;
client_body_temp_path temp/client;
proxy_temp_path temp/proxy;
fastcgi_temp_path temp/fastcgi;
uwsgi_temp_path temp/uwsgi;
scgi_temp_path temp/scgi;
include servers/*.conf;
}
pid 文件记录主进程编号,后面重载时用它找到正确实例。worker_connections 限制单个工作进程能打开的连接数;代理还会占用到后台的连接,不能直接把这个数字当成可服务人数。
三项名字含 fastcgi、uwsgi、scgi 的临时目录属于其他应用转接模块,本课程不用这些模块,但提前指定路径,可避免普通用户检查配置时尝试创建系统临时目录。
mime.types 是安装包提供的“扩展名与内容类型对照表”,使 .css 被作为样式发送。没有匹配类型时使用 default_type,这里代表普通二进制数据。
include 表示在这里读入其他配置。servers/*.conf 相对于主配置所在目录,实际读取 conf/servers/ 中所有以 .conf 结尾的文件。root、日志、临时目录等相对路径则使用 -p 指定的实例前缀。这是两套不同的路径参照,不要都按终端当前目录理解。
🛠 编写站点配置
执行 vim "$HOME/nginx-course/conf/servers/site.conf",保存:
server {
listen 127.0.0.1:8080 default_server;
server_name notes.test;
charset utf-8;
root html;
index index.html;
location / {
try_files $uri $uri/ =404;
}
}
listen 是接收请求的地址和端口。127.0.0.1 限定为本机访问;default_server 表示这个地址和端口找不到匹配站点名时,交给这里处理。server_name 只是匹配请求里的站点名,不会注册域名,也不会创建 DNS 记录。
charset utf-8 说明文字编码,避免中文乱码。root html 指向实验目录下的 html;index 指定访问目录时寻找的首页。
location / 能匹配以 / 开头的路径。$uri 是 Nginx 的变量,表示规范化后的当前路径。try_files 从左到右尝试文件、目录,全部不存在就返回 404。文件定位细节会在静态网站章节展开。
🧰 检查是否写对
在定义过 ngx 的终端执行:
ngx -t
看到 syntax is ok 和 test is successful 才继续。-t 会检查语法并尝试打开配置引用的文件,但不会证明页面内容或接口逻辑正确。
如果显示 directive is not allowed here,先检查大括号和指令所在层级;提示找不到文件时,看清报错里完整路径。配置结构可对照Nginx 入门文档。
❓ 知识问答
Q1:site.conf 要不要再套一个 http?
不要。它已经被主配置的 http 包含,再写会形成非法嵌套。
Q2:为什么安装包的站点还在,却不影响这里?
本实例只读取我们指定的主配置和它包含的文件,没有读取 /etc/nginx/sites-enabled。
🧪 小练习
暂时删掉 charset utf-8; 末尾的分号,执行 ngx -t,观察错误行号,再补回分号重新检查。
验收:能够说明缺分号可能让报错指向下一条指令,并最终恢复两条检查成功提示。
🎉 你已经能从层级和路径两个角度读懂一份配置!
