Nginx如何配置文件下载服务?目录访问、权限控制与传输优化

把一批安装包、固件、报表放在服务器上供人下载,是很多企业内网和个人站点的刚需。用 Nginx 做文件下载服务,比搭 FTP 省心得多:它是无状态的 HTTP 服务、天然穿透大多数防火墙和代理、能和现有域名和 HTTPS 复用,前端还能直接给下载链接。但"能下载"和"下载得好、下载得安全"是两回事——目录被随便遍历、大文件传一半断掉、几个人同时下载就把带宽打满,都是常见问题。

这篇文章从零讲清楚怎么用 Nginx 搭一个可用的文件下载服务:目录访问怎么开、目录列表要不要暴露、怎么用 auth_basic 或限速做权限控制、大文件传输怎么优化到又快又稳,以及如何限制带宽和并发避免被拖垮。文中涉及的带宽、连接数、缓冲区数值都是常见经验值,需要结合你的实际带宽和磁盘性能调整。

读完之后,你应该能配置出一个既方便内部同事下载、又不会被外部爬走或拖垮的服务,并且知道出问题时该看哪一项配置、哪一条日志。

一、最简单的下载服务:静态目录

Nginx 默认就能把某个目录当文件服务器用,只要用 root 或 alias 把它暴露出去:

server {
    listen 80;
    server_name dl.example.com;

    location /files/ {
        alias /data/files/;     # 注意 alias 结尾的斜杠要和对齐
    }
}

这里要区分 root 和 alias 两个指令,它们最容易配错:

指令 含义 示例(请求 /files/a.zip)
root /data; 在 root 后面拼接完整 URI 实际查找 /data/files/a.zip
alias /data/files/; 用 alias 路径替换 location 前缀 实际查找 /data/files/a.zip

最容易踩的坑:alias 后面要不要带斜杠、location 要不要带斜杠,必须成对匹配。location /files/ 配 alias /data/files/,如果写成 alias /data/files(少一个斜杠),就变成 /data/filesa.zip 这种奇怪路径,直接 404。所以配完一定用真实 URL 测一遍。

# 语法校验(改完必做)
sudo nginx -t
# 平滑重载
sudo nginx -s reload
# 冒烟测试:确认能下到文件
curl -I http://dl.example.com/files/a.zip

二、目录列表:开还是不开

默认情况下,访问一个没有 index.html 的目录会返回 403。如果想让用户能浏览目录、自助找文件,就打开 autoindex:

location /files/ {
    alias /data/files/;
    autoindex on;                 # 打开目录列表
    autoindex_exact_size off;     # 显示 K/M/G 而非精确字节,更易读
    autoindex_localtime on;       # 时间显示本地时区
    charset utf-8;                # 中文文件名不乱码
}

server {
    charset utf-8;                # 建议在 server 级别统一设置
}

autoindex 很方便,但安全上要慎重:一旦打开,任何人只要猜到目录名就能列出全部文件,相当于把家底亮给对手。经验做法是:

  • 对外服务、含敏感文件的目录:保持 autoindex off(默认),只通过明确链接下载。
  • 内网、文件命名本身不敏感的公开资源目录:可以开,但配合访问控制。
  • 敏感目录单独 location,显式关掉并加认证。
# 敏感目录:关闭列表 + 需要登录
location /files/private/ {
    alias /data/private/;
    autoindex off;
    auth_basic "Restricted";
    auth_basic_user_file /etc/nginx/.htpasswd;
}

三、权限控制:几种常用手段

下载服务的权限控制,从粗到细有几种做法,按场景选:

方式 配置要点 适用场景
基础认证 auth_basic + .htpasswd 内网小范围、临时分享
IP 白名单 allow / deny 只允许公司出口/固定 IP
限时令牌 secure_link 模块 下载链接带签名和过期时间
目录隔离 拆分 location + 权限 不同用户看不同目录

基础认证最省事,用 htpasswd 生成账号文件(RHEL 系由 httpd-tools 提供,Debian 系由 apache2-utils 提供):

# RHEL / CentOS / Rocky
sudo dnf install -y httpd-tools
# Debian / Ubuntu
sudo apt install -y apache2-utils

# 首次创建(-c 会覆盖,只在第一次用)
sudo htpasswd -c /etc/nginx/.htpasswd alice
# 追加用户(不要加 -c)
sudo htpasswd /etc/nginx/.htpasswd bob

# 保护文件本身
sudo chmod 640 /etc/nginx/.htpasswd
sudo chown root:nginx /etc/nginx/.htpasswd

IP 白名单适合固定出口场景,规则自上而下匹配,先匹配到的生效:

