1
192.168.1.100 - username [29/Nov/2024:14:23:45 +0800] "GET /api/user HTTP/1.1" 200 1234 "https://example.com" "Mozilla/5.0"

1
http {
2
    # 自定义日志格式，添加响应时间
3
    log_format main_with_time '$remote_addr - $remote_user [$time_local] "$request" '
4
                            '$status $body_bytes_sent "$http_referer" '
5
                            '"$http_user_agent" '
6
                            'rt=$request_time urt=$upstream_response_time';
7

8
    server {
9
        listen 80;
10
        server_name example.com;
11

12
        # 引用自定义格式
13
        access_log /var/log/nginx/access.log main_with_time;
14

15
        location / {
16
            proxy_pass http://backend;
17
        }
18
    }
19
}

1
error_log /var/log/nginx/error.log warn;

1
server {
2
    location = /api/login {
3
        # 只匹配 /api/login 这个字符串，不匹配 /api/login/submit
4
        proxy_pass http://auth_backend;
5
    }
6

7
    location ^~ /static/ {
8
        # 匹配 /static/ 开头的所有请求
9
        # 即使有正则匹配，也优先走这个（因为有 ^~）
10
        root /var/www;
11
        expires 7d;
12
    }
13

14
    location ~ \.(jpg|png|gif)$ {
15
        # 匹配 .jpg/.png/.gif 结尾的文件（区分大小写）
16
        root /var/www;
17
        expires 30d;
18
    }
19

20
    location ~* \.(jpg|png|gif)$ {
21
        # 匹配任何大小写的图片文件
22
        root /var/www;
23
        expires 30d;
24
    }
25

26
    location / {
27
        # 通用前缀匹配，兜底所有没被上面规则匹配的请求
28
        proxy_pass http://default_backend;
29
    }
30
}

1
location = /image/photo.jpg {
2
    # 规则 1：精准匹配，不符合（大小写不同）
3
}
4

5
location ^~ /image/ {
6
    # 规则 2：前缀优先，符合 /image/
7
    # 暂存这个
8
}
9

10
location ~ \.(jpg|png)$ {
11
    # 规则 3：正则匹配，符合 \.jpg$
12
    # 第一个匹配的正则，选这个！
13
}
14

15
location / {
16
    # 规则 4：通用前缀，符合但优先级最低
17
}

1
location /image/ {
2
    root /var/www;
3
    # 请求 /image/photo.jpg
4
    # 最终找的文件：/var/www + /image/ + photo.jpg = /var/www/image/photo.jpg
5
}

1
location /image/ {
2
    alias /data/images/;
3
    # 请求 /image/photo.jpg
4
    # location 部分 /image/ 被替换为 /data/images/
5
    # 最终找的文件：/data/images/ + photo.jpg = /data/images/photo.jpg
6
}

1
location /upload {
2
    root /var/www;
3
    # 文件放在 /var/www/upload/file.pdf
4
    # 请求 /upload/file.pdf，找 /var/www + /upload/file.pdf = 正确
5
}

1
location /upload {
2
    alias /var/www/uploads/;
3
    # 文件放在 /var/www/uploads/file.pdf
4
    # 请求 /upload/file.pdf，用 /var/www/uploads/ 替换 /upload，找 /var/www/uploads/file.pdf = 正确
5
}

1
location ~* \.(jpg|jpeg|png|gif|ico|css|js|svg|woff|woff2)$ {
2
    root /var/www/html;
3
    expires 30d;              # 浏览器缓存 30 天
4
    add_header Cache-Control "public, immutable";
5
    access_log off;           # 静态文件不记录日志（减少 IO）
6
}

1
location ~ /\.env$ {
2
    deny all;
3
    access_log off;
4
    error_log off;
5
}
6

7
location ~ /\.(git|svn|hg)/ {
8
    deny all;
9
}

1
location ~ \.php$ {
2
    fastcgi_pass 127.0.0.1:9000;
3
    fastcgi_index index.php;
4
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
5
    include fastcgi_params;
6
}

1
location ~ ^/api/v([0-9]+)/(.*) {
2
    set $api_version $1;
3
    set $api_path $2;
4
    proxy_pass http://api_backend_v$api_version/$api_path;
5
}

1
location / {
2
    root /var/www/html;
3
    index index.html index.htm index.php;  # 按顺序尝试
4
    try_files $uri $uri/ /index.html;      # 前端路由回源
5
}

1
server {
2
    listen 80;
3
    server_name example.com www.example.com;
4

5
    root /var/www/example.com;
6
    index index.html;
7

8
    # 前端路由回源：所有找不到的文件，都返回 index.html，让前端 JS 路由处理
9
    location / {
10
        try_files $uri $uri/ /index.html;
11
    }
12

13
    # 静态资源长期缓存
14
    location ~* \.(js|css|jpg|jpeg|png|gif|ico|svg|woff2?)$ {
15
        expires 365d;
16
        add_header Cache-Control "public, immutable";
17
    }
18

19
    # 禁止访问敏感文件
20
    location ~ /\. {
21
        deny all;
22
    }
23

24
    error_page 404 /404.html;
25
}

