nginx

要启动 nginx，执行 nginx 可执行程序即可。当 nginx 启动后，可通过 -s 参数来停止它或者让其重新加载配置。nginx 的命令参数参见表 1。

下面是 nginx -g 参数的实例：

$ nginx -g "pid /var/run/nginx.pid; worker_processes `sysctl -n hw.ncpu`;"

nginx -s 参数的含义如表 2 所示。

参考：NGINX Command-line parameters

NGINX 的配置文件由多个“section”组成，每个“section”的基本格式为：

<section> {
    <directive1> <parameters1>;
    <directive2> <parameters2>;
}

说明 1：全局的设置一般放在所有其它“section”的前面（即配置文件开始位置），且不用 {} 包围，后面将介绍。
说明 2：相同的指令可以出现在不同的 section 中（如 include 指令可以出现在任何 section 中）。在官方文档中，每个指令的“Context”属性说明了当前指令可用在哪些 section 中。如 error_log 指令可以出现在“main/http/mail/stream/server/location”section 中：

Syntax: error_log file [level];
Default: error_log logs/error.log error;
Context: main, http, mail, stream, server, location

参考：
NGINX 所有指令说明：Alphabetical index of directives

main 模块和 events 模块都是全局有效的。下面是配置例子：

user  nginx;                               # 运行Nginx的用户
worker_processes  4;                       # nginx工作进程数，建议设置为CPU总核心数

error_log  /var/log/nginx/error.log warn;
pid        /var/run/nginx.pid;             # pid文件路径

events {
    use epoll;                             # 指定事件模型，select|poll|kqueue|epoll|/dev/poll，参考http://nginx.org/en/docs/events.html
    worker_connections  1024;              # 1个工作进程最大的连接数
}

参考：http://nginx.org/en/docs/ngx_core_module.html

假设有下面配置：

http {
    server {
        listen      80;
        server_name example.org www.example.org;
        ...
    }

    server {
        listen      80;
        server_name example.net www.example.net;
        ...
    }

    server {
        listen      80;
        server_name example.com www.example.com;
        ...
    }
}

这 3 个 server 都监听在 80 端口，将通过 server_name 来定位配置。当请求数据的 HTTP Header 的 Host 字段为 example.org 或者 www.example.org 时，将使用第 1 个 server 配置；当 Host 字段为 example.net 或者 www.example.net 时，将使用第 2 个 server 配置；当 Host 字段为 example.com 或者 www.example.com 时，将使用第 3 个 server 配置。

如果请求数据的 HTTP Header 的 Host 字段为上面 6 个域名以外的情况（比如是另一个域名，或者是 IP，或者根本都没有 Host 字段等情况时），nginx 将使用 default server，而默认第 1 个 server 就是 default server。

当然，我们也可以显式地定义一个 default server，方法是在 listen 指令后面加上 default_server，如：

http {
    server {
        listen      80;
        server_name example.org www.example.org;
        ...
    }

    server {
        listen      80;
        server_name example.net www.example.net;
        ...
    }

    server {
        listen      80;
        server_name example.com www.example.com;
        ...
    }

    server {
        listen      80 default_server;        # 如果 Host 和前面几个 server 中的 server_name 无法匹配，则会使用这个配置
        server_name _;
        return 403;                           # 403 forbidden
    }
}

参考：http://nginx.org/en/docs/http/request_processing.html

负载均衡模块用于从“upstream”指令定义的后端服务器列表中选取一台服务器。

Nginx 默认支持下面负载均衡策略：

1. 加权轮询（默认），依次把请求发送给不同服务器，每个服务器的权值值默认为 1（weight=1）。
   
2. ip_hash，按客户端 ip 的 hash 结果分配服务器，来自同一个 ip 的客户端固定访问一个后端服务器，这可以解决动态网页存在的 session 共享问题。
   
3. hash：基于用户定义键的哈希。
   
4. least_conn，最少活动连接，该机制把请求转发给连接数较少的后端服务器。
   
5. least_time，最少平均响应时间。
   

location 指令用于设置对不同的 URI 使用不同的配置，它的基本语法为：

Syntax:	location [ = | ~ | ~* | ^~ ] uri { ... }
        location @name { ... }
Default:	—
Context:	server, location

location 后可接下面修饰符：
= 表示精确匹配，具有最高的优先级；
~* 表示不区分大小写的正则匹配；
~ 表示区分大小写的正则匹配；
^~ 表示常规的匹配，匹配符合以后，停止往下搜索正则。

假设有下面配置：

server {
    listen       8080;
    location = / {
        # [ configuration A ]
        return 200 'config A\n';
    }

    location / {
        # [ configuration B ]
        return 200 'config B\n';
    }

    location /documents/ {
        # [ configuration C ]
        return 200 'config C\n';
    }

    location ^~ /images/ {
        # [ configuration D ]
        return 200 'config D\n';
    }

    location ~* \.(gif|jpg|jpeg)$ {
        # [ configuration E ]
        return 200 'config E\n';
    }

    location = /images/abc.jpg {
        # [ configuration F ]
        return 200 'config F\n';
    }
}

下面是一些请求 URL 和会匹配的配置：

# URI                          # 会匹配的配置
/                              configuration A
/index.html                    configuration B
/documents/document.html       configuration C
/images/1.gif                  configuration D（不使用configuration E，因为 ^~ 比正则优先级高）
/documents/1.jpg               configuration E
/images/abc.jpg                configuration F（精确匹配，具有最高的优先级）

参考：http://nginx.org/en/docs/http/ngx_http_core_module.html#location

要配置 https 证书，设置下面 3 个 ssl 相关的指令即可：

