Nginx使用手册

Appearance

Nginx基本数据类型 ​

nginx配置都是指令紧跟值来实现配置，值的类型主要分为以下几种，nginx官网文档并没有基本数据类型的介绍， 以下数据类型来源于个人总结。

string ​

字符串是最常见的配置属性类型，可以用双引号包围，若存在特殊字符或中文最好用引号包围。

nginx
# 简单字符串可以不用引号
user root root;

server {
    listen 8080;
    location / {
        # 存在中文
        root "D:/我的网站";
    }
}
# 简单字符串可以不用引号
user root root;

server {
    listen 8080;
    location / {
        # 存在中文
        root "D:/我的网站";
    }
}

number ​

表示数值，可以是整数或浮点数。

nginx
# 配置工作进场数量
worker_processes 8;
# 配置工作进场数量
worker_processes 8;

enum ​

取值只能是给定的枚举范围之一，比如布尔类型，在nginx中是使用on和off对应。

nginx
# 可选值 on/off
daemon off;
# 可选值 on/off/always
lingering_close on;
# 可选值 on/off
daemon off;
# 可选值 on/off/always
lingering_close on;

file ​

文件路径，若以/开头表示绝对路径，否则表示nginx根目录的相对路径

nginx
# 错误日志文件默认配置路径
error_log logs/error.log;
# 使用绝对路径配置
error_log /var/logs/nginx/error.log
# 错误日志文件默认配置路径
error_log logs/error.log;
# 使用绝对路径配置
error_log /var/logs/nginx/error.log

directory: ​

文件目录路径，若以/开头表示绝对路径，否则表示nginx根目录的相对路径

nginx
location /absolute {
    root /opt/web;
}

location /relative {
    root relative;
}
location /absolute {
    root /opt/web;
}

location /relative {
    root relative;
}

size ​

一般表示容量大小，数字后面加单位k、m、g、t表示单位，不带单位表示字节(byte)。

nginx
client_max_body_size 1g;
client_max_body_size 1g;

time/interval ​

一般用于标识时间间隔或持续时长，数字后面加单位ms、s、m、h、d。

nginx
keepalive_timeout 30s;
proxy_read_timeout 1m;
keepalive_timeout 30s;
proxy_read_timeout 1m;

list ​

一般是空格分隔，表示接受一个或多个相同类型的参数

nginx
# 字符串类型列表
server_name abc.com cba.com nbc.com;
# 数字类型列表
error_page 500 502 503 504 /50x.html;
# 字符串类型列表
server_name abc.com cba.com nbc.com;
# 数字类型列表
error_page 500 502 503 504 /50x.html;

block ​

某些指令参数接受的一个特定的块配置，而不是基本参数类型，一般接受块为参数的指令称作context(上下文)。

nginx
# 简单块
http {
    listen 8080;
    server_name _;
    
    # 第一个参数为字符串，第二个参数为块
    location / {
        root /opt/web;
    }
}
# 简单块
http {
    listen 8080;
    server_name _;
    
    # 第一个参数为字符串，第二个参数为块
    location / {
        root /opt/web;
    }
}