1
# 3 种写法，效果等同
2
expires 30d;
3
expires 30d 12h;
4
expires 2592000;  # 秒数
5

6
# expires off 表示不设置过期时间
7
# 浏览器不会缓存，每次都重新下载（用于测试环境）

1
# 在 http 块启用全局压缩
2
gzip on;
3
gzip_comp_level 6;           # 压缩级别 1-9，越高压缩率越好但 CPU 消耗越大
4
gzip_types text/plain text/css text/javascript application/json application/javascript;  # 只压缩这些类型
5
gzip_min_length 1000;        # 只压缩大于 1KB 的响应
6

7
# 在 server 块可以精细控制
8
location ~* \.(js|css)$ {
9
    gzip on;
10
    gzip_comp_level 9;
11
}

1
# Nginx 默认开启，用于浏览器判断文件是否变化
2
# 不要关闭，除非有特殊需求
3
etag on;
4

5
# 结合 If-Modified-Since，返回 304 Not Modified，减少带宽

1
add_header Access-Control-Allow-Origin "*";
2
add_header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS";
3
add_header Access-Control-Allow-Headers "Content-Type";
4

5
# 处理 OPTIONS 预检请求
6
if ($request_method = 'OPTIONS') {
7
    return 204;
8
}

1
Nginx -> TCP 连接 -> PHP-FPM 进程

1
Nginx -> Unix Socket 文件 -> PHP-FPM 进程

1
server {
2
    listen 80;
3
    server_name example.com;
4
    root /var/www/example.com;
5

6
    index index.php index.html index.htm;
7

8
    # 处理 PHP 请求
9
    location ~ \.php$ {
10
        # 转发给 PHP-FPM
11
        fastcgi_pass 127.0.0.1:9000;
12
        # 或用 Socket
13
        # fastcgi_pass unix:/var/run/php-fpm.sock;
14

15
        fastcgi_index index.php;
16

17
        # ⚠️ 关键：告诉 PHP-FPM 脚本路径
18
        # 如果缺少这行，PHP-FPM 收不到脚本路径，返回 404
19
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
20

21
        # 导入其他 fastcgi 参数
22
        include fastcgi_params;
23

24
        # 可选：提升超时时间（如果 PHP 脚本执行慢）
25
        fastcgi_connect_timeout 60;
26
        fastcgi_send_timeout 60;
27
        fastcgi_read_timeout 60;
28
    }
29

30
    # 静态文件直接返回
31
    location ~* \.(jpg|jpeg|png|css|js|gif|ico)$ {
32
        expires 7d;
33
        access_log off;
34
    }
35

36
    # 禁止访问敏感文件
37
    location ~ /\. {
38
        deny all;
39
    }
40
}

1
# Socket 方式（推荐单服务器）
2
listen = /var/run/php-fpm.sock
3
listen.owner = nginx
4
listen.group = nginx
5
listen.mode = 0660
6

7
# 或 TCP 方式（分布式）
8
# listen = 127.0.0.1:9000
9
# listen = 0.0.0.0:9000  # 允许远程连接（生产不推荐）

1
pm = dynamic                 # 动态管理进程数
2
pm.max_children = 50        # 最多 50 个进程
3
pm.start_servers = 10       # 启动时 10 个进程
4
pm.min_spare_servers = 5    # 至少保留 5 个空闲进程
5
pm.max_spare_servers = 20   # 最多保留 20 个空闲进程

1
# ✅ 好的注释
2
server {
3
    listen 80;
4
    # 主域名和 www 子域名
5
    server_name example.com www.example.com;
6

7
    # 站点根目录
8
    root /var/www/example.com;
9

10
    # 前端路由，所有找不到的文件返回 index.html
11
    location / {
12
        try_files $uri $uri/ /index.html;
13
    }
14
}
15

16
# ❌ 坏的注释
17
# config for example
18
server {
19
    listen 80;
20
    server_name example.com www.example.com;
21
    root /var/www/example.com;
22
    location / {
23
        try_files $uri $uri/ /index.html;  # important!!!
24
    }
25
}

1
# .git / .svn / .env 等
2
location ~ /\.(git|svn|env|htaccess)$ {
3
    deny all;
4
    access_log off;
5
    error_log off;
6
}
7

8
# PHP 配置文件
9
location ~ ^/wp-config\.php$ {
10
    deny all;
11
}
12

13
# 目录列表
14
autoindex off;

1
# HTTP 重定向到 HTTPS
2
server {
3
    listen 80;
4
    server_name example.com;
5
    return 301 https://example.com$request_uri;
6
}
7

8
server {
9
    listen 443 ssl http2;
10
    server_name example.com;
11

12
    ssl_certificate /etc/ssl/certs/example.com.crt;
13
    ssl_certificate_key /etc/ssl/private/example.com.key;
14

15
    # 强制使用 HTTPS
16
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
17
}