location /files/ {
    alias /data/files/;
    allow 10.0.0.0/8;
    allow 203.0.113.0/24;    # 公司固定出口(示例网段)
    deny all;
}

限时签名链接(secure_link)适合对外分发、链接会外流又希望过期即失效的场景。它的原理是服务端用密钥对"文件路径+过期时间"做签名,客户端只有拿着合法签名才能下:

location /files/ {
    secure_link $arg_md5,$arg_expires;
    secure_link_md5 "$secure_link_expires$uri secret_key_here";

    if ($secure_link = "")  { return 403; }   # 签名缺失或不匹配
    if ($secure_link = "0") { return 410; }   # 链接过期

    alias /data/files/;
}

风险提示:secure_link 的密钥(上面的 secret_key_here)一旦泄露就能伪造链接,务必用足够长的随机串并妥善保管,不要提交到代码仓库。改配置后同样要 nginx -t 校验再 reload,并预留旧配置备份以便回滚。

生产环境里,这几种手段往往组合使用:对外链接用签名链接保证"链接外流也会过期",同时叠加单 IP 限速和并发限制防止被批量拖库;对内则用基础认证或 IP 白名单,简单直接。需要提醒的是,基础认证走的是明文 Base64(HTTP 下可被中间人还原),所以只要涉及账号密码,就必须在 HTTPS 之上使用,否则等同于把口令挂在网上。做完访问控制,建议用一台"非白名单"的机器从外网实测一遍,确认不该看到的人确实进不来,这比只看配置更让人放心。

四、传输优化:让大文件又快又稳

下载服务好不好用,很大程度看大文件传输表现。下面几项是重点。

第一,sendfile 与零拷贝。 开启后文件数据在内核态直接从磁盘到网卡,减少用户态拷贝,大文件传输效率明显提升:

sendfile on;              # 零拷贝,强烈建议开启
tcp_nopush on;            # 配合 sendfile,先攒满一个包再发,减少小包
tcp_nodelay on;           # 降低小数据包的延迟(与 tcp_nopush 分开使用场景)

tcp_nopush 和 tcp_nodelay 看起来矛盾,其实分工不同:tcp_nopush 让数据攒够一起发、提高大文件吞吐;tcp_nodelay 让响应尽快发、降低延迟。现代内核下一般两个都开,按实际压测观察。

第二,output_buffers 与 sendfile_max_chunk。 传输超大文件时,可以通过限制单次读写块大小来避免某个连接独占 worker:

sendfile_max_chunk 512k;   # 单次 sendfile 最多 512k,避免大文件饿死其他连接

第三,open_file_cache 缓存文件句柄。 文件多、访问频繁时能减少磁盘元数据操作:

open_file_cache max=10000 inactive=60s;
open_file_cache_valid 90s;
open_file_cache_min_uses 2;
open_file_cache_errors on;

第四,连接超时。 大文件下载耗时长,超时设太短会被掐断:

send_timeout 60s;              # 两次写操作之间的超时
client_body_timeout 60s;       # 读取请求体超时
keepalive_timeout 65s;         # 长连接保持时间

经验上,普通站点 keepalive_timeout 设 60~75s 比较合适;下载站可以适当加大,但也不要过长,否则空闲连接占用资源。上面的数值都是经验值,请结合带宽和业务测试校准。

第五,断点续传。 大文件下载最怕"传到 90% 断了要从头再来"。HTTP 的 Range 请求让客户端可以从指定偏移继续下载,Nginx 处理静态文件时天然支持 Range,这也是它比自写下载脚本更省事的地方。你不需要额外配置就能让浏览器和下载工具(如 curl -C -、wget -c)续传,但要确保中间的反向代理或 CDN 也传透了 Range 头,否则续传会在代理层被破坏。遇到"续传后文件损坏"的怪现象,优先怀疑中间层是否吞掉了 Range 或改写了响应。

# 验证服务端是否支持断点续传:应返回 206 Partial Content
curl -r 0-1023 -I http://dl.example.com/files/big.iso
# 输出里出现 HTTP/1.1 206 与 Content-Range 才说明支持

五、限速与限并发:别让一个下载拖垮全站

下载最怕"一个人把带宽吃光"。Nginx 可以用 limit_rate 限制单连接速度、用 limit_conn 限制单 IP 并发、用 limit_rate_after 控制"先快后慢":

# http 块:定义单 IP 并发连接区
limit_conn_zone $binary_remote_addr zone=dl_perip:10m;

