指令参考

types

NGINX 中的 'types' 指令根据文件扩展名定义 MIME 类型。 — NGINX HTTP Core

types
httpserverlocation
语法types { extension mime-type; ... };
默认值none
上下文http, server, location
模块NGINX HTTP Core
参数none

说明

NGINX 中的 `types` 指令用于根据文件扩展名定义分配给由 web 服务器提供的文件的 MIME 类型。该指令可以在 `http`、`server` 或 `location` 上下文中指定，从而可对不同类型的文件如何被处理进行细粒度控制。`types` 指令中的每一项由文件扩展名和随后对应的 MIME 类型组成，允许服务器向客户端准确传达文件的内容类型。 当对某个文件发出请求时，NGINX 会将请求文件的扩展名与 `types` 指令中提供的定义进行匹配。如果匹配成功，NGINX 将在响应中包含相应的 `Content-Type` 头。这样就能确保浏览器或任何接收该文件的客户端能够正确解释它。例如，`.css` 文件通常具有 MIME 类型 `text/css`，而 `.html` 文件通常以 MIME 类型 `text/html` 提供。 需要注意的是，`types` 指令可以在 `server` 或 `location` 上下文级别被覆盖，从而允许在配置的不同部分设置特定行为。NGINX 附带了在 `mime.types` 文件中指定的一组默认 MIME 类型，这些类型也可以通过 `include` 语句包含进来，从而提供更广泛的常用 MIME 类型集合，而无需手动逐一定义。

配置示例

types {
    text/html html;
    text/css css;
    application/javascript js;
    image/png png;
    image/jpeg jpeg jpg;
};
⚠

确保 MIME types 正确定义；类型不正确可能导致客户端对文件处理不当。

⚠

在更具体的上下文（server 或 location）中定义的 MIME types 会覆盖在更一般的上下文（http）中定义的那些。

⚠

始终检查文件扩展名或 MIME type 定义中的拼写错误，以避免内容分发问题。

相关指令

includedefault_type