NTYSRV 使用指南

Global.ini 文件配置

Global.ini 是 NTYSRV 配置文件之一,可放置在服务器系统根目录下用作全局设置,也可放置在指定编号服务器文件夹下用作局部设置。

下文所列配置值均为默认值。

GZIP 设置 附加响应行设置 请求日志设置 文档有效期设置


GZIP 设置

GZIP 既是一种压缩模块,又是一种数据格式。GZIP 压缩可以将指定大小的文件压缩后进行传输,模块已内嵌在 NTYSRV 服务器中,通过设置 GZIP 可以节约服务器和客户端的流量。

[General]
GzipMax=1024 ; 启动GZIP压缩的最大文件尺寸,单位 KB
GzipMin=4 ; 启动GZIP压缩的最小文件尺寸,单位 KB
GzipType="text|.js|.json|.svg" ; 允许压缩的 MIME 类型,使用“|”分隔

MIME 参见 MIME 设置GzipType 参数不支持通配符 *,可以设置三种格式:

GZIP 压缩需要占用 CPU 资源和少量内存,且对图片、音频、视频等压缩效果不明显(部分数据压缩后尺寸可能反而更大,不过当这种情况出现时,NTYSRV 会选择发送原始数据),推荐用于压缩网页等文本文件。请合理调节范围,避免占用过大造成 CPU、内存资源浪费。

GZIP 只会压缩大小介于 GzipMinGzipMax 之间的数据,且该数据类型的 MIME 已在 GzipType 中设置。此外当 GzipMax 小于 0 时,GZIP 压缩不会被启用。


附加响应行设置

附加响应行可以在响应中加入自定义的字段,例如设置 Access-Control-Allow-Origin: * 可以允许其他域名的网站获取这个网站的资源。

[Extra]
Response="" ; 内容需要遵循“响应名: 响应值”的格式,设置多行时请使用“\n”来代替换行符。

API 和 POST 请求不受此设置影响。


请求日志设置

设置此功能可以将客户端的请求记录保存到日志中。日志文件将保存在“Pool”文件夹下的相应服务器文件夹中。默认已打开。

[Log]
WriteLog=1 ; 是否启用请求日志写入功能。填 0(禁用)或 1(启用)
MaxSize=512 ; 单个日志文件的最大尺寸,超过设定值后将创建新的日志文件,单位 KB

文件名格式:Pool\服务器编号\History\日期\日期.日志序号.txt

日志格式:* Time - IP:Port (X_Forwarded_For) Method URL Version Status Host Ray [Processing Time Responding Time] [Request Size Response Size];

其中 Time 为本地时间;URL 包括了请求参数(即“?”之后的数据)。

当某要素过长时,该要素的部分数据将显示成“####”。

当记录被保存到日志中,表明服务器成功接收了客户端的请求并作出了响应(即使可能没有完成指定的请求)。

该功能不会保存请求不完整的数据,因为请求不完整的数据不会被 NTYSRV 处理。

此外,服务器在启动时还会向日志文件写入部分启动信息。


文档有效期设置

Expires 是 HTTP 响应头中常见的一部分,用于告知浏览器此文档将在何时过期失效,过期失效后浏览器应当清除此文档的缓存。当文档未过期时,浏览器可以从缓存中读取此文档来代替向服务器重新获取数据。利用此特性,可以在短期内节约服务器和客户端的流量。

[General]
Expires=15 ; 一般文件的有效时长,单位 min
IndexExpires=0 ; 索引的有效时长,单位 min

由于索引具有很强的实时性,因此不建议将 IndexExpires 改为除 0 以外的其他值。部分浏览器无法通过刷新来更新文档内嵌数据(如图片等),网站开发者需要考虑到这一点,适当设置有效时长。

API 和 POST 请求不受此设置影响。修改 API 请求的有效时长参见 GET 方法调用 DLL 动态链接库(API)

NaTyphoon© NTYSRV