1
# 以".default"为扩展名的文件是 Nginx 配置文件的配置样例文件
2
.
3
├── fastcgi.conf # 为了规范配置指令 SCRIPT_FILENAME 的用法，引入 FastCGI 变量传递配置
4
├── fastcgi.conf.default
5
├── fastcgi_params # Nginx 在配置 FastCGI 代理服务时会根据 fastcgi_params 文件的配置向 FastCGI 服务器传递变量，该配置文件现已由 fastcgi.conf 代替
6
├── fastcgi_params.default
7
├── koi-utf
8
├── koi-win
9
├── mime.types # MIME 类型映射表，Nginx 会根据服务端文件后缀名在映射关系中获取所属文件类型，将文件类型添加到 HTTP 消息头字段"Content-Type"中
10
├── mime.types.default
11
├── nginx.conf # 默认的配置入口文件
12
├── nginx.conf.default
13
├── scgi_params # Nginx 在配置 SCGI 代理服务时会根据 scgi_params 文件的配置向 SCGI 服务器传递变量
14
├── scgi_params.default
15
├── uwsgi_params # Nginx 在配置 uWSGI 代理服务时会根据 uwsgi_params 文件的配置向 uWSGI 服务器传递变量
16
├── uwsgi_params.default
17
└── win-utf
18

19
# koi-utf、koi-win、win-utf:这 3 个文件是 KOI8-R 编码转换的映射文件，因为 Nginx 的作者是俄罗斯人，在 Unicode 流行之前，KOI8-R 是使用最为广泛的俄语编码。

1
./configure \
2
--prefix=/usr/local/nginx \
3
--user=nginx \
4
--group=nginx \
5
--modules-path=/usr/local/nginx/modules \
6
--with-compat \
7
--with-file-aio \
8
--with-threads \
9
--with-http_addition_module \
10
--with-http_auth_request_module \
11
--with-http_dav_module \
12
--with-http_flv_module \
13
--with-http_gunzip_module \
14
--with-http_gzip_static_module \
15
--with-http_mp4_module \
16
--with-http_random_index_module \
17
--with-http_realip_module \
18
--with-http_secure_link_module \
19
--with-http_slice_module \
20
--with-http_ssl_module \
21
--with-http_stub_status_module \
22
--with-http_sub_module \
23
--with-http_v2_module \
24
--with-stream \
25
--with-stream_realip_module \
26
--with-stream_ssl_module \
27
--with-stream_ssl_preread_module \
28
--with-cc-opt='-O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector-strong --param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic -fPIC' \
29
--with-ld-opt='-Wl,-z,relro -Wl,-z,now -Wl,--as-needed -pie'

1
# 全局配置块：对应编译--user=nginx --group=nginx，适配--with-threads/--with-file-aio
2
user  nginx nginx;        # 匹配编译的运行用户/组，替代默认nobody，安全必备
3
worker_processes  auto;   # 自动匹配CPU核心数，充分利用多核，配合线程池更高效
4
error_log  logs/error.log  warn; # 错误日志，warn级别兼顾排查和日志量
5
pid        logs/nginx.pid; # 开启PID文件，用于Nginx进程管理（重启/重载/停止）
6
worker_rlimit_nofile 65535; # 提升文件描述符限制，配合高并发连接数调优
7

8
# Events事件块：网络连接配置，适配--with-threads/--with-file-aio编译参数
9
events {
10
    use epoll;            # Linux专属高并发事件模型，Nginx默认最优选择
11
    worker_connections  10240; # 单进程最大并发连接数，从默认1024调优
12
    multi_accept on;      # 一次性接收所有新连接，提升并发处理效率
13
    accept_mutex on;      # 开启互斥锁，防止多进程惊群效应，减少CPU消耗
14
}
15

