Nginx 安装、参数与反向代理实操笔记

使配置生效：

systemctl daemon-reload
systemctl enable --now nginx

Nginx 配置文件参数详解

1. 主配置文件结构

Nginx 的主配置文件通常分成四块：

main block: 主配置段，即全局配置段
# 事件驱动相关的配置
event { ... }

# http/https 作为 web 服务器相关配置段
http { ... }

# mail 作为邮件服务器相关配置段
mail { ... }

# stream 反向代理相关配置段
stream { ... }

2. 全局配置块参数

常见的全局参数如下：

user nginx nginx; # 启动 Nginx 工作进程的用户和组
worker_processes [number | auto]; # 启动 Nginx 工作进程的数量，一般设为和 CPU 核心数相同
worker_cpu_affinity 00000001 00000010 00000100 00001000 | auto ; # 将 worker 进程与 cpu 核数绑定
worker_rlimit_nofile 100000; # 所有 worker 最多打开 100000 个文件描述符
error_log logs/error.log notice; # 错误日志记录配置
pid logs/nginx.pid; # pid 文件保存路径

示例：CPU 与核心绑定

worker_processes auto;
worker_cpu_affinity 01 10;

测试：

nginx -t
nginx -s reload
ps aux | grep nginx
ps axo pid,cmd,psr | grep nginx

3. events 块配置参数

events {
    worker_connections 10000; # 单个 worker 工作进程最大并发数
    use epoll; # 使用 epoll 机制来实现高并发
    accept_mutex on; # 同一时刻一个请求访问只激活一个 work 进程处理
    multi_accept on; # 把数据缓存多个到一定程度，同时发送给 worker 处理
}

示例：提高并发处理能力

worker_rlimit_nofile 100000;
events {
    use epoll;
    worker_connections 10000;
}

修改系统限制：

vim /etc/security/limits.conf
* - nofile 100000
* - noproc 100000
ulimit -n 100000

测试并发：

dnf install httpd-tools -y
ab -n 100000 -c10000 http://172.25.254.100/index.html

4. http 块配置参数

http 块是最常用的地方，缓存、代理、日志格式、第三方模块，大多都在这里挂。很多人一开始会把所有配置都往这里塞，能跑是能跑，后期排错就很费劲，所以还是得分清楚公共部分和具体站点配置。

