UA PRO 使用指南

入門指南

從第一條規則開始,了解作用範圍、隨機模式、資源備援與設定遷移。

適用版本:1.4.5 · 指南更新日期:2026 年 11 月 16 日

本指南適用於 1.4.5 版。請確認所選安裝來源提供的版本。

UA Pro 可讓你為所有網站、特定網域或單一分頁設定 User-Agent(UA)。先選擇規則影響哪些頁面,再選擇 UA 的產生方式。存在多條規則時,擴充功能會依優先順序選出一條主頁面規則;一般頁面內資源會優先繼承主頁面的 UA。

01認識 UA 與頁面資源

UA 是瀏覽器傳送給網站的身分描述,通常包含瀏覽器、作業系統與裝置資訊。UA Pro 可以修改一般網頁請求的 User-Agent,並在一般頁面上為 navigator.userAgent 提供相符的值。

選擇行動裝置 UA 可讓你觀察網站對行動裝置 UA 回傳什麼內容,但不會把電腦變成手機,也不會自動改變螢幕大小、瀏覽器引擎、IP 或完整瀏覽器指紋。

假設網址列顯示 https://shop.example.com/product:

名詞 本例中的意思
主頁面 在網址列開啟的商品頁面
主頁面網域 shop.example.com,不含通訊協定或路徑
父網域 相對於 shop.example.com,example.com 是父網域
子網域 img.shop.example.com 是 shop.example.com 底下的子網域
頁面內資源 頁面載入的圖片、指令碼、樣式、API 請求、一般網路 iframe 等
資源網域 資源請求的目標網域,例如 cdn.example.net

本指南中的「主頁面網域」指網址列中頁面的主機名稱。它不是 .com 這類頂層網域,也不一定是 example.com 這類已註冊網域。

02三個獨立的設定概念

設定 回答的問題 範例
作用範圍 哪些頁面使用這條規則? 全域、example.com 網域、目前分頁
UA 模式 UA 內容從哪裡來? 內建 UA、自訂、附加文字、隨機 UA
隨機模式 選擇隨機時,何時重新抽取? 每次頁面載入、每個分頁

例如,「網域範圍 + 隨機 UA + 每個分頁」表示每個造訪該網域範圍內頁面的分頁,都會各自儲存這條規則的隨機結果。這不代表造訪該網域的所有分頁共用一個永久 UA。

2.1 作用範圍

作用範圍 影響對象 持續時間與覆蓋關係
全域 沒有更高優先順序規則的一般網站頁面 設定會保留;可被網域或分頁規則覆蓋
網域 主頁面網域符合指定網域或其子網域的頁面 設定會保留;可被更具體的網域規則或分頁規則覆蓋
分頁 建立規則的分頁 優先順序最高;該分頁前往其他網站時仍適用,關閉分頁後停止

「全域範圍 + 每個分頁隨機」仍然是全域規則;分別儲存隨機結果不會使它變成優先順序最高的分頁規則。

2.2 UA 模式

模式 UA 的產生方式 適用情境
內建 UA 從預設的瀏覽器或裝置中選取 UA 快速使用預設身分
自訂 使用你輸入的完整 UA 字串 使用指定 UA,或儲存自己的 UA 清單
附加文字 在瀏覽器預設 UA 後加上空格與指定文字 在預設 UA 後附加識別標記
隨機 UA 從選定的候選池中抽取 UA 按每次頁面載入或每個分頁分配隨機值

附加文字以瀏覽器預設 UA 為基礎,而不是以被覆蓋的父網域 UA 或全域 UA 為基礎。例如,全域規則是自訂 UA,而網域規則附加 MyTest,則該網域最終使用「瀏覽器預設 UA + 空格 + MyTest」。兩條規則不會疊加。

隨機候選池可來自內建 UA、自訂清單、附加文字清單,或這些來源的組合;你也可以選取特定類別。附加文字候選項會先與瀏覽器預設 UA 組合,再加入抽選。若候選池為空或沒有有效內容,該規則就無法成為有效的主頁面規則。

03主頁面規則優先順序

分頁規則 → 最具體的有效網域規則 → 逐層向上的父網域規則 → 全域規則 → 瀏覽器預設 UA。

依此順序使用第一條已啟用且能產生有效 UA 的規則,後續規則不會與其組合。固定模式和隨機模式之間沒有額外的優先順序。

