nginx 配置文件结构

Nginx 配置文件的层级结构、指令和常用配置项

语法

nginx.conf: main → events → http → server → location

参数

参数说明示例级别
worker_processes 工作进程数(通常设为 CPU 核数) worker_processes auto; 常用
worker_connections 每个进程最大连接数 worker_connections 1024; 常用
include 包含其他配置文件 include /etc/nginx/conf.d/*.conf; 常用
error_log 错误日志路径和级别 error_log /var/log/nginx/error.log warn; 常用
access_log 访问日志路径和格式 access_log /var/log/nginx/access.log main; 常用

示例

基础配置结构

worker_processes auto;

events {
    worker_connections 1024;
}

http {
    include mime.types;
    default_type application/octet-stream;
    sendfile on;
    keepalive_timeout 65;

    server {
        listen 80;
        server_name example.com;
        root /var/www/html;
    }
}
最小可用配置

查看配置文件位置

nginx -t
# 输出: nginx: the configuration file /etc/nginx/nginx.conf syntax is ok

按站点拆分配置

# /etc/nginx/conf.d/mysite.conf
server {
    listen 80;
    server_name mysite.com;
    root /var/www/mysite;
}
每个站点一个文件,通过 include 加载

常见错误

nginx: [emerg] unknown directive 指令拼写错误或缺少分号,检查配置语法

技巧

相关命令