把一批安装包、固件、报表放在服务器上供人下载,是很多企业内网和个人站点的刚需。用 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 里的真实路径和权限。
企业QQ咨询