16
# HTTP核心块：启用所有编译的HTTP模块，适配Nginx 1.28.2语法
17
http {
18
    include       mime.types;        # 引入MIME类型映射，让浏览器正确解析文件
19
    default_type  application/octet-stream; # 未知后缀文件默认以二进制流下载
20
    charset utf-8;                   # 全局默认UTF-8字符集，解决中文乱码，生产必备
21

22
    # 自定义访问日志格式：适配--with-http_realip_module，记录客户端真实IP
23
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
24
                      '$status $body_bytes_sent "$http_referer" '
25
                      '"$http_user_agent" "$http_x_forwarded_for" "$realip_remote_addr"';
26
    access_log  logs/access.log  main; # 开启访问日志，使用上面的main格式
27

28
    # 高性能核心配置：适配--with-file-aio/--with-threads编译参数
29
    sendfile        on;   # 开启零拷贝技术，大幅提升静态文件传输性能（file-aio核心）
30
    tcp_nopush      on;   # 配合sendfile，填满缓冲区再发送，减少TCP包数量
31
    tcp_nodelay     on;   # 长连接关闭Nagle算法，提升动态请求实时性
32
    keepalive_timeout  60; # 长连接超时时间，比默认65更适中，减少连接占用
33
    keepalive_requests 100; # 单个长连接最大处理请求数，从默认10调优，减少握手开销
34

35
    # 客户端请求限制：生产必备，防止大文件/大请求压垮服务
36
    client_max_body_size 100M; # 客户端最大上传文件大小，可根据业务修改
37
    client_header_buffer_size 1k; # 客户端请求头缓冲区大小
38
    client_body_buffer_size 16k; # 客户端请求体缓冲区大小
39

40
    # 压缩配置：适配--with-http_gzip_static/--with-http_gunzip_module编译参数
41
    gzip  on;             # 开启实时gzip压缩，压缩文本类文件
42
    gzip_static on;       # 优先返回预压缩的.gz文件，比实时压缩更省CPU（核心）
43
    gzip_min_length 1k;   # 小于1k的文件不压缩，无性能收益
44
    gzip_buffers 4 16k;   # 压缩缓冲区大小，按需分配内存
45
    gzip_http_version 1.1;# 仅对HTTP1.1+开启压缩，兼容主流客户端
46
    # 需压缩的文件类型，仅压缩文本类，图片/视频已压缩无需处理
47
    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
48
    gzip_vary on;         # 带Vary头，兼容CDN/缓存服务器，避免缓存混乱
49

50
    # 真实IP配置：适配--with-http_realip_module编译参数（反向代理/CDN场景必备）
51
    set_real_ip_from 127.0.0.1;     # 本地代理IP，测试环境留用
52
    set_real_ip_from 192.168.0.0/16; # 内网代理/CDN IP段，按需添加/删除
53
    set_real_ip_from 10.0.0.0/8;    # 内网IP段，按需添加/删除
54
    real_ip_header X-Forwarded-For; # 从X-Forwarded-For头解析真实IP
55
    real_ip_recursive on;            # 递归解析，跳过指定的代理IP段，获取真实客户端IP
56

57
    # 80端口主虚拟主机：适配Nginx 1.28.2 HTTP/2明文写法（h2c），无SSL纯HTTP
58
    server {
59
        # Nginx 1.28.2明文HTTP/2写法：http2 cleartext（替代旧的http2），不想用HTTP/2可直接写listen 80;
60
        listen       80 ;
61
        server_name  localhost; # 替换为你的服务器IP/域名，比如192.168.1.100/xxx.com
62

63
        # 网站根目录和默认索引文件，可根据自己的业务修改路径
64
        root   html;
65
        index  index.html index.htm index.php; # 增加PHP索引，兼容动态站点，无需可删除
66

67
        # Nginx状态监控：适配--with-http_stub_status_module编译参数（运维必备）
68
        location /nginx_status {
69
            stub_status on;           # 开启监控接口，展示连接数/请求数等核心指标
70
            allow 127.0.0.1;          # 仅允许本地访问，安全
71
            allow 192.168.0.0/16;     # 允许内网IP段访问，按需添加/删除
72
            deny all;                 # 拒绝所有外网未授权访问
73
        }
74

75
        # 根路径请求处理：适配前端单页应用（Vue/React），刷新页面不404
76
        location / {
77
            try_files $uri $uri/ /index.html; # 先匹配文件/目录，无则返回index.html
78
        }
79

80
        # 错误页面配置：扩展404/5xx，保留Nginx默认的错误页文件
81
        error_page   404  /404.html;
82
        error_page   500 502 503 504  /50x.html;
83
        location = /404.html {
84
            root   html;
85
        }
86
        location = /50x.html {
87
            root   html;
88
        }
89

90
        # 安全配置：禁止访问隐藏文件（.htaccess/.env/.git等），防止敏感配置泄露
91
        location ~ /\. {
92
            deny  all;
93
            access_log off; # 不记录该类请求日志
94
            log_not_found off; # 不记录文件未找到日志
95
        }
96

97
        # PHP解析配置：适配FastCGI（Nginx+PHP-FPM），按需开启（删除#即可）
98
        # location ~ \.php$ {
99
        #     root           html;
100
        #     fastcgi_pass   127.0.0.1:9000; # PHP-FPM默认监听端口
101
        #     fastcgi_index  index.php;
102
        #     # 正确的PHP脚本路径，替换默认的/scripts，生产必备
103
        #     fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
104
        #     include        fastcgi_params; # 引入FastCGI默认参数
105
        # }
106
    }
107

108
    # Stream四层代理配置：适配--with-stream/--with-stream_realip等编译参数
109
    # 无需代理MySQL/Redis/TCP服务则保持注释，需要时删除#并修改配置
110
    # stream {
111
    #     # 四层代理真实IP配置，按需开启
112
    #     # set_real_ip_from 192.168.0.0/16;
113
    #     # real_ip_header X-Forwarded-For;
114
    #
115
    #     # 示例：代理MySQL 3306端口
116
    #     # server {
117
    #     #     listen 3306;
118
    #     #     proxy_pass 192.168.1.100:3306; # 后端MySQL真实IP:端口
119
    #     #     proxy_connect_timeout 5s;
120
    #     #     proxy_timeout 30s;
121
    #     # }
122
    #
123
    #     # 示例：代理Redis 6379端口
124
    #     # server {
125
    #     #     listen 6379;
126
    #     #     proxy_pass 192.168.1.101:6379; # 后端Redis真实IP:端口
127
    #     # }
128
    # }
129
}

1
# 进入安装目录nginx后
2
cd ./sbin/
3
./nginx -t  # 检查配置文件是否正确
4
./nginx    # 启动nginx
5
./nginx -s quit    # 正常关闭nginx
6
./nginx -s stop    # 快速关闭nginx
7
./nginx -s reload  # 重载nginx
8
./nginx -s reopen  # 重新打开日志文件
9
./nginx -V      #查看版本信息及编译参数
10

11
nginx -p /usr/local/newnginx            # 指定Nginx的执行目录，默认为 configure 时的安装目录
12
nginx -c /etc/nginx/nginx.conf          # 指定nginx.conf文件的位置，默认为 conf/nginx.conf
13

14
# 启动后查看进程
15
ps -ef | grep nginx