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