第十六章 构建和配置 Nginx 以与 Web 网关配合使用 (Windows) - 将 NSD 与 Nginx 结合使用

第十六章 构建和配置 Nginx 以与 Web 网关配合使用 (Windows) - 将 NSD 与 Nginx 结合使用

将 NSD 与 Nginx 结合使用

必须配置 Web 服务器，以便它识别对 InterSystems 文件类型的请求，并将这些请求（以及对 InterSystems IRIS 应用程序服务的任何其他静态文件的请求）传递到 NSD 进行处理。

为此，请编辑 Web 服务器配置文件 (nginx.conf)，该文件位于 C:\nginx\conf 中

本节介绍 CSP 扩展模块提供的用于配置 Web 服务器的服务器配置指令。在位置块的上下文中发出任何这些指令都会将该指令应用于指定路径上的流量。

CSPNSD_pass hostname:portNum;

（必需。）指定 NSD 正在侦听的地址（主机名和端口）。

如果没有为特定路径指定 NSD 地址，则 NSD 默认侦听地址 127.0.0.1:7038。

CSP on; and CSP off;

启用或禁用所有请求通过 Web 网关路由到 CSP 服务器。

如果不发出适用于特定路径的 CSP 指令，则发送到该路径的任何请求都不会通过 CSP 进行路由，并且 Web 服务器不会通过 Web 网关路由发送到该路径的任何请求。

CSPFileTypes filetype1[ filetype2...];

允许通过 Web 网关将特定文件类型（文件类型 1、文件类型 2 等）的请求路由到 CSP 服务器。

例如，如果希望 Web Gateway 在（且仅当）请求 .csp 或 .cls 文件时将发送到 /demo/app 路径的请求路由，请发出以下指令块：

location /demo/app {
  CSPFileTypes csp cls;
}

发出指令 CSPFileTypes * 可以路由所有文件类型的请求。其效果与CSP on 相同。

CSPNSD_response_headers_maxsize size;

指定 HTTP 响应标头的最大大小。如果响应标头超过此大小，Web 客户端会收到错误。

默认情况下，CSP 扩展模块应用指令 CSPNSD_response_headers_maxsize 8k。

CSPNSD_connect_timeout time;

指定从 Web 客户端收到请求时连接到 NSD 的超时时间。

默认情况下，CSP 扩展模块应用指令 CSPNSD_connect_timeout 300 秒。

CSPNSD_send_timeout time;

指定单个发送操作请求（例如 POST 或 PUT）的超时时间。超时仅适用于连续的发送操作之间；一旦开始，它不适用于单个传输的完成。

默认情况下，CSP 扩展模块应用指令 CSP_send_timeout 300 秒。

CSPNSD_read_timeout time;

指定传送响应时单个读取操作（例如 GET`）的超时时间。超时仅适用于连续的读取操作之间；一旦传输开始，它就不适用于传输的完成。

默认情况下，CSP 扩展模块应用指令 CSP_read_timeout 300 秒。

示例：为特定路径上的所有流量启用 CSP 路由

将以下部分放置在相应的服务器配置块中，以将发送到 /csp 路径的所有流量路由到 Web 网关：

location /csp {
CSP On;
CSPNSD_pass localhost:7038;
}

示例：将 IRIS 文件类型的请求路由到 Web 网关

将以下部分放在相应的服务器配置块中，以便为发送到 IRIS 文件类型（.csp、.cls、.zen 和 .cxw）的 /csp 路径的请求启用 CSP 路由：

location /csp {
CSPFileTypes  csp cls zen cxw;
CSPNSD_pass localhost:7038;
}

启动和停止 Nginx 和 NSD

启动 Nginx：

C:\nginx\nginx

要停止 Nginx：

C:\nginx\nginx --s stop