Instant Indexer
當公開頁面發生變更時,通知參與的搜尋引擎。實際抓取哪些內容由各搜尋引擎自行決定。
外掛
Instant Indexer
當公開頁面發生變更時,通知參與的搜尋引擎。實際抓取哪些內容由各搜尋引擎自行決定。
說明
Instant Indexer 會在公開頁面被新增、修改或移除時通知參與的搜尋引擎。實際抓取哪些內容由各搜尋引擎自行決定。
變更
外掛程式會在發佈、即時編輯、下架、移至垃圾桶與還原時,將納入範圍的公開項目加入佇列。修改 slug 時,新舊兩個 URL 都會加入佇列。編輯通常在 30 到 90 秒後傳送,在這個時間窗口內每個 URL 只傳送一次。每個請求最多包含 1,000 個 URL。
草稿、尚未發佈的排程項目、預覽頁與 noindex 頁面不會被納入。對於已知位址,在 noindex 變更後會傳送移除通知。已加入佇列的頁面不會被重新檢查;較早的通知可能先於 noindex 或下架通知送達。
傳送功能預設為關閉。關閉期間發生的變更不會加入佇列。關閉傳送會取消「全部提交」。等待中的 URL 會在下一次傳送或每小時清理時被捨棄,即使之後又重新開啟了傳送。
設定與紀錄
在設定中選擇內容類型與端點。需要一個根目錄金鑰檔案 https:///.txt,其中只包含產生的金鑰。也可以改為將該根路徑重新導向到外掛程式的金鑰路由;部分搜尋引擎可能不會跟隨重新導向。
設定完成後,使用首頁 URL 進行測試。回應 200 表示金鑰驗證通過;回應 202 表示正在等待金鑰檢查。啟用傳送後,使用「全部提交」將現有的公開頁面加入佇列,並記住它們的位址,以便日後傳送移除通知。
編輯與管理員可以檢視提交紀錄。管理員管理設定與提交。儀表板會顯示等待中與已傳送的 URL 數量以及最近一次回應。
外掛程式採用 MIT 授權,不需要帳號、授權金鑰,也不蒐集遙測資料。
Instant Indexer 是 Peachfin Themes 開發的獨立外掛程式,與 IndexNow 或任何搜尋引擎的營運方沒有關聯,也未獲得其認可。
安裝
需求
使用 EmDash 1.1 或更新版本,並具備沙箱執行器(Cloudflare:Workers Paid 與 Worker Loader 繫結;Node:workerd)。已在 EmDash 1.2.0 上測試。
安裝方式
- 從外掛程式註冊表安裝 Instant Indexer(
@peachfinthemes.com/instant-indexer)。 - 核准內容與結構描述的讀取權限以及網路存取權限。「安全性」一節列出了允許存取的主機。
- Instant Indexer 設定:EmDash 1.1:設定位址。1.2:先使用已設定的位址,然後是 Site URL,最後是設定。在 1.1 上修正設定;在 1.2 上,透過 Settings > General 中的 Change domain 使用設定或 Site URL(https;僅 localhost 可使用 http)。重新啟動 Node;在 Workers 上,重新部署或等待新的隔離實例。Public site address (optional) 會覆寫通訊協定、主機與連接埠。它不能取代缺失的 EmDash 位址;缺失時不會傳送任何內容。
- 加入下文所述的根目錄金鑰檔案。
- 開啟 Send changes to search engines 並儲存。傳送關閉期間發生的變更不會加入佇列。
- 選擇 Test connection。回應 200 表示金鑰驗證通過。回應 202 表示正在等待金鑰檢查。如果持續如此,請檢查根目錄檔案是否包含已儲存的金鑰並且可公開讀取。
- 執行 Submit all published URLs now,將現有的公開頁面加入佇列,並記住它們的位址,以便日後傳送移除通知。
關閉傳送會取消「全部提交」。啟用傳送後請重新啟動它。等待中的 URL 會在下一次傳送或每小時清理時被捨棄,即使之後又重新開啟了傳送。
根目錄金鑰檔案
安裝時會產生一組隨機金鑰。在網站的 public/ 資料夾中新增 .txt 檔案,內容只包含該金鑰,然後部署。它必須能夠透過 https:///.txt 讀取。
也可以將 /.txt 重新導向到同一網站上的 /_emdash/api/plugins/instant-indexer/key。部分搜尋引擎可能不會跟隨重新導向。無論哪種方式,都需要根目錄金鑰路徑。
更換金鑰後,請更新根目錄檔案或重新導向,並重新測試。
本機與測試位址會被拒絕。請在公開的預備環境副本上保持傳送關閉。
常見問題
它會傳送什麼?
Instant Indexer 使用 IndexNow 通訊協定,在公開頁面發生變更時通知參與的搜尋引擎。實際抓取哪些內容由各搜尋引擎自行決定。並非所有搜尋引擎都參與。
測試是如何進行的?
Test connection 會傳送一個包含首頁 URL 的請求,並且從不重試。回應 200 表示金鑰驗證通過。回應 202 表示正在等待金鑰檢查。如果持續如此,請檢查根目錄金鑰檔案是否可公開讀取並包含已儲存的金鑰。收到 429 或伺服器錯誤時會暫停傳送。暫停期間測試會被拒絕。
為什麼需要根目錄金鑰檔案?
金鑰必須能透過 https:///.txt 取得,才能涵蓋一般頁面。該檔案只能包含已儲存的金鑰。也可以改為將該路徑重新導向到外掛程式的金鑰路由,但部分搜尋引擎可能不會跟隨。如果收到 422 回應,請檢查根目錄檔案,並確認頁面 URL 使用相同的主機。
什麼時候應該使用「全部提交」?
在啟用傳送之後執行它,以便將現有頁面加入佇列,並記住位址以供日後傳送移除通知。未知的 URL 無法作為移除回報。被排除的內容類型會被略過。關閉傳送會取消本次執行;開啟後請重新啟動。等待中的 URL 會在下一次傳送或每小時清理時被捨棄,即使之後又重新開啟了傳送。
傳送失敗時會怎樣?
回應 400、403 與 422 會捨棄該批次。請修正原因,然後使用 Submit all published URLs now 重新將現有頁面加入佇列。對於 429、伺服器錯誤與網路錯誤,已加入佇列的 URL 會以遞增的等待時間重試。會遵循 Retry-After,最長 7 天。每個佇列列在失敗 8 次後停止重試。新的編輯會讓該 URL 重新加入佇列。
在哪裡可以獲得協助?
請造訪支援頁面。
安全性
回報問題
在提交公開 issue 之前,請先以私下方式向 [email protected] 回報安全性問題。
權限
內容讀取權限用於尋找公開項目的 URL。結構描述讀取權限用於識別 URL 模式與公開的內容類型。外掛程式無法寫入或發佈內容。
網路存取
外掛程式只能連線到以下端點主機:
api.indexnow.orgwww.bing.comyandex.com
請求會傳送到所選的端點,內容包括網站的主機名稱、金鑰、金鑰位置與公開頁面的 URL。如果個人資料是位址的一部分,URL 中可能包含個人資料。沒有遙測。
草稿、尚未發佈的排程項目、預覽頁與 noindex 頁面不會作為新頁面加入佇列。對於已知位址,在 noindex 變更後會傳送移除通知。已加入佇列的頁面不會被重新檢查;較早的通知可能先於 noindex 或下架通知送達。其他主機上的 URL 會被捨棄。
存取與金鑰
編輯與管理員可以檢視提交紀錄。管理員管理設定與提交。
需要一個可公開讀取的根目錄金鑰檔案 https:///.txt,其中只包含已儲存的金鑰。也可以將該路徑重新導向到 /_emdash/api/plugins/instant-indexer/key;部分搜尋引擎可能不會跟隨。外掛程式會以純文字、不快取的方式提供其金鑰路由。
儲存的資料
網站會儲存設定、金鑰、等待中的 URL、記住的位址與紀錄。每次傳送與每小時清理時,紀錄都會被修剪到約 200 筆;計數可能短暫偏高。每次傳送最多寫入 90 列,其餘 URL 以彙總列表示。
解除安裝時會依網站的解除安裝選項刪除這些資料。
測試網站
位址缺失、本機位址與測試位址都會阻止傳送。位址檢查並不能證明網站是公開的或處於正式環境。傳送功能預設為關閉。請在公開的預備環境副本上保持關閉。
更新日誌
1.0.1 (2026-10-08)
已在 EmDash 1.2.0 上測試。更新了適用於 EmDash 1.2 的網站位址說明。外掛程式的運作方式沒有變更。
1.0.0 (2026-10-06)
在公開頁面發生變更時,透過 IndexNow 通知參與的搜尋引擎。實際抓取哪些內容由各搜尋引擎自行決定。
- 傳送功能預設為關閉。關閉期間發生的變更不會加入佇列。關閉傳送會取消「全部提交」。等待中的 URL 會在下一次傳送或每小時清理時被捨棄,即使之後又重新開啟了傳送。
- 對發佈、即時編輯、下架、移至垃圾桶與還原的變更加入佇列,修改 slug 後新舊兩個 URL 都會加入佇列。編輯通常在 30 到 90 秒後傳送,每個窗口內每個 URL 只傳送一次,每個請求最多包含 1,000 個 URL。
- 排除草稿、尚未發佈的排程項目、預覽頁與 noindex 頁面。對於已知位址,在 noindex 變更後會傳送移除通知。已加入佇列的頁面不會被重新檢查。
- 為參與的搜尋引擎提供三個端點可供選擇。
- 安裝時產生一組隨機金鑰。需要由擁有者提供根目錄金鑰檔案。也可以將根目錄金鑰路徑重新導向到外掛程式的金鑰路由。回應 200 表示金鑰驗證通過;202 表示正在等待金鑰檢查。
- 從網站讀取公開的 URL 模式、語系前綴與結尾斜線設定。路徑覆寫是選用的。
- 「全部提交」每一步讀取 90 個項目,並記住 URL 以便傳送移除通知。取消在下一步生效;除非停用了傳送,已加入佇列的 URL 仍會傳送。
- 對速率限制、伺服器錯誤與網路故障以遞增的等待時間重試。Retry-After 最長適用 7 天。每個佇列列在失敗 8 次後停止重試。測試不會重試。
- 每次傳送與每小時清理時,將紀錄修剪到約 200 筆。儀表板會顯示等待中與已傳送的 URL 數量以及最近一次回應。
- 管理員控制設定與提交。內容與結構描述存取均為唯讀。網路存取僅限於宣告的三個端點。
採用 MIT 授權,不需要帳號、授權金鑰,也不蒐集遙測資料。