檢查順序 主頁面為 news.shop.example.com 時的範例
1 目前分頁規則
2 news.shop.example.com 的有效規則
3 shop.example.com 的有效規則
4 example.com 的有效規則
5 有效的全域規則
6 以上皆無有效規則;使用瀏覽器預設 UA

「有效」有兩個條件:規則已啟用,且能產生合法、非空的 UA。已暫停的規則、不合法的 UA 與空的隨機候選池都會跳過。

3.1 網域如何比對

設定 example.com 時,以下主頁面會相符:

主頁面網域 相符?
example.com 是
www.example.com 是
shop.example.com 是
a.shop.example.com 是
otherexample.com 否
example.com.other.net 否
example.net 否

在網域欄位輸入 example.com;不要輸入 https://、路徑、查詢參數或連接埠。目前設定以網域為單位,而非以 URL 路徑為單位。

1.4.5 版沒有只比對該精確主機名稱並排除所有子網域的選項。如果只想影響 shop.example.com 分支,請輸入 shop.example.com,但仍會包含其子網域。

在目前版本中,相容寫法 *.example.com 也涵蓋 example.com 本身及其子網域,而不只是子網域。如果有效的 example.com 和 *.example.com 規則同時存在,前者優先;前者暫停時,後者可以接手。新使用者通常只需使用一般網域寫法。

3.2 暫停與移除的差別

操作或狀態 意思
暫停 保留設定,但暫時不參與比對;可再恢復
移除 刪除規則;需要時須重新建立
被覆蓋 規則仍已啟用,但目前頁面套用了優先順序更高的規則
無效 目前內容無法產生有效 UA;請修正內容或候選池

規則暫停或移除後,擴充功能會繼續尋找其他有效規則。因此,暫停不是強制頁面使用瀏覽器預設 UA 的排除規則。

例如,假設僅有三條已啟用且有效的規則:全域設為 UA-G、example.com 設為 UA-P、shop.example.com 設為 UA-C:

操作 開啟 shop.example.com 時的結果
三條規則均已啟用 UA-C
暫停子網域規則 UA-P
再暫停父網域規則 UA-G
再暫停全域規則 瀏覽器預設 UA
新增有效的分頁規則 UA-T 該分頁使用 UA-T

此處的 UA-G、UA-P、UA-C 和 UA-T 只是不同 UA 內容的代號。

04兩種隨機模式

4.1 每次頁面載入

每次主頁面完整網路載入時抽取一次,一般頁面內資源會重用該主頁面的結果。重新整理或完整導覽會再次抽取;圖片、API 和 iframe 等頁面內請求不會各自觸發新的主頁面抽取。

例如,假設候選池包含 UA-A、UA-B 和 UA-C:

操作 一種可能的結果
首次開啟頁面 主文件與一般資源使用 UA-A
頁面接著請求圖片與 API 仍為 UA-A
只有錨點或 SPA 頁面內路由改變 仍為 UA-A
重新整理頁面 再次抽取;可能使用 UA-C
完整導覽至另一個仍符合此規則的頁面 再次抽取;可能使用 UA-B

「再次抽取」不代表「一定得到不同的值」。同樣地,瀏覽器的上一頁或下一頁按鈕若直接還原快取文件,而沒有重新透過網路載入主文件,也不能直接視為重新抽取。

發生重新導向時,仍由目的地頁面決定適用規則。在同一次導覽且規則相同的情況下,不會在每一個重新導向步驟重複抽取;如果目的地網域符合不同規則,則改用該規則。

4.2 每個分頁

隨機結果按「規則 + 分頁」儲存。只要設定未變且分頁未關閉,重新整理及同一規則下的完整導覽都會繼續使用該結果。

例如,為 example.com 設定「每個分頁」隨機:

操作 一種可能的結果
分頁 1 開啟 example.com 此規則將 UA-A 綁定至分頁 1
分頁 1 重新整理或前往 shop.example.com,且沒有更具體的規則 繼續使用 UA-A
分頁 2 開啟 example.com 為分頁 2 儲存一個綁定;可能是 UA-B,也可能仍是 UA-A
分頁 1 前往沒有規則的 other.net,且沒有全域規則 使用瀏覽器預設 UA
分頁 1 返回 example.com 恢復此規則原本的 UA-A
關閉分頁 1 後再次開啟 原分頁的綁定會清除,可重新分配

