.htaccess 转 Nginx

粘贴 Apache 的 .htaccess,把伪静态、强制 HTTPS、www 跳转、301 重定向、错误页、文件访问限制、响应头、缓存、压缩、密码保护和 IP 限制等规则转换为 Nginx 配置;WordPress、Laravel、ThinkPHP 的入口规则会转为 try_files,无法自动转换的规则会逐条标注原因。

示例:
Nginx 配置(放进 server { } 中)

转换说明

Apache 和 Nginx 的规则差别

  • 路径前面多一个斜杠:.htaccess 中的 RewriteRule 匹配的是去掉目录前缀的相对路径(如 ^about$),Nginx 的 rewrite 匹配完整路径(^/about$),转换时会自动补上。
  • Nginx 没有 RewriteCond:多个条件需要拆成 if 或 map,而 Nginx 的 if 只支持单个条件,复杂的组合条件需要手动改写。“文件不存在就交给入口文件”这类条件应写成 try_files,比 if 更高效。
  • 没有 .htaccess 机制:Nginx 只读取主配置,修改后执行 nginx -t 检查语法,再 nginx -s reload 生效。宝塔面板可以把转换结果粘贴到网站设置的“伪静态”中(不需要外层的 server)。
  • add_header 的继承:在 location 中写了任何 add_header,外层 server 的 add_header 就不再生效,需要在 location 中重复写安全响应头。
  • php_value:PHP-FPM 不支持 .htaccess 中的 php_value,转换为 fastcgi_param PHP_VALUE,需要放在处理 .php 的 location 中,或者直接修改 php.ini。

转换后建议逐条在测试环境验证。从零开始配置 Nginx 可以用 Nginx 配置生成器,生成 Apache 配置可以用 .htaccess 生成器。

.htaccess 转 Nginx常见问题

.htaccess 转 Nginx怎么使用?

把 .htaccess 内容粘贴到左侧,或点击 WordPress、Laravel、ThinkPHP 等示例;右侧实时生成 Nginx 配置并统计转换条数,下方逐行列出无法自动转换的规则和原因,复制后放进站点的 server 块中。

WordPress 的伪静态在 Nginx 中怎么写?

location / { try_files $uri $uri/ /index.php?$args; },点击 WordPress 示例可以直接生成。

RewriteRule 为什么要加斜杠?

.htaccess 中匹配的是相对路径,Nginx 的 rewrite 匹配以斜杠开头的完整路径。

Nginx 支持 RewriteCond 吗?

不支持,单个条件可以写成 if,文件存在判断用 try_files,复杂条件需要用 map。

转换后 php_value 怎么办?

改为 fastcgi_param PHP_VALUE 写在 PHP 的 location 中,或者修改 php.ini。

.htaccess 转 Nginx的结果应怎样理解?

自动转换覆盖常见写法;包含多个 RewriteCond 组合条件、环境变量、%N 反向引用等复杂规则需要手动改写;转换结果请在测试环境中用 nginx -t 检查。

输入内容会保存或发给外部服务吗?

配置内容只在浏览器本地转换,不会上传。

没有结果或操作失败时先检查什么?

Nginx 启动报错时,执行 nginx -t 查看出错的行;宝塔面板的伪静态设置中只需要粘贴 location 和 rewrite 部分。

相关工具

.env 文件生成器 · .htaccess 生成器 · JSON 格式化校验 · Base64 编码解码 · 全部开发工具