工具用的順手嗎?
你的回饋能幫助我們做得更好
將Apache .htaccess重寫規則、重定向和訪問控制指令快速轉換為Nginx配置,方便網站遷移。
僅生成網站根目錄部分指令的Nginx草案。RewriteCond、Redirect、Header及不支援的標誌保留TODO,不會靜默丟棄;必須核對上下文和行為,不能直接替換生產配置。 參考來源
內容僅在瀏覽器中轉換,不會上傳。支援常見重寫、重定向、錯誤頁、目錄索引和響應頭指令。
輸入 .htaccess 配置後,將在這裡實時生成 Nginx 配置
概覽
了解工具能解決的問題、計算或處理邏輯,以及資料邊界。
Apache 的 .htaccess 常用 RewriteRule、RewriteCond 描述網址改寫或重新導向;Nginx 使用不同的設定語法與執行上下文。這個轉換器會逐行讀取貼上的文字,輸出部分可辨識指令的 Nginx 片段,並顯示轉換數與警告數,適合做遷移初稿和盤點工作。
目前可辨識的常見形式包括 RewriteEngine、部分條件變數的 RewriteCond、RewriteRule、Redirect、DirectoryIndex、Options ±Indexes、ErrorDocument,以及 Header set。條件變數只涵蓋有限集合,例如 HTTP_HOST、REQUEST_URI、HTTPS、REQUEST_METHOD 和 QUERY_STRING。這份清單不代表所有寫法或旗標都能按原意轉換。
例如簡單輸入 RewriteRule ^old-page\.html$ /new-page.html [R=301,L],可生成 return 301 /new-page.html;。若規則含條件、依賴原本目錄位置、特殊旗標或其他模組指令,輸出的文字即使看起來完整,也仍需回到實際請求情境核對。Apache 與 Nginx 的規則語意、匹配範圍和指令位置並非一對一對應。
指南
依步驟完成操作,並透過範例核對輸入與結果。
複製要檢查的 .htaccess 指令,連同相關的條件與註解一起貼入。也可先載入頁面提供的範例,熟悉輸入格式。這裡處理的是貼入的文字,不會替你讀取伺服器上的檔案或整份 Apache 虛擬主機設定。
輸入非空內容後會自動顯示結果。先比對轉換數與原始有效指令數,再逐項查看警告;未識別的行會留有 TODO 註記,不能當成已轉換完成。
複製輸出後,依網站現有的 server、location 等結構安排指令。結果只是片段,並非可直接取代整份 Nginx 設定的檔案。
在測試環境驗證舊網址、新網址、狀態碼、查詢參數和規則順序。再依伺服器版本與部署方式檢查設定語法,通過後才安排正式切換。
情境
查看這項工具在不同工作與生活流程中的用法。
網站管理者可貼入簡單的 RewriteRule 或 Redirect,產生重新導向草稿。逐條核對來源路徑、目的網址與 301/302 狀態碼,再確認是否需要保留查詢參數。
維運或開發人員可用警告和 TODO 快速標記未識別的行,將已辨識部分與待處理指令分開檢視。這適合做遷移盤點,不會代替工程師判斷原規則依賴的目錄或伺服器上下文。
問答
集中解答常見疑問與容易混淆的問題。
不符合目前辨識格式的指令、未知的條件變數,以及沒有對應 RewriteRule 的尾端 RewriteCond 會產生警告或 TODO。工具不會因此自動補出等效設定,請逐行查閱並手動處理。
目前不能依賴它們會被正確轉換。這些舊有說明中的自動處理承諾不適用於目前功能;若輸入後出現警告,需按站點需求重新設計 Nginx 規則。
不建議直接部署。產生內容是指令草稿,沒有包含完整站點設定,也無法證明與 Apache 執行結果一致。應先確認設定上下文、檢查語法,並用實際網址在測試環境驗證。
不保證。輸出會按可辨識旗標選擇 last 或 break,但 Apache 的規則處理階段與 Nginx 的上下文不同;Nginx 官方文件也說明兩種旗標會影響後續處理方式。應根據規則所在位置和請求流程測試。
須知
使用前了解適用範圍、結果限制與必要提醒。
轉換成功只代表某行符合目前的文字辨識模式,不代表兩台伺服器會得到相同結果。尤其是條件串接、正規表示式、目錄層級規則、重寫順序與設定區塊位置,都可能改變匹配結果。Nginx 的 last 會重新搜尋符合的 location,break 則停止目前這組 rewrite 指令處理;實際行為請按官方文件和站點設定核對。
請保留原始設定,先在測試環境檢查轉址鏈、狀態碼、查詢字串和錯誤頁等情境,並使用伺服器提供的設定檢查方式。未轉換的項目不要直接刪除或忽略。貼入的設定文字可能含內部網域或路徑;避免放入密碼、金鑰等機密,也留意分享功能可能會帶上輸入內容。
若設定用於正式網站網址搬遷,請另外規劃舊網址到新網址的對應與上線後檢查;Google 搜尋中心的網站遷移說明可供重新導向規劃參考。它不能替代你對伺服器規則和站點結果的驗證。
推薦
查找相關工具、專題與可用的 API 能力。