若另有一條 shop.example.com 規則,即使兩條規則選取相同候選池,仍屬於不同規則,會分別儲存隨機綁定。修改規則參數或候選庫後,或瀏覽器重新啟動後,隨機結果可能重新分配。

4.3 作用範圍與模式的組合

下表說明規則取得主頁面優先權後的行為。固定模式包含內建 UA、自訂和附加文字。

作用範圍 固定模式 每次頁面載入時隨機 每個分頁隨機
全域 符合條件的頁面使用此規則的 UA 每次透過網路載入主頁面時抽取 每個分頁為此全域規則各自儲存綁定
網域 符合網域及其子網域的頁面使用此 UA 符合範圍內每次透過網路載入主頁面時抽取 每個分頁為此網域規則各自儲存綁定
分頁 此分頁使用此 UA,前往其他網站後亦然 此分頁每次透過網路載入主頁面時抽取 此分頁為該規則維持固定的隨機結果,重新整理及跨網站導覽後仍保留

在所有組合中,一般頁面內資源都會優先繼承主頁面 UA。隨機模式決定值的存續時間,不會改變規則優先順序。

05頁面內資源與資源網域備援

5.1 主頁面有規則時,資源優先繼承

假設存在以下規則:

  • shop.example.com → UA-Shop。
  • cdn.example.net → UA-CDN。

開啟 shop.example.com 且頁面載入 cdn.example.net/photo.png 時,圖片使用 UA-Shop。即使資源的目標網域有自己的規則,也不會覆蓋主頁面規則。這使主文件與一般頁面內資源使用相同的 UA。

若在新分頁的網址列直接開啟 cdn.example.net,它就成為主頁面網域,可以比對自己的 UA-CDN 規則。

5.2 備援開關何時生效

「更多操作」中的資源網域備援預設關閉。這是獨立的全域開關,適用於所有 UA 模式。

只有在主頁面沒有有效的分頁、網域或全域 UA 時才會生效,讓資源依自己的目標網域尋找有效網域規則。資源網域遵循相同邏輯:更具體的規則優先,子規則暫停時則繼承父規則。

主頁面有有效 UA 嗎? 開關 資源本身符合有效網域規則嗎? 一般資源的 UA
有 關閉或開啟 是或否 繼承主頁面 UA
沒有 關閉 是或否 瀏覽器預設 UA
沒有 開啟 是 資源網域規則產生的 UA
沒有 開啟 否 瀏覽器預設 UA

主頁面沒有有效規則時,其主文件仍使用瀏覽器預設 UA;資源備援不會反過來為主頁面指定值。有效的全域規則也算「主頁面有有效 UA」,因此全域規則會使資源備援無法接管一般資源。

5.3 備援範例

開啟 news.example.org,且沒有分頁規則、主頁面網域規則或全域規則。另有 cdn.example.net → UA-CDN:

請求 備援關閉 備援開啟
news.example.org 主文件 預設 UA 預設 UA
news.example.org/api API 預設 UA 預設 UA
cdn.example.net/app.js 預設 UA UA-CDN
img.cdn.example.net/photo.png 預設 UA UA-CDN,繼承自資源的父網域規則
other.net/font.woff,無相符規則 預設 UA 預設 UA

如果新增全域 UA-G,上述所有一般請求都由主頁面的 UA-G 控制,資源的 UA-CDN 不再接管。

5.4 備援與隨機模式

資源網域規則模式 允許備援時取得值的方式
固定模式 使用資源規則中設定的 UA
每次頁面載入時隨機 結果按「宿主頁面本次載入 + 資源規則」儲存;該次頁面載入中符合相同規則的資源共用此結果
每個分頁隨機 結果按「宿主分頁 + 資源規則」儲存;同一分頁重新整理後繼續使用

例如,如果 cdn.example.net 使用隨機模式,且 img.cdn.example.net 和 js.cdn.example.net 都繼承它,兩者便共用該綁定。如果 img.cdn.example.net 有自己的有效規則,它屬於另一條規則,可以使用不同的 UA。

其他造訪資源網域的分頁不會覆寫目前頁面已儲存的資源隨機綁定。開啟備援允許同一頁面上的不同資源規則使用不同 UA;若希望一般頁面整體保持一致,通常應維持關閉(預設值)。

