Nginx 配置详解

240 阅读5分钟

一、Nginx配置介绍

Nginx是一个高性能的‌HTTP和反向代理服务器,以其轻量级、高并发能力而闻名。它的配置文件通常位于 /etc/nginx/nginx.conf,但具体位置可能会因安装方式和操作系统而异。Nginx的配置文件主要由以下几个部分组成:

  1. 全局块:配置影响Nginx全局的指令,如运行Nginx服务器的用户组、Nginx进程PID存放路径、日志存放路径、配置文件引入、允许生成的worker process数等。
  2. events块:配置影响Nginx服务器或与用户的网络连接,包括每个进程的最大连接数、选取哪种事件驱动模型处理连接请求、是否允许同时接受多个网络连接等。
  3. http块:可以嵌套多个server,配置代理、缓存、日志定义等绝大多数功能和第三方模块的配置,如文件引入、MIME类型定义、日志自定义、是否使用sendfile传输文件、连接超时时间等。
  4. server块:配置虚拟主机的相关参数,一个http中可以有多个server块,用于定义不同的虚拟主机或网站。
  5. location块:配置请求的路由,以及各种页面的处理情况,如静态文件、动态页面处理等。

‌Nginx相关地址

源码:trac.nginx.org/nginx/brows…

官网:www.nginx.org/

如果你下载好啦,你的安装文件,不妨打开conf文件夹的nginx.conf文件,Nginx服务器的基础配置,默认的配置也存放在此。

在 nginx.conf 的注释符号为: #

默认的 nginx 配置文件 nginx.conf 内容如下:

#user  nobody;
worker_processes  1;

#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#pid        logs/nginx.pid;

events {
    worker_connections  1024;
}

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;
    #tcp_nopush     on;

    #keepalive_timeout  0;
    keepalive_timeout  65;

    #gzip  on;

    server {
        listen       80;
        server_name  localhost;

        #charset koi8-r;

        #access_log  logs/host.access.log  main;

        location / {
            root   html;
            index  index.html index.htm;
        }

        #error_page  404              /404.html;

        # redirect server error pages to the static page /50x.html
        #
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }

        # proxy the PHP scripts to Apache listening on 127.0.0.1:80
        #
        #location ~ \.php$ {
        #    proxy_pass   http://127.0.0.1;
        #}

        # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
        #
        #location ~ \.php$ {
        #    root           html;
        #    fastcgi_pass   127.0.0.1:9000;
        #    fastcgi_index  index.php;
        #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
        #    include        fastcgi_params;
        #}

        # deny access to .htaccess files, if Apache's document root
        # concurs with nginx's one
        #
        #location ~ /\.ht {
        #    deny  all;
        #}
    }


    # another virtual host using mix of IP-, name-, and port-based configuration
    #
    #server {
    #    listen       8000;
    #    listen       somename:8080;
    #    server_name  somename  alias  another.alias;

    #    location / {
    #        root   html;
    #        index  index.html index.htm;
    #    }
    #}


    # HTTPS server
    #
    #server {
    #    listen       443 ssl;
    #    server_name  localhost;

    #    ssl_certificate      cert.pem;
    #    ssl_certificate_key  cert.key;

    #    ssl_session_cache    shared:SSL:1m;
    #    ssl_session_timeout  5m;

    #    ssl_ciphers  HIGH:!aNULL:!MD5;
    #    ssl_prefer_server_ciphers  on;

    #    location / {
    #        root   html;
    #        index  index.html index.htm;
    #    }
    #}

}

nginx 文件结构


...              #全局块

events {         #events块
   ...
}

http      #http块
{
    ...   #http全局块
    server        #server块
    { 
        ...       #server全局块
        location [PATTERN]   #location块
        {
            ...
        }
        location [PATTERN] 
        {
            ...
        }
    }
    server
    {
      ...
    }
    ...     #http全局块
}

下面给大家上一个配置文件,作为理解。

