宝塔面板Nginx/Apache单、整站下载限速设置零门槛完整教程

一、操作前准备

请确保已完成以下3项前置检查，避免操作失败：

• 1. 已安装宝塔面板，版本建议6.9.0及以上（旧版功能可能不全）
• 2. 已部署目标站点，使用Nginx或Apache任意一种Web服务器
• 3. 已备份目标站点的Web配置文件：宝塔面板→网站→对应站点→设置→配置文件→复制全部内容→本地记事本保存

二、Nginx站点下载限速配置

此部分包含整站全局下载限速和指定目录/文件格式下载限速两种场景，按需选择。

场景1：整站全局下载限速

操作路径：宝塔面板→网站→对应Nginx站点→设置→配置文件

找到配置文件中server {块内的location / {块，在其内部最前面（或内部任意位置，但建议前置避免冲突）添加以下2行代码：

```nginx limit_rate 512k; 单线程限速，单位支持k/m/g，此处设为512KB/s limit_rate_after 10m; 前10MB不限速，超出后启用限速（可选，删除则全程限速） ```

添加后点击右上角保存，再点击面板左侧软件商店→找到Nginx→点击设置→重载配置（千万不要点重启，重载更平滑不影响站点访问）

场景2：指定目录/文件格式下载限速

此场景优先级高于整站全局限速，适合只限制软件库、资源包等特定内容。

子场景2.1：指定单一目录限速

假设要限速的目录是站点根目录下的/download（真实路径对应/www/wwwroot/你的站点域名/download），在server {块内单独新增一个location块：

```nginx location ^~ /download/ { 目录常规权限配置（复制原location / {块内的前几行，比如index、root、access_log等，此处默认已保留基础权限，无特殊配置可直接用） limit_rate 1m; 单线程限速1MB/s limit_rate_after 20m; 前20MB不限速 } ```

注意：^~前缀表示优先匹配此路径，避免被其他location块拦截；目录路径必须以/结尾，匹配更精准。

子场景2.2：指定文件格式限速

假设要限速的文件格式是.zip/.rar/.7z/.exe/.mp4/.iso，在server {块内单独新增一个location块：

```nginx location ~ \.(zip|rar|7z|exe|mp4|iso)$ { 同样保留常规权限配置，无特殊可直接用 limit_rate 2m; limit_rate_after 50m; } ```

注意：~前缀表示不区分大小写匹配（比如.ZIP也会被限制）；如果只需要区分大小写，把~改成~即可。

三、Apache站点下载限速配置

此部分同样包含整站全局下载限速和指定目录/文件格式下载限速两种场景，Apache默认未安装限速模块，需先完成模块安装。

前置：安装Apache限速模块

操作路径：宝塔面板→软件商店→找到已安装的Apache→点击设置→模块管理

在模块搜索框输入mod_bw，找到后点击右侧安装按钮，等待1-2分钟安装完成（安装过程中Apache会短暂重载，无明显影响）。

场景1：整站全局下载限速

操作路径：宝塔面板→网站→对应Apache站点→设置→配置文件

找到配置文件中（如果有HTTPS，还要同步修改块）块的最后一行（之前）添加以下代码：

```apache 启用mod_bw限速模块 BandWidthModule On 限制所有用户（用all表示）的单线程速度，单位是字节/秒，1MB=10241024=1048576字节 BandWidth all 1048576 限制所有用户的前X字节不限速，单位是字节，此处设为2010241024=20971520字节（可选，删除则全程限速） MinBandWidth all 20971520 强制指定限速单位（可选，方便后续直接用k/m/g，添加后单位生效，不用换算字节） LargeFileLimit 0 m ```

注意：如果添加了LargeFileLimit 0 m，后续的BandWidth和MinBandWidth可以直接写数值加单位，比如BandWidth all 2m、MinBandWidth all 50m，无需再换算字节。

添加后点击右上角保存，再点击软件商店Apache的重载配置。

场景2：指定目录/文件格式下载限速

子场景2.1：指定单一目录限速

假设要限速的目录还是/download，在对应块的最后一行之前添加以下代码：

```apache BandWidthModule On BandWidth all 524288 MinBandWidth all 10485760 LargeFileLimit 0 m ```

注意：Directory标签内必须填写绝对路径（可以在宝塔面板→文件→找到站点根目录→右键对应目录→属性，复制路径粘贴）；此块优先级高于全局VirtualHost块。

子场景2.2：指定文件格式限速

Apache的mod_bw模块不直接支持按文件格式限速，需配合FilesMatch标签使用，在对应块的最后一行之前添加以下代码：

```apache SetEnv no-gzip 1 避免压缩文件解压后限速失效，非必须但建议添加 BandWidthModule On BandWidth all 2097152 MinBandWidth all 52428800 LargeFileLimit 0 m ```

四、限速效果验证

配置完成后必须立即验证，避免出现错误配置导致限速失效或站点异常：

• 1. 站点访问验证：打开浏览器访问你的站点首页、任意文章页，确保页面加载正常，无404/502错误
• 2. 下载限速验证：
  • ① 从你的站点下载一个符合限速规则的文件（大小建议超过MinBandWidth设置的数值，确保看到限速前后的变化）
  • ② 推荐使用IDM（Internet Download Manager）验证，因为IDM支持多线程下载，更直观：打开IDM→新建任务→粘贴文件链接→开始下载→观察下载速度曲线，前X秒/X MB会满速，之后稳定在限制速度的倍数（单线程设置512KB/s，4线程则约2MB/s）
  • ③ 如果没有IDM，也可以用浏览器自带下载器，但只能验证单线程速度

五、常见问题排查

• 1. Nginx/Apache重载配置失败：

  检查配置文件语法，宝塔面板在保存时会自动检测语法，如果有错误会有红色提示，根据提示修改即可；也可以查看日志：Nginx/Apache设置→日志查看→错误日志

• 2. 限速失效：

  检查路径/文件格式是否正确，检查模块是否启用（Apache需确认mod_bw在模块管理中是已启用状态），检查配置块优先级是否正确（Nginx的^~ location块优先级最高，Apache的Directory块优先级高于VirtualHost块，FilesMatch块优先级更高）

• 3. 压缩文件下载后限速失效：

  Apache站点需添加SetEnv no-gzip 1，Nginx站点需检查是否有gzip配置覆盖了，可在限速的location块内添加gzip off;临时关闭压缩验证