server {
    listen              443;
    server_name         www.example.com;
    ssl on;
    ssl_certificate     www.example.com.crt;
    ssl_certificate_key www.example.com.key;
    ...
}

还有一种方式：不使用 ssl on 指令，在 listen 指令的端口后面加上 ssl 关键字即可：

server {
    listen              443 ssl;
    server_name         www.example.com;
    ssl_certificate     www.example.com.crt;
    ssl_certificate_key www.example.com.key;
    ...
}

参考：http://nginx.org/en/docs/http/configuring_https_servers.html

每个 API 都有访问上限，为了防止过大的访问频率导致系统不可用，我们往往需要对 API 访问进行限流。 常见的限流算法有漏桶算法（Leaky Bucket）和令牌桶算法（Token Bucket）。 这两者的主要区别在于“漏桶算法”能够强行限制数据的传输速率；而“令牌桶算法”在能够限制数据的平均传输速率外，还允许某种程度的突发传输。在“令牌桶算法”中，只要令牌桶中存在令牌，那么就允许突发地传输数据直到达到用户配置的阈值，它更适合于具有突发特性的流量。

NGINX 的模块 ngx_http_limit_req_module 实现了“漏桶算法”，可以用来对 API 访问进行限流。

如何使用 nginx 配置一个静态资源服务器呢？

增加一个配置文件（如“/etc/nginx/conf.d/test.conf”，或其它会加载的位置），内容如下：

server {
        listen    8000;
        root      /home/user1/html;
}

如何从 access_log 中统计出返回 404 的请求数？

如果没有定制过 access_log 的格式，默认使用的是“combined”格式，它的定义如下：

log_format combined '$remote_addr - $remote_user [$time_local] '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';

按照上面定义，返回的状态码位于“按空格分开字段”的第 9 个位置：

46.41.221.96 - - [12/Mar/2018:10:30:22 +0000] "GET /manager/html HTTP/1.1" 404 169 "-" "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:28.0) Gecko/20100101 Firefox/28.0"
    ^        ^ ^           ^              ^     ^        ^           ^      ^
    |        | |           |              |     |        |           |      |
    1        2 3           4              5     6        7           8      9

我们使用 awk 可以过滤出状态码为 404 的行（第 9 个域为 404），使用 wc 统计行数即可：

$ awk '$9 ~ /404/' /path/to/access.log | wc -l
329

如何让 nginx 按天生成 access log 文件呢？

方法一：利用定时任务，把日志文件移动到新位置，再发送 USR1 信号让 nginx 重新打开日志文件（相当于执行 nginx -s reopen ）。
新建文件“/usr/local/nginx/logs/nginxLogRotate.sh”，内容如下：

#!/bin/bash

LOGS_PATH=/usr/local/nginx/logs
YESTERDAY=$(date -d "yesterday" +%Y-%m-%d)
mv ${LOGS_PATH}/access.log ${LOGS_PATH}/access_${YESTERDAY}.log
mv ${LOGS_PATH}/error.log ${LOGS_PATH}/error_${YESTERDAY}.log

## 向nginx主进程发送USR1信号。nginx收到USR1信号会重新打开日志文件
kill -USR1 $(cat /usr/local/nginx/logs/nginx.pid)

在“/etc/crontab”中添加下面定时任务：

0 0 * * * root /usr/local/nginx/logs/nginxLogRotate.sh

上面条目表示，每天 00:00 以 root 身份执行脚本“/usr/local/nginx/logs/nginxLogRotate.sh”。

参考：https://blog.csdn.net/wangkai_123456/article/details/71056758

方法二（仅适用于 access_log 指令，不适用于 error_log 指令）。
在相应的 server block 中配置下面内容：

# 在内置变量$time_iso8601中（如2014-05-04T18:12:02+02:00），找出当前日期
if ($time_iso8601 ~ "^(\d{4})-(\d{2})-(\d{2})") {
	set $year $1;
	set $month $2;
	set $day $3;
}

access_log /var/log/nginx/$year-$month-$day-access.log;

注意：上面方法仅适用于 access_log 指令，error_log 指令中不支持使用变量。

参考：https://www.cambus.net/log-rotation-directly-within-nginx-configuration-file/

使用 return 可以把 http 请求重定向到 https，如：

server {
       listen         80;
       server_name    my.domain.com;
       return         301 https://$server_name$request_uri;
}

server {
       listen         443 ssl;
       server_name    my.domain.com;

       [....]
}

注：使用 rewrite 指令也可以实现相同的目标。

要 NGINX 实现 TCP/UDP 转发，配置 stream 块即可，如：

# 四层负载均衡
stream {
    upstream app {
        server 192.168.0.100:8000;
    }

    # tcp
    server {
        listen 8000;
        proxy_pass app;
    }

    # udp
    server {
        listen 8000 udp;
        proxy_pass app;
        proxy_responses 0;
    }
}

# 七层负载均衡
http {
  upstream app {
    server 192.168.0.100:8080;
    server 192.168.0.101:8080;
  }

  server {
    listen          8080;
    location / {
      proxy_pass      http://app;
    }
  }
}

Nginx 日志中出现下面错误：

stat() "/username/test/static/index.html" failed (13: permission denied)

这个问题很可能的原因是 Nginx 的 worker 进程对应用户没有 x 访问权限，可能通过下面命令来确认这个问题（假设用户名为 nginx）：

$ sudo -u nginx stat /username/test/static/index.html
stat: cannot stat '/username/test/static/index.html': Permission denied

解决办法是每层目录加上 x 权限，如：

chmod +x /username/
chmod +x /username/test/
chmod +x /username/test/static/

参考：https://stackoverflow.com/questions/25774999/nginx-stat-failed-13-permission-denied