server {
    location /files/ {
        alias /data/files/;

        limit_rate 1m;              # 单连接限速 1MB/s(经验值,按带宽调整)
        limit_rate_after 10m;       # 前 10MB 不限速,之后才限速
        limit_conn dl_perip 3;      # 单 IP 最多 3 个并发下载
        limit_conn_status 429;
    }
}

limit_rate_after 10m 是个很实用的技巧:视频、大安装包往往前几兆是"试探",先全速让用户看到进度,超过阈值再限速,体验和资源占用能兼顾。单位说明:limit_rate 的单位是字节/秒,1m 即约 1MB/s;limit_rate_after 也是字节,注意 m 和 M 的写法,建议统一用 k/m。

整体带宽够但担心旁路占满,也可以在更上层做全站限速,但要谨慎,别把正常业务也限了。改这类配置前先评估峰值:如果站点带宽 100Mbps(约 12.5MB/s),单连接限 1MB/s、并发 3 个,单 IP 最多占 3MB/s,大约允许 4 个这样的人同时满速下载,其余人分享剩余带宽,是否合理要按业务定。

限速的另一个思路是"按文件大小分级"。小文件(几百 KB 的配置、脚本)本来瞬间就下完,限速反而增加失败率,可以放在一个不限速的 location;大文件(几百 MB 以上的镜像、安装包)才走限速规则。把不同体量的资源放在不同 URL 前缀下,用两个 location 分别配置,比给所有文件套一套参数更务实。除此之外,还要注意磁盘读取能力:如果多个大文件同时下载,磁盘 IO 也可能成为瓶颈,用 iostat -x 1 观察 %util 接近 100% 时,说明瓶颈在磁盘而不是带宽,此时加限速反而更必要。

六、日志、防盗链与常见故障

防盗链:如果文件被别的站点直接引用(盗链),会被白白消耗带宽。用 valid_referers 挡住:

location /files/ {
    valid_referers none blocked server_names *.example.com;
    if ($invalid_referer) { return 403; }
    alias /data/files/;
}

注意 none blocked 是允许"无 Referer"和"被防火墙改写过的 Referer",否则用户用浏览器直接粘链接打开可能会被误伤。

下载 404 排查:优先确认 root/alias 拼接出来的真实路径到底对不对。

# 看 nginx 认为应该找哪个文件
sudo tail -f /var/log/nginx/error.log
# 典型报错:open() "/data/files/a.zip" failed (2: No such file or directory)
# 直接到服务器上验证路径是否存在、权限是否可读
sudo -u nginx ls -l /data/files/a.zip

Nginx 的 worker 进程用户(RHEL 系常为 nginx,Debian 系为 www-data)必须对文件有读权限,且父目录有执行(x)权限,否则返回 403。

中文文件名乱码:在 server 或 location 设 charset utf-8;,并确保文件系统按 UTF-8 存储文件名。

常见问题

Q1:配置了 alias 却一直 404?
九成是 location 与 alias 的结尾斜杠没对齐,或者直接用了 root 语义。用 curl -I 加 error.log 里 open() 的真实路径对照,一看便知。

Q2:打开 autoindex 后担心目录被爬,怎么办?
对外目录保持 autoindex off,只给明确链接;需要列目录的内网目录加 auth_basic 或 IP 白名单。也可以在 robots.txt 里禁止抓取,但这只能防君子,不能替代访问控制。

Q3:大文件下载到一半中断是什么原因?
多半是超时太短或限速/并发过严。检查 send_timeout、limit_rate、limit_conn,以及前面的负载均衡或 CDN 是否设了更短超时。

Q4:怎么限制单用户下载速度又不影响小文件体验?
用 limit_rate_after 先全速跑前几兆,之后再用 limit_rate 限速,两全其美。

Q5:下载服务要不要上 HTTPS?
对外、含账号或签名链接的强烈建议 HTTPS。签名链接在明文 HTTP 下会被中间人看到并盗用,HTTPS 能显著降低这个风险。

总结

  • Nginx 做下载服务,核心是 alias/root 路径正确;alias 与 location 的结尾斜杠必须对齐,配完务必 nginx -t 并实测。
  • 目录列表 autoindex 默认关闭更安全;需要开放时用 auth_basic 或 IP 白名单收口,敏感目录永远不开列表。
  • 权限控制按场景选:内网用 auth_basic,固定出口用 allow/deny,对外分发用 secure_link 限时签名,密钥务必保密。
  • 传输优化靠 sendfile、tcp_nopush、open_file_cache 和合理的超时;限速用 limit_rate + limit_rate_after,限并用 limit_conn。
  • 所有配置改动都要先备份、nginx -t 校验、reload 生效;出现 404/403 先看 error.log 里的真实路径和权限。