在网站运维过程中，经常会遇到域名更换、页面路径调整等场景，需要配置大量301重定向规则。如果使用宝塔面板的单个规则添加功能，处理几百条规则会非常耗时，还容易出现配置错误。通过直接修改Nginx配置文件批量写入规则，是更高效的处理方式。
批量301重定向的核心逻辑
Nginx的return 301指令可以直接实现永久重定向，批量规则的核心是将所有需要重定向的旧地址和新地址对应关系整理成统一格式，一次性写入配置文件中。需要注意规则的作用范围，避免影响其他站点的正常访问。
规则编写格式
单条301重定向的Nginx配置格式如下：
# 单条重定向示例：将旧页面重定向到新页面
location = /old-page.html {
return 301 https://www.ipipp.com/new-page.html;
}
如果是批量处理，可以将多个location块集中放在对应站点的配置段中，也可以先整理成映射关系，通过脚本生成配置内容。
宝塔面板中批量配置步骤
步骤1：整理重定向映射表
首先将所有需要配置的重定向关系整理成表格，包含旧地址路径和新地址完整URL两列，例如：
| 旧地址路径 | 新地址URL |
|---|---|
| /article/2020/01.html | https://www.ipipp.com/article/2020-jan.html |
| /product/old-id-123 | https://www.ipipp.com/product/new-id-456 |
步骤2：生成批量配置内容
根据映射表生成对应的Nginx配置代码，如果是少量规则可以手动编写，几百条规则建议使用脚本生成。以下是Python生成脚本示例：
# 读取映射表生成Nginx配置
mapping = [
("/article/2020/01.html", "https://www.ipipp.com/article/2020-jan.html"),
("/product/old-id-123", "https://www.ipipp.com/product/new-id-456"),
# 其他重定向规则
]
config_lines = []
for old_path, new_url in mapping:
line = f"location = {old_path} {{n return 301 {new_url};n}}"
config_lines.append(line)
# 输出所有配置内容
print("n".join(config_lines))
步骤3：写入Nginx配置文件
登录宝塔面板，进入网站模块，找到需要配置重定向的站点，点击设置，选择配置文件选项卡。在server块内部，将生成的批量配置内容粘贴进去，注意不要放在其他location块内部，避免规则冲突。
修改完成后点击保存，然后点击面板顶部的重启Nginx按钮，让配置生效。
注意事项与错误排查
- 配置前建议先备份原Nginx配置文件，避免修改错误导致站点无法访问。
- 如果重定向规则包含正则匹配需求，可以使用
location ~正则匹配语法，例如批量重定向某个目录下的所有旧页面：
# 正则匹配重定向示例：将/old-dir/下的所有页面重定向到/new-dir/对应页面
location ~ ^/old-dir/(.*)$ {
return 301 https://www.ipipp.com/new-dir/$1;
}
- 配置生效后可以通过
curl -I 旧地址命令检查返回状态码是否为301，以及Location头是否正确指向新地址。 - 如果出现Nginx启动失败的情况，可以查看软件商店中Nginx的错误日志，排查配置语法错误。
注意：如果站点同时使用了宝塔面板的伪静态规则，需要确保批量写入的301规则优先级高于伪静态规则，避免伪静态规则先匹配导致重定向不生效。