HTAccess 转 Nginx:重写规则翻译

HTAccess 转 Nginx:重写规则翻译

Apache 说 .htaccess;nginx 说 location 块。站点从一台服务器迁到另一台——一件平常事——每条 URL 规则都要翻译,而两种语言几乎处处不一致。

这些规则做什么

两套系统回答同样的问题:有人请求 /old-page 时怎么办?重定向到 /new-page?隐形重写到脚本?拦截?职责相同;语法不同。

关键区别

概念 Apache(.htaccess) Nginx
规则位置 按目录的文件 服务器配置、location 块
重写语法 RewriteRule ^old$ /new [R=301,L] rewrite ^/old$ /new permanent;
重定向语法 Redirect 301 /old /new return 301 /new;
条件 RewriteCond 链 if 块或 location 里的正则

迁移工作流

  1. 列出你现有的规则——重定向、重写、安全拦截、缓存头。
  2. 用 HTAccess 转 Nginx 工具逐条翻译——粘进 Apache 规则,得到 nginx 等价物。
  3. 上线前用 curl 逐条测试翻译结果——一条翻错的重写,就是每个访客的 500 错误。

坑

  • 顺序规则不同:nginx 的 location 匹配基于前缀且有优先级体系;Apache 自上而下处理。直接翻译有时需要重排。
  • 性能模型:.htaccess 每请求读取;nginx 启动时编译规则。翻译后的规则应放进服务器配置,而不是模拟。
  • 有些东西映射不了:Apache 专属模块(如 mod_rewrite 的条件技巧)需要重新思考,而不是翻译。

转换器负责机械部分——语法。判断部分——顺序、测试、语义——还是你的。两者结合,迁移才安全。