Skip to content
Client Plugin

用户代理

UserAgent 插件会为所有 请求 添加 User-Agent 请求头。

添加依赖项

UserAgent 仅需要 ktor-client-core 构件,不需要任何特定的依赖项。

安装并配置 UserAgent

要安装 UserAgent,请在 客户端配置块 内将其传递给 install 函数。然后,使用 agent 属性来指定 User-Agent 值:

kotlin
import io.ktor.client.*
import io.ktor.client.engine.cio.*
import io.ktor.client.plugins.*
// ...
val client = HttpClient(CIO) {
    install(UserAgent) {
        agent = "Ktor client"
    }
}

Ktor 还允许你使用相应的函数添加类似浏览器或 curl 的 User-Agent 值:

kotlin
val client = HttpClient(CIO) {
    BrowserUserAgent()
    // ... or
    CurlUserAgent()
}