06設定第一條規則

  1. 開啟要設定的網站,然後點擊工具列中的 UA Pro 圖示。
  2. 若有為目前網站設定規則的按鈕,請點擊該按鈕;也可透過「更多操作」建立新規則。
  3. 選擇作用範圍。若只想在目前分頁暫時測試,選擇「分頁」;若要套用至同一網站的多個分頁,選擇「網域」;若要作為所有網站的預設值,選擇「全域」。
  4. 若選擇網域,請檢查網域欄位。例如,你目前位於 www.example.com 並想包含 shop.example.com,請輸入 example.com。
  5. 選擇模式。「內建」請選擇瀏覽器或裝置;「自訂」請輸入完整 UA;「附加文字」只輸入要附加的文字;「隨機」請選擇候選池與隨機模式。
  6. 在「確認並套用」中檢查範圍與內容,然後點擊「套用」或「儲存並套用」。等待「規則已儲存並啟用」確認訊息。
  7. 重新整理網頁,並檢查首頁顯示的目前生效規則。既有頁面必須重新整理,主文件與指令碼才會一同採用新的 UA。

在規則清單中可編輯、暫停、恢復或移除規則。被其他規則覆蓋的規則仍已啟用,但目前沒有優先權;暫停的規則不參與比對。若出現沒有有效 UA 的警告,請檢查自訂內容或隨機候選池。

自訂 UA 應為單行且有效的請求標頭內容,不得包含換行或控制字元。新的自訂內容或附加文字可依類別儲存至清單,以供日後選取或作為隨機候選項。

07啟用 UA 浮動面板

開啟 更多操作 並啟用 UA 浮動面板。此功能預設關閉,可顯示於可存取的 HTTP/HTTPS 頁面上。

頁面 UA:頁面 JavaScript 從 navigator.userAgent 讀取的值。

請求 UA:瀏覽器觀察到的此主文件請求 User-Agent。

這顯示瀏覽器網址列中目前頁面的 UA,不包含圖片、指令碼、API 或其他資源(例如 CDN 資源)請求的 UA。

若兩個值都可取得且完全相同,會顯示在同一行;否則分開顯示。

若頁面載入後才開啟視窗,請重新整理頁面以擷取其主要請求。無法取得請求時,視窗會顯示該狀態,而不會使用設定值替代。

拖曳控制柄或標籤可移動視窗。拖曳左側或右側邊框可調整寬度,拖曳上方或下方邊框可調整高度。按兩下邊框只會恢復該方向的自動大小。半圓按鈕可調整背景不透明度。關閉按鈕會在所有頁面關閉此視窗。

若 User-Agent 很長,在窄視窗中會自動換行。需要時視窗會變高;若文字高於螢幕,請在視窗內捲動。手動設定的寬度和高度會保留至重設為止。

載入新頁面的值時,視窗會盡量保持相同大小。它會顯示載入中佔位內容,絕不顯示上一頁的值。完整導覽會重新建立頁面,因此視窗可能短暫消失。

變更規則不會改變已載入的頁面或其原始請求傳送的標頭。請重新整理以檢查新規則。代理伺服器或伺服器可能在瀏覽器觀察後變更請求標頭。此視窗無法顯示於受保護的瀏覽器頁面或瀏覽器擴充功能商店。

更多操作 選單也包含 新手使用指南;點擊該選單底部的 UA Pro 可開啟網站。

08如何設定常見用途

目標 設定方式 注意事項
只在目前分頁試用行動裝置 UA 分頁 + 內建行動裝置 UA 該分頁前往其他網站時仍適用;關閉後停止
在整個網站使用固定 UA 網域 example.com + 內建 UA 或自訂 包含所有子網域;也適用於其他分頁
為商店子網站使用不同的 UA 保留父規則並新增 shop.example.com 規則 若沒有更高優先順序的規則,子規則優先;暫停子規則後,父規則可以接手
所有網站預設使用一個 UA,某個網站例外 全域設定 UA-G,目標網域設定 UA-D 沒有其他更高優先順序規則適用時,目標網域使用 UA-D,其他頁面使用 UA-G
每次重新整理時重新隨機選取網站的 UA 網域 + 隨機 UA + 每次頁面載入 該次頁面載入的資源共用結果;抽取結果可能重複
讓網站的 UA 在每個分頁中保持穩定 網域 + 隨機 UA + 每個分頁 每條規則在每個分頁中分別儲存綁定
僅按目標網域為外部資源設定 UA 建立資源網域規則並開啟資源備援 宿主頁面不得有有效的分頁、網域或全域 UA
暫時停用子網域規則 點擊暫停 頁面使用剩餘有效規則中優先順序最高的一條,例如分頁規則、其他相符的網域規則或全域規則。若均不適用,則使用瀏覽器預設 UA

