Nginx 是一个免费开源且稳定高效的 Web 服务器程序,经常用来提供 HTTP 网页和静态文件等资源。但是有些人在使用 Nginx 的时候会碰到网页或是文字档用浏览器打开时出现乱码的问题,这该怎么解决呢?

如下图,在浏览器上打开文字档时,浏览器却显示了一堆乱码。

浏览器显示乱码的文字档

当遇到这个问题的时候,可以先打开浏览器自带的网页检查工具,查看服务器是否有回应 Content-Type 标头。如上图,服务器确实有回应 Content-Type 标头,内容如下:

text/plain

预设情况下,Nginx 可以辨识常见的文件扩展名,来决定 Content-Type 标头的内容。但是 Nginx 自动填写的 Content-Type 标头,只会有 Mime 类型的部份,并不会有 charset(字符集)的部份。因此只知道文档的 Mime 类型却不知道其文字使用的编码格式为何的浏览器,通常会直接使用「ISO-8859-1」这个编码格式对其解码,如果该文档本来就不是使用「ISO-8859-1」来编码的,错误解码后,浏览器就会显示出乱码啦!

为了解决这个问题,我们必须要让 Nginx 服务器告诉浏览器文档使用的编码方式,也就是要在 Content-Type 标头中加上 charset 的设置值。至于文档到底要使用什么编码方式比较好,其实也不用多想,就是用「UTF-8」,没有例外!「UTF-8」是大部份编程语言内置的字符串编码方式,它只需要用很小的空间,就可以表达出世界上大部份语言所使用的文字。

所以要如何让 Nginx 服务器能在回应纯文字文档的时候,在 Content-Type 标头中自动加上 charset 的设置值呢?

我们需要修改 Nginx 的设置档,在 http 区块或是其底下的 server 或是 location 区块中使用 Nginx 提供的 charset 命令,直接指定 Content-Type 标头的 charset 的设置值为 utf-8。

charset utf-8;

如此一来,就可以让 charset_types 命令所指定的 Mime 类型,都在 Content-Type 标头中自动加上 charset=utf-8 这个设置值。有了正确的 charset 的设置值后,浏览器就不会再出现乱码啦!

加上 charset=utf-8 后正常显示的文字档

您可能会有疑问:「charset_types 命令所指定的 Mime 类型」到底有哪些呢?Nginx 预设能够在 Content-Type 标头中使用 charset 设置值的 Mime 类型为 text/html、text/xml、text/plain、text/vnd.wap.wml、application/javascript 和 application/rss+xml,也就是说,如果文档的 Mime 类型不在上述之列,就算使用 charset 命令,也不能够在 Content-Type 标头中加上 charset 设置值。

如果需要自订能够使用 charset 设置值的 Mime 类型,我们需要自行撰写 charset_types 命令。charset_types 命令的撰写方式如下:

charset_types text/html text/xml text/plain text/vnd.wap.wml application/javascript application/rss+xml;

以上命令是 Nginx 的默认值,可以看到默认值并不包含所有的纯文字文档。所以如果我们要让 charset 设置值能够套用在所有纯文字文档上,是不是只要把上面的命令改成以下这样呢?

charset_types text/* application/javascript application/rss+xml;

以上命令看起来可行,也可以通过 Nginx 设置档的检查,但是 charset_types 命令中的「text/*」并不会真的具有「星号表示所有类型」的功能。如果使用这个命令的话,所有以 text/ 开头的 Mime 类型的文档都无法套用到 charset 设置值。

为了解决这个问题,让 Nginx 服务器真的可以在回应所有类型的纯文字文档时,在 Content-Type 标头中自动加上 charset 的设置值,我们必须使用到 map 命令和 $sent_http_content_type 变量。Nginx 的 map 命令,可以判断某值究竟是什么值,来输出另一个值到其它的变量。而 $sent_http_content_type 变量,则是保存目前要回应的 Content-Type 标头之内容。

结合之后,可以撰写出如下的 map 命令:

map $sent_http_content_type $charset {
    default '';
    ~^text/ utf-8;
    application/javascript utf-8;
    application/rss+xml utf-8;
}

以上命令,当原本 Nginx 服务器要回应的 Content-Type 标头的内容为 application/javascript、application/rss+xml 或是以 text/ 开头时,就可以让 $charset 变量的值设为 utf-8;否则的话就设为空字符串 ""(同 off)。

接着使用 charset_types 命令,将允许的 Mime 类型改为单独的星号 *,使所有的 Mime 类型都可以被 charset 命令控制。如下:

charset_types *;

然后再使用 charset 命令,套用 $charset 变量的内容给 charset 设置值。如下:

charset $charset;

如此一来,就能真正让 Nginx 服务器在回应所有类型的纯文字文档时,在 Content-Type 标头中自动加上 charset 的设置值了!