在线htaccess转Nginx工具

你什么时候需要这个工具

把网站从Apache迁移到Nginx时，最让人头疼的就是.htaccess里的重写规则不能直接用了。一名站长手动转换了整整50条URL重定向，花费半天时间——而用我们这个转换器，粘贴进去就能即时得到Nginx配置。这个工具专门处理Apache mod_rewrite的重写规则、RewriteCond条件、301/302重定向，以及常见的访问控制指令，保障切换平稳过渡。

快速参考：常见.htaccess规则对照

下表列出了几种最常用的.htaccess指令以及转换后对应的Nginx配置。你可以直接在转换器里粘贴左侧的.htaccess规则，验证转换结果。

.htaccess 规则	Nginx 配置
RewriteRule ^old$ /new [R=301,L]	rewrite ^/old$ /new permanent;
RewriteCond %{HTTP_HOST} ^www\.example\.com$ [NC] RewriteRule ^(.*)$ http://example.com/$1 [R=301,L]	if ($host = 'www.example.com') { rewrite ^/(.*)$ http://example.com/$1 permanent; }
RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . /index.php [L]	try_files $uri $uri/ /index.php?$args;
<FilesMatch "\.(htaccess|htpasswd)$"> deny from all </FilesMatch>	location ~* \.(htaccess|htpasswd)$ { deny all; }

怎么使用这个转换器

打开转换页面，你会看到两个主要区域：左侧是输入框，右侧是输出框。操作步骤如下：

1. 在左侧输入框中，粘贴你的.htaccess文件内容，或者手写几条规则。例如，输入 RewriteRule ^about$ /about-us.html [R=301,L]。
2. 点击中间的“转换”按钮（或页面自动触发转换，取决于工具实现）。
3. 右侧输出框会立即显示对应的Nginx配置。对于上面的例子，你会看到 rewrite ^/about$ /about-us.html permanent;。
4. 如果原始的.htaccess中包含多条规则，转换结果会按顺序列出，每条规则独立一行。
5. 你可以点击“复制”按钮，把转换后的Nginx配置粘贴到你的服务器配置文件中。

如果转换过程中遇到不支持的指令，输出框顶部会显示警告信息，指出哪些行被跳过或需要手动调整。

实操算例：WordPress固定链接

假设你有一个WordPress站点，.htaccess中典型的固定链接规则如下：

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

将其粘贴到转换器左侧输入框，点击“转换”。右侧输出的Nginx配置为：

# WordPress permalinks
location / {
    try_files $uri $uri/ /index.php?$args;
}

转换器识别出这组规则的核心意图是“如果请求的文件或目录不存在，交给index.php处理”，并自动合并为Nginx高效的try_files指令，避免了低效的if判断。你在Nginx配置中直接使用这段配置，即可实现相同的伪静态效果。

更多转换例子

场景1：301重定向旧页面
输入：

RewriteRule ^old-page\.html$ /new-page.html [R=301,L]

输出：

rewrite ^/old-page\.html$ /new-page.html permanent;

场景2：基于域名的条件跳转
输入：

RewriteCond %{HTTP_HOST} ^olddomain\.com$ [NC]
RewriteRule ^(.*)$ http://newdomain.com/$1 [R=301,L]

输出：

if ($host = 'olddomain.com') {
    rewrite ^/(.*)$ http://newdomain.com/$1 permanent;
}

场景3：禁止访问特定文件
输入：

<FilesMatch "\.(htaccess|htpasswd|ini|log|sh)$">
Order Allow,Deny
Deny from all
</FilesMatch>

输出：

location ~* \.(htaccess|htpasswd|ini|log|sh)$ {
    deny all;
}

这些例子你都可以在转换器里直接测试，粘贴后立即看到结果。

转换时容易踩的坑

• RewriteBase 被忽略：.htaccess 中的 RewriteBase 指令在 Nginx 中没有直接对应项。转换器会尝试将其合并到规则路径中，但如果你的规则依赖 RewriteBase 与目录上下文，转换后可能需要手动检查路径前缀。
• 复杂的嵌套条件：多个 RewriteCond 与 RewriteRule 组合时，转换器会生成 if 块。但 Nginx 的 if 指令在某些 location 下可能引发意外行为，不建议在 location 内过于复杂地嵌套 if。转换结果仅供参考，建议尽量用 location 和 try_files 替代。
• 顺序性的重写链：.htaccess 中多条 RewriteRule 会依次执行，而 Nginx 中 rewrite 指令也会按顺序执行，但 last 标记的行为有差异（last 表示重新开始匹配，break 停止）。转换器会尽量对应，但建议在 Nginx 中测试重定向链。
• 访问控制语法差异：.htaccess 的 Allow/Deny、Order 指令与 Nginx 的 allow/deny 指令参数顺序不同，转换器会处理常见模式，但自定义复杂的 IP 访问控制可能需要手动调整。
• 使用 [OR] 标志的 RewriteCond 组合：转换器会将这种条件转换为 if 语句中的逻辑或，但 Nginx 对 if 语句的支持有限，建议查看输出中的注释，可能需要进行优化。

常见问题

为什么转换后的Nginx配置中出现了if语句，会影响性能吗？

Nginx 官方文档指出，if 语句在 location 中使用时可能会导致不可预期的行为，但在 server 级别的 if 块用于重写是可以接受的。转换器产生的 if 通常用于域名跳转等场景，性能影响很小。如果你的配置中出现了大量 if，建议考虑用 map 或者多个 location 块来优化。

转换器支持所有.htaccess指令吗？

目前支持 mod_rewrite 的重写规则、RewriteCond、301/302/307 重定向标记，以及常见的 FilesMatch、deny/allow 指令。不支持 mod_auth、mod_headers 等模块的指令，这些需要你手动查找 Nginx 的对应配置（例如 auth_basic、add_header）。

转换后的配置可以直接放到Nginx的哪个位置？

通常放在 server 块内，或者放在以 location / 开头的块中。如果转换结果包含 location 块，你应该将其放在 server 块内适当位置。注意不要直接替换整个 nginx.conf，而是提取相关部分。

为什么我的RewriteRule被注释掉了？

当转换器遇到无法安全转换的规则（例如带有 [P] 代理标志的规则），会在输出中添加注释，并保留原始规则供你参考。你需要手动修改以实现同样的功能。

注意事项

• 本工具旨在辅助转换，不保证转换后的配置完全适用于所有环境。转换结果应作为起点，务必在测试服务器上验证后再部署到生产环境。
• 工具不处理 .htaccess 中基于目录上下文的动态继承关系，Nginx 没有目录级配置继承机制，你需要根据实际目录结构在对应的 location 下应用转换结果。
• 对 .htaccess 中使用的第三方模块（如 mod_security）指令，工具无法转换，因为 Nginx 没有等效模块。
• 转换器基于常见模式匹配，对于非常规的正则表达式嵌套或边缘情况，可能会出现偏差。建议在转换前备份原始 .htaccess 文件。

现在，把你的 .htaccess 规则粘贴到上方的转换器中，立即获得 Nginx 配置，开始无缝迁移吧。

计算依据 / 方法说明

• Apache HTTP Server Documentation: mod_rewrite — Apache mod_rewrite 模块官方文档，说明RewriteRule、RewriteCond等指令的语法和用法。
• Nginx Documentation: ngx_http_rewrite_module — Nginx rewrite模块官方文档，定义rewrite、if、return等指令的用法。

最后更新 2026年7月17日 · 由 工具匠 维护