09備份與遷移

「更多操作」中的匯入與匯出功能可備份或遷移全域規則、網域規則、自訂庫、附加文字庫及資源網域備援開關。

分頁規則與已抽取的隨機綁定不屬於此持久設定匯出內容。匯入不會重建原本的分頁或其隨機狀態。

可匯入本機設定檔,或從遠端設定網址載入並確認匯入。請先匯出備份。匯入內容提供的全域規則、網域規則、自訂庫或附加文字庫物件,會取代各自對應的部分。這四部分中任何一部分缺失或為 null 時,該部分現有值保持不變;尤其是全域規則為 null 不會清除現有全域規則。資源網域備援僅在其欄位為 true 時啟用;否則(包括欄位缺失或為 null)匯入後均為關閉。

在 1.4.5 中,舊版隨機模式 domain 視為「每次頁面載入」;未指定隨機策略的舊版隨機規則視為「每個分頁」。遷移後請在介面中檢查所需隨機模式。

10常見問題與使用限制

問題 說明
為什麼儲存後頁面仍顯示舊 UA? 既有文件不會重新載入;儲存成功後請重新整理。也請檢查是否被更高優先順序的規則覆蓋
為什麼暫停子規則後仍使用自訂 UA? 有效的分頁規則仍可能優先。否則,其他相符的網域規則或全域規則可能接手。變更規則後請重新整理頁面並檢查生效規則
為什麼資源網域規則沒有生效? 先檢查主頁面是否已有有效 UA,再檢查資源備援是否開啟,最後檢查資源網域規則是否有效
為什麼重新整理後隨機值沒有改變? 每個分頁模式依設計會保留該值;每次載入頁面模式也可能再次抽到相同值
為什麼同時開啟的分頁有相同 UA? 隨機值可能重複;並行的首次導覽也可能共用一個預先抽取的備用值
切換成行動裝置 UA 後,為什麼頁面看起來仍像桌面網站? 網站也可能依賴螢幕大小、Client Hints 或其他資訊;只變更 UA 不保證頁面版面會改變

並行的首次導覽採用保留瀏覽器原生導覽的方式:多個新分頁同時直接開啟網址,且第一個封包在專用規則安裝前送出時,可能使用相同的預先抽取 UA;之後每個分頁各自儲存綁定。擴充功能不加入導覽中繼,也不會將原生表單 POST 改成其他導覽方式。

本功能主要針對一般 HTTP/HTTPS 頁面及其資源。共用 Service Worker 請求不一定能歸屬於單一分頁;此版本尚未完整實作 Client Hints、Worker 內的 navigator 及無網路文件 iframe 的 UA 同步。此變更也尚未實作保留網站原本的 Server-Timing。請勿將修改 UA 視為完整的瀏覽器指紋偽裝。

1.4.5 使用 webRequest 和 webNavigation 權限追蹤主頁面導覽及實際傳送的 UA。它不使用封鎖請求權限,也不使用偵錯器權限。

11版本驗證與參考資料

1.3.0 的最終驗證環境是在 Windows Edge 157.0.4341.42 的隔離測試設定檔中,使用本機 HTTP/HTTPS 網站。完整 HTTPS 執行通過 128 個案例、2527 個斷言;HTTP 邊界回歸測試通過 5 個案例、441 個斷言。這些驗證了上述規則組合及所述並行邊界,並不代表涵蓋所有瀏覽器版本與網站。

1.4.5 版的視窗已在隔離的 Chrome 與 Edge 設定檔中,以本機 HTTPS 頁面測試。測試涵蓋導覽、將相同的頁面 UA 和請求 UA 合併為一行、調整大小與延遲讀取,但未涵蓋所有網站。

詳細測試紀錄保存在專案資料中。請在 Chrome 線上應用程式商店或離線下載頁面確認可安裝版本;提供的版本可能與本指南不同。