此模块是从Pandora Web Server分叉而来的。

从原始模块中清理并删除了一些内容

Pandora Web Server的静态文件模块

静态文件模块允许从目录中提供静态文件。

支持的功能

• GET和HEAD请求
• 可配置目录索引文件
• 可以配置页面在404 Not Found错误上显示，而不是标准错误页面。
• 通过If-Modified-Since、If-Unmodified-Since、If-Match、If-None匹配HTTP头部进行条件请求
• 通过Range和If-RangeHTTP头部进行字节范围请求
• 提供文件的前压缩版本（支持gzip、zlib deflate、compress、Brotli、Zstandard算法）

已知限制

• 不支持多个字节范围的请求，这将导致返回整个文件。实现此功能所需复杂性不值得这种罕见的用例。
• 目前无法在Pingora框架内支持零拷贝数据传输（即sendfile）。

压缩支持

您可以通过precompressed配置设置激活对所选压缩算法的支持，例如使用此配置

root: /var/www/html
precompressed:
- gz
- br

使用此配置，对/file.txt的请求可能会返回/file.txt.gz或/file.txt.br文件，如果目录中存在且客户端支持。如果存在多个支持的预压缩文件，则会根据客户端在Accept-Encoding HTTP头部中传达的首选项选择一个。