指令参考

charset

'charset' 指令为 NGINX 的 server 或 location 块指定字符集。 — NGINX HTTP Core

charset
httpserverlocationif in location
语法charset charset-name;
默认值none
上下文http, server, location, if in location
模块NGINX HTTP Core
参数1

说明

'charset' 指令用于在 NGINX 发送给客户端的 HTTP 头中定义应使用的字符集。它通过告诉浏览器传输数据的编码方式，在确保内容在客户端正确显示方面起着关键作用。这对于需要准确处理不同语言或符号的 Web 应用程序非常重要。 该指令接受一个参数，用于指定要使用的字符集，例如 'utf-8'、'iso-8859-1' 或 'windows-1251'。当设置该指令时，NGINX 会在响应的 'Content-Type' 头中包含 'charset'，从而将此编码传达给客户端的浏览器。这可以帮助防止与字符显示不正确相关的问题，例如乱码或意外符号。 此外，'charset' 指令可以按上下文进行配置，也就是说可以在 HTTP、server 或 location 块中设置。这允许对 Web 应用不同部分如何处理字符编码进行细粒度控制，使其在网站各部分提供的内容上更具适应性。

配置示例

http {
    charset utf-8;

    server {
        location / {
            charset iso-8859-1;
        }
    }
}
⚠

在 'location' 块内的 'if' 中设置 'charset' 可能导致意外行为。通常建议避免在 'if' 中使用 'charset'。

⚠

确保所指定的 charset 被你的内容所支持，否则浏览器仍可能误判文本编码。

相关指令

default_typeadd_header