http {
    include mime.types;
    default_type application/octet-stream;
    
    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$http_x_forwarded_for"';
    access_log logs/access.log main;
    
    sendfile on;
    keepalive_timeout 65;
    
    server { # web 服务配置 }
    include "/usr/local/nginx/conf.d/*.conf";
}

示例：识别 php 文件为 text/html 类型

default_type text/html;

基于域名的 web 站点发布

mkdir -p /webdata/nginx/czg.org/czg/html
echo czg.czg.org > /webdata/nginx/czg.org/czg/html/index.html
mkdir /usr/local/nginx/conf.d
vim /usr/local/nginx/conf.d/vhosts.conf
server {
    listen 80;
    server_name www.czg.org;
    root /webdata/nginx/czg.org/czg/html/;
}

在主配置中引入：

include "/usr/local/nginx/conf.d/*.conf";

测试：

nginx -t
nginx -s reload
vim /etc/hosts
curl www.czg.org

location 中的 root 与 alias

root 指定 web 根目录，location 拼出来的路径会接在它后面。alias 更像路径重映射，写法更灵活，但也更容易把路径映射错，线上问题通常就出在这里。

location 的详细使用

在一个 server 里可以配置多个 location，它们负责把 URI 映射到文件系统或代理目标。

语法规则：location [ = | ~ | ~* | ^~ ] uri { ... }

• = 用于精确匹配。
• ^~ 用于普通前缀匹配，且优先于正则。
• ~ 用于正则匹配，区分大小写。
• ~* 用于正则匹配，不区分大小写。

优先级从高到低：=, ^~, ~/~*, 不带符号。

示例 - 精准匹配

location = /test {
    return 200 "punct = \n";
}

示例 - 正则前缀匹配

location ^~ /test {
    return 200 "punct = ^~\n";
}

长连接配置

keepalive_timeout timeout [header_timeout]; # 设定保持连接超时时长
keepalive_requests 数字; # 在一次长连接上所允许请求的资源的最大数量

Nginx Web 页面账户认证

这个功能由 ngx_http_auth_basic_module 提供，适合给管理页、调试页加一层简单保护。

创建加密信息

htpasswd -cmb /usr/local/nginx/.htpasswd czg czg
htpasswd -mb /usr/local/nginx/.htpasswd czr czr

编辑配置文件

location /admin {
    auth_basic "login passwd";
    auth_basic_user_file "/usr/local/nginx/.htpasswd";
}

测试

curl www.czg.org/admin/
curl www.czg.org/admin/ -uczg:czg

自定义错误页面

生成测试错误页面

mkdir /usr/local/nginx/errorpage
echo "Error Page" > /usr/local/nginx/errorpage/errormessage

编辑配置

error_page 404 405 503 502 /error;
location /error {
    alias /usr/local/nginx/errorpage/errormessage;
}

自定义错误日志

access_log logs/czg.org/czg.access;
error_log logs/czg.org/czg.error error;

Nginx 的文件检测

try_files 会按顺序检查文件或目录是否存在，找到第一个就直接返回。它比自己写一串 if 稳得多，排障时也更直观。

try_files $uri $uri.html $uri/index.html /errorpage/default.html;

下载服务器

location /download {
    root /usr/local/nginx;
}

Nginx 的状态页

状态页基于 ngx_http_stub_status_module。

location /status {
    stub_status;
    auth_basic "status page";
    auth_basic_user_file "/usr/local/nginx/.htpasswd";
    allow 172.25.254.0/24;
    deny all;
}

状态页会看到这些指标：Active connections, accepts, handled, requests, Reading, Writing, Waiting。

Nginx 的压缩功能

依赖模块 ngx_http_gzip_module。

gzip on;
gzip_comp_level 4;
gzip_disable "MSIE [1-6]\.";
gzip_min_length 1024k;
gzip_buffers 32 1024k;
gzip_types text/plain application/javascript text/css application/xml;
gzip_vary on;
gzip_static on;

Nginx 变量使用

常见内置变量有 $remote_addr、$args、$host、$request_uri、$server_name 等。

自定义变量

set $name czg;
set $tomcat_port 8080;

Nginx Rewrite 相关功能

ngx_http_rewrite_module 负责处理 rewrite 请求，平时最常见的还是 if、set、break、return 这几个指令。

if 指令

用于条件匹配判断。

if ( $http_user_agent ~ firefox ) {
    return 200 "test if messages";
}

set 指令

set $testname czg;

break 指令

用于中断当前相同作用域中的其他 Nginx 配置。

return 指令

用于完成请求处理，并直接返回响应状态码。

return 200 "hello world";

全站加密 https

制作 key：

openssl req -newkey rsa:2048 -nodes -sha256 -keyout /usr/local/nginx/certs/czg.org.key -x509 -days 365 -out /usr/local/nginx/certs/czg.org.crt

编辑配置文件：

listen 443 ssl;
ssl_certificate /usr/local/nginx/certs/cgz.org.crt;
ssl_certificate_key /usr/local/nginx/certs/czg.org.key;

判断文件是否存在

if ( !-e $request_filename ) {
    rewrite ^/(.*) /index.html;
}

Nginx 防盗链

基于客户端携带的 referer 做判断。

Nginx 反向代理功能

七层反向代理

这一层走 ngx_http_proxy_module。

配置简单的代理

location / {
    proxy_pass http://172.25.254.10:80;
}

实现动静分离

location ~* \.(php|js)$ {
    proxy_pass http://172.25.254.10:80;
}
location / {
    proxy_pass http://172.25.254.20:80;
}

配置缓存加速

proxy_cache_path /usr/local/nginx/proxy_cache levels=1:2:2 keys_zone=proxycache:20m inactive=120s max_size=1g;
proxy_cache proxycache;
proxy_cache_valid 200 302 301 10m;

四层反向代理

四层代理基于 ngx_stream_proxy_module。

stream {
    server {
        listen 3306;
        proxy_pass 172.25.254.50:3306;
    }
}

FastCGI

FastCGI 用来把客户端请求转给 php-fpm 处理。

fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi.conf;

php 源码编译安装

./configure --prefix=/usr/local/php --enable-fpm ...
make && make install

配置优化 php

cp php-fpm.conf.default php-fpm.conf
vim php-fpm.conf

Nginx 整合 php

location ~ \.php$ {
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index index.php;
    include fastcgi.conf;
}

php 动态扩展模块（php 的缓存模块）

安装 memcache 模块

配置 php 加载 memcache 模块

部署 memcached

php 高速缓存

如果要让 nginx 直接访问 memcache，需要 srcache-nginx-module 和 memc-nginx-module 两个模块。

重新编译 nginx 添加模块

./configure --add-module=/root/memc-nginx-module-0.20 --add-module=/root/srcache-nginx-module-0.33
make

更换二进制文件

cp -p objs/nginx /usr/local/nginx/sbin/

编辑 nginx 整合 memcache

upstream memcache {
    server 127.0.0.1:11211;
    keepalive 512;
}
location /memc {
    internal;
    memc_pass memcache;
}
location ~ \.php$ {
    srcache_fetch GET /memc $key;
    srcache_store PUT /memc $key;
    fastcgi_pass 127.0.0.1:9000;
}

nginx 二次开发版本

OpenResty 是基于 Nginx 与 Lua 的高性能 Web 平台。它和原生 nginx 的关系有点像'带了扩展生态的发行版'，但编译安装前通常得先把现有 nginx 处理干净，不然容易冲突。

IO 模型

IO 模型描述的是操作系统或程序和设备之间的数据传输方式。

同步 / 异步

同步：A 调用 B，B 的处理过程由 A 等着。

异步：A 调用 B 后就返回，B 自己慢慢处理。

阻塞 / 非阻塞

阻塞：A 一直等 B 的返回。

非阻塞：I/O 调用后立刻返回状态值。

五种 I/O 模型

阻塞 IO（最常见的 IO 模型）——同步阻塞
优点：编程简单。缺点：连接利用率不高。

非阻塞 IO——同步非阻塞
优点：实时性较好。缺点：轮询占用 CPU。

多路复用 I/O——同步阻塞
select、poll、epoll 都属于 IO 多路复用。

信号驱动 IO——同步非阻塞
优点：避免轮询。缺点：信号处理复杂。

异步 IO——异步非阻塞
优点：完全非阻塞，性能最好。缺点：操作系统支持不够统一。