1. 概述
1.1 版本
| 报表服务器版本 | Nginx 版本 |
|---|---|
| 10.0 | 1.15.6及以上，推荐最新 |
1.2 环境准备
| 必备环境 | 必须有 gcc 和 gcc-c++ 环境，如果没有需自行安装，联网安装命令 yum install gcc gcc-c++ 检查命令： gcc -v |
|---|---|
| 安装包 | 注：nginx部分老版本存在一些安全问题，推荐使用 nginx-1.21以上版本，历史版本用户建议进行升级。 |
| 依赖包 | 必须下载 3 个依赖包，部署过程会用到 |
| 补丁包 | 必须下载，主动健康检查补丁包为重要功能 |
2. 安装过程
2.1 解压安装包
将安装包放在某个目录，例如 /usr/nginx 下，进行解压：
mkdir /usr/nginx # 创建安装目录
cd /usr/nginx # 进入目录
tar zxvf nginx-1.22.1.tar.gz # 解压 nginx
tar zxvf pcre-8.42.tar.gz # 解压 pcre
tar zxvf zlib-1.2.11.tar.gz # 解压 zlib
tar zxvf openssl-1.1.1a.tar.gz # 解压 openssl
unzip ngx_healthcheck_module-master.zip # 解压 ngx_healthcheck_module-master
2.2 安装 Nginx
注：下面第三行命令中的「/usr/nginx」路径，需要与 2.1 节安装目录相同；由于第三行内容过长，建议用户将下面命令复制到本地，确认路径后再按序执行。
cd /usr/nginx/nginx-1.22.1 # 进入解压目录
patch -p1 < /usr/nginx/ngx_healthcheck_module-master/nginx_healthcheck_for_nginx_1.14+.patch # 应用健康检查补丁
./configure --prefix=/usr/nginx --with-pcre=/usr/nginx/pcre-8.42 --with-zlib=/usr/nginx/zlib-1.2.11 --with-http_ssl_module --with-openssl=/usr/nginx/openssl-1.1.1a --with-stream --add-module=/usr/nginx/ngx_healthcheck_module-master # 指定安装路径
make && make install # 用 && 连接的两条命令，只有 make 无错误时，才会继续执行 make install 命令
3. 修改配置
要想使用 Nginx 搭配 Web 容器发挥负载均衡的作用，必须还要对 Nginx 进行配置，下面提供通用配置和自定义配置。
注：修改配置后，需要重启 Nginx 方可生效。
3.1 通用配置
1）通用配置 ：nginx-通用版.rar
修改文件内红色框框起来的节点 IP 和端口。如下图所示：
注：Websocket 转发端口：2019-11-08 之前的 JAR ，为 WebSocketConfig.requestPort ；2019-11-08 及之后的 JAR ，为 WebSocketConfig.requestPorts ；详情请参见：WebSocket 端口配置
注：工程访问路径默认为：http://ip:端口/工程名/decision，本节提供的 nginx.conf 文件中，「check_http_send "GET /webroot/decision/system/health HTTP/1.0\r\n\r\n"; 」代码中的「webroot」对应访问路径的「工程名」，用户需根据实际情况修改；若工程名为空，则去掉代码中的「/webroot」。
2）重命名为 nginx.conf，然后替换原始的 /usr/nginx/conf/nginx.conf
3.2 自定义配置
vi /usr/nginx/conf/nginx.conf # 编辑配置文件 nginx.conf
参考 nginx.conf 配置手册 中的 Nginx 配置参数说明，自行配置（修改 Nginx 端口、配置外网映射、配置 https 等）。
4. 启动Nginx
4.1 运维命令
cd /usr/nginx/sbin # 进入 sbin 目录
./nginx # 启动 nginx
./nginx -s stop # 停止 nginx
./nginx -s reload # 热加载nginx，可以理解为重启，但是用户不会感知到
更多运维操作，详情参见：集群运维手册-Linux 版
4.2 测试是否成功
在浏览器输入ip:负载均衡端口号/status查看健康页面，可以看到节点健康状态，若为 up 状态则表示正常，如下图所示：
5. FAQ 文档
5.1 缺少 patch 命令
解决方法：离线安装 patch 命令。
1）将patch源码包传至 usr 目录下：patch-2.7.6.tar.gz
2）解压并对其进行编译安装，即可使用patch命令，如下所示：
tar zxvf patch-2.7.6.tar.gz # 解压安装包
cd /usr/patch-2.7.6 # 进入到指定目录下
./configure && make && make install # 编译并安装