User-Agent header

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

HTTP User-Agent 請求頭是一個特徵字串,讓伺服器和網路對等方識別發出請求的使用者代理的應用程式、作業系統、供應商和/或版本。

警告: 有關向不同瀏覽器提供不同內容通常是壞主意的原因,請參閱使用使用者代理進行瀏覽器檢測

頭型別 請求頭
禁止請求頭

語法

http
User-Agent: <product> / <product-version> <comment>

Web 瀏覽器通用格式

http
User-Agent: Mozilla/5.0 (<system-information>) <platform> (<platform-details>) <extensions>

指令

<product>

產品識別符號 — 它的名稱或開發代號。

<product-version>

產品的版本號。

<comment>

包含更多詳細資訊的零個或多個註釋。例如,子產品資訊。

Firefox UA 字串

有關基於 Firefox 和 Gecko 的使用者代理字串的更多資訊,請參閱Firefox 使用者代理字串參考。Firefox 的 UA 字串分為 4 個部分

Mozilla/5.0 (platform; rv:gecko-version) Gecko/gecko-trail Firefox/firefox-version
  1. Mozilla/5.0 是表示瀏覽器與 Mozilla 相容的通用令牌。出於歷史原因,幾乎所有瀏覽器今天都發送它。
  2. platform 描述了瀏覽器執行的原生平臺(Windows、Mac、Linux、Android 等)以及它是否是手機。Firefox OS 手機顯示 Mobile —— 網路就是平臺。請注意,platform 可以由多個 ; 分隔的令牌組成。有關更多詳細資訊和示例,請參見下文。
  3. rv:gecko-version 指示 Gecko 的釋出版本(例如“17.0”)。在最近的瀏覽器中,gecko-versionfirefox-version 相同。
  4. Gecko/gecko-trail 指示瀏覽器基於 Gecko。(在桌面上,gecko-trail 始終是固定字串 20100101。)
  5. Firefox/firefox-version 指示瀏覽器是 Firefox 並提供版本(例如“17.0”)。

示例

Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0
Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0) Gecko/20100101 Firefox/42.0

Chrome UA 字串

Chrome(或基於 Chromium/Blink 引擎)的使用者代理字串與 Firefox 的類似。為了相容性,它添加了諸如 KHTML, like GeckoSafari 等字串。

示例

Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36

Opera UA 字串

Opera 瀏覽器也基於 Blink 引擎,這就是為什麼它看起來幾乎與 Chrome UA 字串相同,但添加了 "OPR/<version>"

示例

Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.106 Safari/537.36 OPR/38.0.2220.41

舊的、基於 Presto 的 Opera 版本使用

Opera/9.80 (Macintosh; Intel Mac OS X; U; en) Presto/2.2.15 Version/10.00
Opera/9.60 (Windows NT 6.0; U; en) Presto/2.1.1

Microsoft Edge UA 字串

Edge 瀏覽器也基於 Blink 引擎。它添加了 "Edg/<version>"

示例

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36 Edg/91.0.864.59

Safari UA 字串

在此示例中,使用者代理字串是移動 Safari 的版本。它包含單詞 "Mobile"

示例

Mozilla/5.0 (iPhone; CPU iPhone OS 13_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.1.1 Mobile/15E148 Safari/604.1

爬蟲和機器人 UA 字串

示例

Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)
Mozilla/5.0 (compatible; YandexAccessibilityBot/3.0; +http://yandex.com/bots)

庫和網路工具 UA 字串

示例

curl/7.64.1
PostmanRuntime/7.26.5

規範

規範
HTTP 語義
# field.user-agent

瀏覽器相容性

另見