第二十章 构建和配置 Nginx (UNIX® Linux macOS)

本页介绍如何构建和配置 Nginx Web 服务器，以便与 UNIX®、Linux 或 macOS 上的 InterSystems Web Gateway 一起使用。 （在这些操作系统上，另一个选项是 Apache；Windows 上的选项有所不同。）

Nginx 是一个开源产品，源代码可以免费下载：http://nginx.org/

一些预构建的工具包可用于 Linux，通常是最新 Nginx 版本之后的一些版本。然而，由于扩展必须编译到 Nginx 核心中，因此有必要从源代码本地构建 Web 服务器，以包含对 CSP 的支持。

完成本页面中的步骤后，可以使用 Web Gateway 管理页面进一步配置 Web Gateway。

Assumptions

此页面假设：

• CSP/Web Gateway Web 服务器组件安装在 /opt/webgateway/bin/ 中
• IRIS（如果本地安装）位于 /opt/iris/
• Web服务器安装在/opt/nginx/下

如果系统上的布局不同，请根据需要修改配置指令。

安装

Web网关组件和CSP静态文件的安装方法如下:

1. Web网关网络服务守护进程

• CSPnsd

这个二进制文件的默认位置是/opt/webgateway/bin/

2. HyperEvents组件

• CSPBroker.js

• CSPxmlhttp.js

这些文件的默认位置是/opt/iris/csp/broker

如果这些文件是作为静态组件直接由web服务器，复制到/opt/nginx/html/csp/broker

3. 管理门户使用的各种静态资源

管理门户需要许多静态web资源(如图像文件)。默认位置为“/opt/iris/csp/sys”

如果这些文件要作为静态组件直接由web服务器提供，请将它们复制到/opt/nginx/html/csp/sys

为CSP构建Nginx Web服务器

大多数Web网关功能是由NSD (CSPnsd)提供的。对于CSP访问，Nginx可以构建和配置为通过一个小的编译模块ngx_http_csp_module.c与NSD通信。为方便起见，所有Web网关安装都包含此源文件。

这里给出的构建说明是基于在UNIX®系统下构建Nginx的官方文档:

http://nginx.org/en/docs/configure.html

Nginx文档规定还需要以下第三方附加组件:

• PCRE

http://www.pcre.org/

• OpenSSL (for SSL/TLS)

https://www.openssl.org/

• Zlib

http://zlib.net/

但是，如果最终安装不需要这些组件提供的功能，则可以在没有这些组件的情况下创建功能齐全的服务器。

构建Nginx的典型配置脚本，包括上面列出的所有可选模块，如下所示:

./configure --prefix=/opt/nginx --with-http_ssl_module

这将导致默认的Nginx版本安装在:/opt/ Nginx下

可以修改构建过程以排除可选模块:

• OpenSSL -移除SSL/TLS功能:移除指令:——with-http_ssl_module
• Zlib -移除GZIP功能:添加指令:——with_http_gzip_module
• PCRE -移除HTTP重写功能:添加指令:——with_http_rewrite_module