nginx 的安装、配置、使用

这是我参与11月更文挑战的第22天，活动详情查看：2021最后一次更文挑战

前不久，一个项目开发完成要上线，作为项目主开发的我也要负责一下部署。

项目是前后端分离的微服务架构：Spring Cloud 、Vue+ElementUI。在测试环境是直接 jar 包部署各微服务模块，前端直接是 npm run dev 启动。

部署到正式环境，前端要将 build 之后的项目放在 nginx 中启动，并配置 https，由于我之前也没有配过 nginx，所以踩了很多坑，仅写这篇博客当做笔记。

简介

Nginx是一款开源的、跨平台的高性能web服务器，它有着高性能，稳定性高，配置简单，模块结构化，资源消耗低的优点。同时支持反向代理、负载均衡、缓存的功能。其采用多进程+epoll(IO多路复用)模型，也对互联网高并发连接业务有着很好的支持。

CentOS 安装 Nginx

A. 依赖环境安装

要安装 nginx，要先安装 nginx 的依赖环境：gcc-c++、openssl、pcre、zlib

1. 安装 gcc-c++ 编译器和 openssl

yum install gcc-c++ 
yum install -y openssl openssl-devel
复制代码

2. 安装 pcre 包

yum install -y pcre pcre-devel
复制代码

3. 再安装 zlib 包

yum install -y zlib zlib-devel
复制代码

B. Nginx 安装

依赖环境安装完成后，我们开始安装 nginx

1. 在 /usr/local/ 目录下创建 nginx 文件夹

cd /usr/local
mkdir nginx
复制代码

2. 使用 wget 命令直接下载 nginx 安装包，也可以直接上传下载好的压缩包

wget https://nginx.org/download/nginx-1.14.0.tar.gz
复制代码

3. 解压并进入解压好的目录

tar -zxvf nginx-1.14.0.tar.gz 
cd nginx-1.14.0/
复制代码

4. 使用 nginx 默认配置

./configure
复制代码

5. 编译安装

make
make install
复制代码

如果没有报错，那么你的 /usr/local/nginx目录会多些除了红框之外的东西如下

此时，说明 nginx 已经安装成功，可以启动了。

6. 进入 /usr/local/nginx/sbin 目录执行启动命令

./nginx
复制代码

7. 查看是否启动成功

ps -ef | grep nginx
复制代码

网页上访问自己的 ip 地址端口为 80 ，会出现下图欢迎页，至此，nginx 安装完成。

C. 安装过程中的错误处理

上面安装过程的第 5 步可能会出现如下错误

错误一

src/os/unix/ngx_user.c:26:7: error: ‘struct crypt_data’ has no member named ‘current_salt’

这个错误一般是服务器系统版本高或者 nginx 版本高。

解决办法：

在nginx安装文件夹下输入

vim src/os/unix/ngx_user.c
复制代码

注释掉红框中的代码然后保存退出重新 make 即可。

错误二

cast between incompatible function types from ‘size_t (*)(ngx_http_script_engine_t )’ {aka ‘long unsigned int ()(struct )’} to ‘void ()(ngx_http_script_engine_t )’ {aka ‘void ()(struct *)’} [-Werror=cast-function-type]

解决办法：

打开 vim objs/Makefile 把 -Werrori删掉（-Werror，它要求GCC将所有的警告当成错误进行处理）

配置 nginx

上面启动的 nginx，我们是用默认的配置文件启动的，真实项目使用的时候，我们肯定要去修改 nginx 的默认配置的。

A. 配置解析

使用如下命令查看上文中安装的 nginx 的默认配置文件：

vim /usr/local/nginx/nginx-1.14.0/conf/nginx.conf
复制代码

这里只截取部分。下面我将列出 nginx 配置文件中的主要配置块的含义：

...              #全局块

events {         #events块
   ...
}

http      #http块
{
    ...   #http全局块
    server        #server块
    { 
        ...       #server全局块
        location [PATTERN]   #location块
        {
            ...
        }
        location [PATTERN] 
        {
            ...
        }
    }
    server
    {
      ...
    }
    ...     #http全局块
}
复制代码

1、全局块：配置影响nginx全局的指令。一般有运行nginx服务器的用户组，nginx进程pid存放路径，日志存放路径，配置文件引入，允许生成worker process数等。

2、events块：配置影响nginx服务器或与用户的网络连接。有每个进程的最大连接数，选取哪种事件驱动模型处理连接请求，是否允许同时接受多个网路连接，开启多个网络连接序列化等。