########### 每个指令必须有分号结束。#################
#user administrator administrators;  #配置用户或者组,默认为nobody nobody。
#worker_processes 2;  #允许生成的进程数,默认为1
#pid /nginx/pid/nginx.pid;   #指定nginx进程运行文件存放地址
error_log log/error.log debug;  #制定日志路径,级别。这个设置可以放入全局块,http块,server块,级别以此为:debug|info|notice|warn|error|crit|alert|emerg
events {
    accept_mutex on;   #设置网路连接序列化,防止惊群现象发生,默认为on
    multi_accept on;  #设置一个进程是否同时接受多个网络连接,默认为off
    #use epoll;      #事件驱动模型select|poll|kqueue|epoll|resig|/dev/poll|eventport
    worker_connections  1024;    #最大连接数,默认为512
}
http {
    include       mime.types;   #文件扩展名与文件类型映射表
    default_type  application/octet-stream; #默认文件类型,默认为text/plain
    #access_log off; #取消服务日志    
    log_format myFormat '$remote_addr–$remote_user [$time_local] $request $status $body_bytes_sent $http_referer $http_user_agent $http_x_forwarded_for'; #自定义格式
    access_log log/access.log myFormat;  #combined为日志格式的默认值
    sendfile on;   #允许sendfile方式传输文件,默认为off,可以在http块,server块,location块。
    sendfile_max_chunk 100k;  #每个进程每次调用传输数量不能大于设定的值,默认为0,即不设上限。
    keepalive_timeout 65;  #连接超时时间,默认为75s,可以在http,server,location块。

    upstream mysvr {   
      server 127.0.0.1:7878;
      server 192.168.10.121:3333 backup;  #热备
    }
    error_page 404 https://www.baidu.com; #错误页
    server {
        keepalive_requests 120; #单连接请求上限次数。
        listen       4545;   #监听端口
        server_name  127.0.0.1;   #监听地址       
        location  ~*^.+$ {       #请求的url过滤,正则匹配,~为区分大小写,~*为不区分大小写。
           #root path;  #根目录
           #index vv.txt;  #设置默认页
           proxy_pass  http://mysvr;  #请求转向mysvr 定义的服务器列表
           deny 127.0.0.1;  #拒绝的ip
           allow 172.18.5.54; #允许的ip           
        } 
    }
}

二、Nginx部署前端项目

要在Nginx上部署前端项目,你需要将前端项目的静态文件复制到Nginx的网站目录下,并配置Nginx来服务这些静态文件。以下是一个基本的步骤和示例配置:

  1. 将前端项目构建生成的静态文件(通常是index.html, 一些.js和.css文件,以及图片等资源)复制到Nginx的网站目录下,例如/usr/share/nginx/html
  2. 编辑Nginx配置文件,通常是/etc/nginx/nginx.conf或者/etc/nginx/conf.d/default.conf,或者在/etc/nginx/sites-available/目录下创建一个新的配置文件,然后使用ln -s链接到/etc/nginx/sites-enabled/。
  3. 在Nginx配置文件中,设置一个server块来处理静态文件的请求。
// 以下是一个基本的Nginx配置示例,用于部署一个前端项目:
server {
    listen 80; # 或者其他你想要监听的端口
    server_name example.com; # 你的域名或公网IP
    location / {
        root /path/to/your/frontend/project; # 前端项目的绝对路径
        index index.html;
        try_files $uri $uri/ /index.html; # 用于支持前端路由的HTML5 History模式
    }
    # 如果需要处理API或其他后端服务,可以添加一个location块
    # location /api {
    #     proxy_pass http://backend_server; # 代理到后端API服务器
    # }
}

在这个配置中:

  • listen 指定了Nginx监听的端口。
  • server_name 是你的域名或IP地址。
  • location / 块定义了对于根URL的请求应如何处理。
  • root 指定了前端项目文件所在的文件系统路径。
  • index 指定了默认页面。
  • try_files 指令用于检查文件是否存在于文件系统中,如果不存在则回退到/index.html,这对于单页应用(SPA)的路由很重要,因为它可以确保前端的路由工作。

确保替换/path/to/your/frontend/project为你的实际前端项目路径,并且确保Nginx用户有权限访问这个目录。

完成配置后,你需要重启或重新加载Nginx使配置生效:

sudo nginx -s reload 或者 sudo systemctl reload nginx

确保你的前端项目构建输出(通常是dist或build文件夹)包含了所有必要的静态文件,并且这些文件的权限允许Nginx用户访问。