读懂并写出第一份 Nginx 配置

掌握指令、配置块和包含关系,编写可检查的独立 Nginx 配置。

🎯 引言

网页文件已经准备好,但 Nginx 还不知道在哪个端口接收请求、从哪里读取文件。本篇写出第一份完整配置,让这些决定都有明确的位置。


🧱 先认识配置语言

Nginx 配置由指令构成,一条指令就是一项设置,例如 worker_processes 1;。指令名后面是参数,普通指令以分号结尾;配置块用大括号包住一组指令。# 后面是注释,给人看,不会执行。

配置块不是随便嵌套的文件夹,每种指令都有允许出现的位置,也叫上下文:

位置负责什么
最外层实例总体设置,例如进程和日志
events连接处理设置
httpHTTP 请求的公共设置
server一组地址、端口和站点规则
location站点内某类路径的处理规则

服务器运行中的程序实例叫进程。Nginx 的主进程读取配置、管理工作进程;工作进程实际处理连接。入门阶段用一个工作进程即可,不需要先调优数量。


🛠 编写主配置

用 vim "$HOME/nginx-course/conf/nginx.conf" 新建主配置,保存以下完整内容:

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",保存:

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,观察错误行号,再补回分号重新检查。

验收:能够说明缺分号可能让报错指向下一条指令,并最终恢复两条检查成功提示。


🎉 你已经能从层级和路径两个角度读懂一份配置!