3、http块：可以嵌套多个server，配置代理，缓存，日志定义等绝大多数功能和第三方模块的配置。如文件引入，mime-type定义，日志自定义，是否使用sendfile传输文件，连接超时时间，单连接请求数等。

4、server块：配置虚拟主机的相关参数，一个http中可以有多个server。

5、location块：配置请求的路由，以及各种页面的处理情况。

我们一般主要配置的就是 http 块下的server 块。

B. 配置实战

1. 部署 npm build 之后的前端资源

将 build 出来的 dist 文件夹放在 /usr/local/nginx/html/ 路径下（也可以是其他路径，不固定）

然后，修改 nginx.config 配置文件：

    location / {
            root /usr/local/nginx/html/dist;
            index index.html index.htm;
            try_files $uri $uri/ @router; # 配置使用路由
    }

复制代码

保存修改之后，重新启动 nginx：

cd /usr/local/nginx/sbin
./nginx -s reload
复制代码

此时，前端已经部署好了，接下来我们来配置后端各个微服务的部署

2. jar 包部署各个微服务，并配置 nginx

首先，假设 jar 包也部署在这台有 nginx 服务的服务器上，我们需要先启动各个微服务

nohup java -jar xxx.jar > xxx.log & tail -f xxx.log     # 这里的命令不再解释
复制代码

然后开始修改 nginx.config 配置文件:

    location ^~ /erowplatform {
            proxy_pass https://localhost:8088/erowplatform;
    }

    location ^~ /gcgk {
            proxy_pass https://localhost:8088/gcgk;
    }

    location ^~ /auth {
            proxy_pass https://localhost:8088/auth;
    }


    location ^~ /code {
            proxy_pass https://locahost:8088/code;
    }

    location ^~ /ytb {
            proxy_pass https://localhost:8088/ytb;
    }

复制代码

接下来我们来配置 https。

3. 配置 https

假设，你已经有了要配置 https 所需要的证书，至于证书的获取方式，本文不再叙述。

针对此项目，后端用 jar 包启动，我们需要先在代码中配置 https：

将你的证书放在网关模块下的 resources 下：xxx.pfx

然后修改 bootstrap.yml 文件：

server:
  port: 8080
  ssl:
    key-store: classpath:xxx.pfx
    key-store-password: 123456
    key-store-type: PKCS12
    enabled: true #开启HTTPS
复制代码

此时访问后端接口就要使用 https 了。

接下来我们来配置 nginx.conf,

先将 nginx 使用的两个证书文件（xxx.pem、xxx.key）放在某个路径下。

修改 server 块，正确指向证书所在路径：

    ssl on;
    #ssl证书的pem文件路径
    ssl_certificate  /etc/nginx/conf.d/3997458__xxx.cn.pem;
    #ssl证书的key文件路径
    ssl_certificate_key /etc/nginx/conf.d/3997458__xxx.cn.key;

    ssl_session_timeout 5m;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
    ssl_prefer_server_ciphers on;

复制代码

然后保存修改重启 nginx。

下面贴出完整的 myconfig.conf

server {
    #监听8080端口
    listen 8080;
    #对应的域名
    server_name yyt.xxx.cn;
    ssl on;
    #ssl证书的pem文件路径
    ssl_certificate  /etc/nginx/conf.d/3997458__xxx.cn.pem;
    #ssl证书的key文件路径
    ssl_certificate_key /etc/nginx/conf.d/3997458__xxx.cn.key;

    ssl_session_timeout 5m;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
    ssl_prefer_server_ciphers on;
    client_max_body_size 500M;
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-Server $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

    location / {
            root /etc/nginx/html/dist;
            index index.html index.htm;
            try_files $uri $uri/ @router; # 配置使用路由
    }

    location ^~ /erowplatform {
     proxy_pass https://localhost:8088/erowplatform;
    }

    location ^~ /gcgk {
            proxy_pass https://localhost:8088/gcgk;
    }

    location ^~ /auth {
            proxy_pass https://localhost:8088/auth;
    }


    location ^~ /code {
            proxy_pass https://localhost:8088/code;
    }

    location ^~ /ytb {
            proxy_pass https://localhost:8088/yyt;
    }


    # 路由配置信息
    location @router {
             rewrite ^.*$ /index.html last;
    }
}

复制代码

域名是映射到服务器地址的。

为什么是 myconfig.conf 呐？

是因为我将配置文件单独放了，只需要原来的 nginx.conf 指向 myconfig.conf 即可。

        include /etc/nginx/conf.d/*.conf;
        #include /etc/nginx/sites-enabled/*;

复制代码

myconfig.conf 放在 /etc/nginx/conf.d/ 下。

至此，配置完成，文章并不完善，后续再补充。