nginx 在线预览与强制下载

勤不了一点

已于 2022-06-22 17:14:07 修改

阅读量2.9k

点赞数 1

分类专栏： nginx 文章标签： nginx 运维

于 2022-06-14 17:46:21 首次发布

本文链接：https://blog.csdn.net/qq_56676115/article/details/125282976

版权

nginx 专栏收录该内容

4 篇文章 0 订阅

订阅专栏

环境如下：

nginx version: nginx/1.14.1
nginx version: nginx/1.16.1
Chrome：102.0.5005.63（正式版本） （64 位）
CentOS Linux release 7.5.1804 (Core)

将任意类型文件设置成 `在线预览` 或者 `直接下载`

以 .log 和 .txt 文件为例，nginx 默认配置下 .txt是可以在线打开，而.log 会有弹窗，也就是下载。

使用是nginx，配置实现如下：

#################default_type 方式 ##################
# 配置在线预览
location ~ .*\.log$ {
    default_type text/plain; 
    charset utf-8;
}
# 配置下载文件模式
location ~ .*\.txt$ {
    types        { }
    default_type application/octet-stream; 
}
#################add_header  方式 ##################
# 配置在线预览
location ~ .*\.log$ {
    add_header Content-Type "text/plain; 
    charset=utf-8";
}
# 配置下载文件模式
location ~ .*\.txt$ {
    types        { }
    add_header Content-Type "application/octet-stream; 
    charset=utf-8";
}
#################修改 mime.types方式##################
vi mime.types #新增如下
types {
    ···
    # 配置全局txt文件下载
    application/octet-stream        txt;

    # 配置全局log文件在线预览
    text/plain                      log;
}
# 影响nginx 全局配置，个人不太推荐。

##############Content-Disposition 方式###############
# 配置附件下载模式
location ~ .*\.txt$ {
    add_header Content-Disposition "attachment";
}

为什么浏览器访问不同的类型的文件会出现不同结果呢

简单的来说浏览器一般会根据nginx的Response Headers中返回的content-type 来识别处理渲染文件，例如常见的格式有text/html HTML文档格式、text/plain 纯文本格式。打开浏览器开发工具可以看到：

Response Headers:
  content-encoding: gzip
  content-language: zh-CN
  content-type: text/html;charset=utf-8

或者用命令的方式,可以看到 Content-Type 字段：

[root@tserver121 conf]# curl http://localhost/packer.log -I
HTTP/1.1 200 OK
Server: nginx
Content-Type: text/plain; charset=utf-8
Connection: keep-alive
······

NGINX是如何配置生效的

我们可以看nginx.conf配置文件中有一段配置：

http {
    include       mime.types;
    default_type  application/octet-stream;
    ···
｝

application/octet-stream: 大多数浏览器会将其视为二进制文件并下载

default_type 仅适用于未在mime.types文件中定义的文件扩展名

首先nginx会读取mime.types 中定义好的数据类型与文件类型关系。然后使用default_type 将mime.types 中未定义的的都设置为application/octet-stream:

官方是如何定义下载目录的

A sufficiently full mapping table is distributed with nginx in the conf/mime.types file.
To make a particular location emit the “application/octet-stream” MIME type for all requests, the following configuration can be used:

location /download/ {
    types        { }
    default_type application/octet-stream;
}

Syntax:	default_type mime-type;
Default:	
default_type text/plain;
Context:	http, server, location
Defines the default MIME type of a response. Mapping of file name extensions to MIME types can be set with the types directive.

location匹配规则不对导致配置不生效

nginx 在postread 阶段对它的配置文件解析，对location解析，是先进行前缀匹配，再进行一般匹配，一般匹配是按照最长匹配规则。

前缀匹配包含：

=	#精确匹配              匹配后不在进行匹配
^~	#                     匹配后不再进行正则匹配
~	#正则匹配   			  正则匹配是有顺序的
~*	#忽略大小写，正则匹配     正则匹配是有顺序的

如果是^~开头的匹配，则不会继续搜索正则匹配，但是会继续搜索一般匹配
普通匹配：无顺序，是按匹配长短来确定的   
正则匹配：有顺序，是从前往后匹配的