線上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日 · 由 工具匠 維護