chrome_client

基于 Chromium 网络栈的 HTTP/WebSocket 客户端。Core 负责 TLS、HTTP、HTTP/2、 HTTP/3/QUIC、代理和 WebSocket/WSS；Python/Rust 绑定只负责参数、类型、错误和生命周期转换，不另实现一套网络协议。兼容requests和curl-cffi。

English README · 构建说明 · 兼容边界

支持范围

操作系统、架构与绑定

操作系统	Core 目标	Python 3.7–3.13	Python 3.6	Rust	备注
Linux	x86 (`i686`)、x86_64、ARM64	✓	✓（独立 abi3 扩展）	✓	manylinux/glibc 运行时依赖见 manifest
Windows	x86、x86_64、ARM64	✓	x86/x86_64 ✓	✓	DLL 随 wheel，包含 `icudtl.dat`
macOS	x86_64、ARM64	✓	✓（独立 abi3 扩展）	✓	dylib 按架构匹配

每个 Core 产物位于 core/binaries/<target>/，带 ABI 版本、Chromium revision、 SHA-256 和依赖清单。ABI 当前为 v7。Go 和 Node.js 目录目前是绑定设计说明，不是已发布的可安装包。

Core 目录	Rust target	Core 文件
`linux-x86`	`i686-unknown-linux-gnu`	`libminicronet.so`
`linux-x86_64`	`x86_64-unknown-linux-gnu`	`libminicronet.so`
`linux-arm64`	`aarch64-unknown-linux-gnu`	`libminicronet.so`
`windows-x86`	`i686-pc-windows-msvc`	`minicronet.dll` + `minicronet.lib`
`windows-x86_64`	`x86_64-pc-windows-msvc`	`minicronet.dll` + `minicronet.lib`
`windows-arm64`	`aarch64-pc-windows-msvc`	`minicronet.dll` + `minicronet.lib`
`macos-x86_64`	`x86_64-apple-darwin`	`libminicronet.dylib`
`macos-arm64`	`aarch64-apple-darwin`	`libminicronet.dylib`

Chrome profile

impersonate 推荐使用精确的 chrome_<major> 名称（同时接受 curl-cffi 风格的 chrome<major> 别名）。当前支持 Chrome 99–151，共 53 个 profile；没有列出的版本会被拒绝，不会静默降级到当前版本。

Chrome 主版本	可用 profile
99–105	`chrome_99` … `chrome_105`
106–112	`chrome_106` … `chrome_112`
113–119	`chrome_113` … `chrome_119`
120–126	`chrome_120` … `chrome_126`
127–133	`chrome_127` … `chrome_133`
134–140	`chrome_134` … `chrome_140`
141–147	`chrome_141` … `chrome_147`
148–151	`chrome_148`、`chrome_149`、`chrome_150`、`chrome_151`

Profile 影响 TLS ClientHello、ALPN、HTTP/2 设置、QUIC/H3 和相关 Chromium 网络参数；它不是完整 Chrome 浏览器，也不包含 Blink、扩展、Service Worker 或持久化浏览器 Profile。

功能矩阵

功能	Python	Rust/Core	说明
HTTP/1.1、HTTP/2、HTTP/3/QUIC	✓	✓	默认由 Chromium 协商；Rust 可强制 H1/H2/H3
HTTPS/TLS、证书校验	✓	✓	`verify=False` 仅在明确需要时使用
HTTP/HTTPS/SOCKS 代理	✓	✓	Python 支持 `proxy` 和 Requests 风格 `proxies`
同步请求	✓	✓	同步等待释放 GIL
asyncio 请求	✓	—	Core 回调唤醒事件循环，不创建请求线程池
流式响应	`iter_content` / `aiter_bytes`	`ResponseStream`	每请求 body 队列上限 1MiB
取消、超时、大小限制	✓	✓	`Timeout`、`ResponseTooLarge`、`RequestException`
WebSocket / WSS	✓	✓	同步 `recv` 与异步 `recv`
Cookie、内存缓存、重定向、上传	✓	✓	Cookie/cache 随 Engine 生命周期存在

Python 使用示例

同步 GET、参数、请求头和 JSON

import chrome_client

response = chrome_client.get(
    "https://example.com/api",
    params={"page": 1},
    headers={"Accept": "application/json"},
    impersonate="chrome_151",
    timeout=15,
)
response.raise_for_status()
print(response.status_code, response.json())

其他 Requests 风格方法使用同一组参数：

with chrome_client.Client() as client:
    client.head("https://example.com/resource")
    client.options("https://example.com/resource")
    client.post("https://example.com/items", json={"name": "demo"})
    client.put("https://example.com/items/1", data=b"raw body")
    client.patch("https://example.com/items/1", json={"name": "new"})
    client.delete("https://example.com/items/1")
    client.get("https://example.com/redirect", allow_redirects=False)

Client/Session、Cookie、代理和证书校验

from chrome_client import Client

with Client(cookies={"session": "abc"}, timeout=10) as client:
    response = client.get(
        "https://example.com/private",
        proxies={"https": "http://127.0.0.1:8080"},
        verify=True,
    )
    print(response.text)

显式 proxy="http://..." 优先于 proxies；proxies 按 http、https、all 键选择。

client.cookies 是 CookieJar（dict 子类），支持 Requests 风格的 get_dict()：

with Client(cookies={"session": "abc"}) as client:
    client.cookies["extra"] = "1"
    print(client.cookies.get_dict())   # {'session': 'abc', 'extra': '1'}

它只包含调用方为出站请求配置的 cookie。响应返回的 cookie 由 Core 内的 Chromium CookieStore 拥有，ABI v7 不导出该存储，因此不会出现在这个 jar 里，也不需要在 Python 侧重复附加。jar 没有 domain/path 元数据，get_dict(domain=...) 或 get_dict(path=...) 会抛 ValueError 而不是返回未过滤的数据。

asyncio 并发

import asyncio
from chrome_client import AsyncClient

async def main():
    async with AsyncClient(impersonate="chrome_151") as client:
        responses = await asyncio.gather(*[
            client.get("https://example.com") for _ in range(32)
        ])
        print([r.status_code for r in responses])

asyncio.run(main())

流式读取、大小限制和取消

from chrome_client import Client, ResponseTooLarge

with Client() as client:
    response = client.get("https://example.com/large", stream=True,
                          max_response_bytes=16 * 1024 * 1024)
    try:
        total = 0
        for chunk in response.iter_content(64 * 1024):
            total += len(chunk)
        print("bytes:", total)
    finally:
        response.close()       # 未读完时取消 native 请求

异步流使用 async for chunk in response.aiter_bytes()，使用完毕调用 await response.aclose()。超过 max_response_bytes 会取消请求并抛出 ResponseTooLarge。

WebSocket / WSS

from chrome_client import WebSocket

with WebSocket("wss://echo.example.com", impersonate="chrome_151") as socket:
    socket.send("ping")
    print(socket.recv())

import asyncio
from chrome_client import AsyncClient

async def main():
    client = AsyncClient(impersonate="chrome_151")
    socket = await client.websocket("wss://echo.example.com")
    try:
        await socket.send("ping")
        print(await socket.recv())
    finally:
        await socket.close()
        await client.aclose()

asyncio.run(main())

超时与错误处理

import chrome_client

try:
    chrome_client.get("https://example.com", timeout=0.5)
except chrome_client.Timeout:
    print("request timed out")
except chrome_client.RequestException as error:
    print("request failed:", error)

Requests 与 curl-cffi 语法兼容

常用调用参数与 Requests/curl-cffi 对齐，可直接迁移大多数简单 GET/POST 代码：

语法/参数	支持情况
`get/post/put/delete`、`Client`、`Session`	✓；`Session` 等价于 `Client`
`params`、`headers`、`cookies`、`data`、`json`	✓
`timeout`、`verify`、`proxies`、`proxy`	✓
`impersonate="chrome_151"`	✓，使用本项目 Chromium profile
`stream=True`、`iter_content`	✓；异步使用 `aiter_bytes`
`session.cookies.get_dict()`	✓；只返回已配置的出站 cookie，不含响应 cookie
`curl_options`、`ja3`、`akamai`、libcurl 句柄	✗
Requests 的全部插件/适配器/持久化 Cookie 功能	✗

这不是 curl_cffi.requests 的替代导入：请将 from curl_cffi import requests 改为 from chrome_client import requests，并确认响应流、异常类型和 WebSocket 接口按本 README 使用。两者都可接受常见的 impersonate、代理和超时参数，但 profile 覆盖范围、TLS 行为和底层连接池由各自实现决定。

目录与验证

路径	内容
`core/abi/`	稳定 C ABI v7
`core/binaries/`	8 个已审计平台 Core
`crates/minicronet/`	Rust 安全层、流和生命周期
`bindings/python/`	Python 3.7–3.13 绑定与 facade
`bindings/python36/`	Python 3.6 独立 abi3 绑定
`docs/`	构建、平台、ABI、兼容性和审计说明

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

chrome_client-0.2.1.1-cp37-abi3-win_arm64.whl (10.0 MB view details)

Uploaded Sep 2, 2026 CPython 3.7+Windows ARM64

chrome_client-0.2.1.1-cp37-abi3-win_amd64.whl (10.8 MB view details)

Uploaded Sep 2, 2026 CPython 3.7+Windows x86-64

chrome_client-0.2.1.1-cp37-abi3-win32.whl (10.0 MB view details)

Uploaded Sep 2, 2026 CPython 3.7+Windows x86

chrome_client-0.2.1.1-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (5.7 MB view details)

Uploaded Sep 2, 2026 CPython 3.7+manylinux: glibc 2.17+ x86-64

chrome_client-0.2.1.1-cp37-abi3-manylinux_2_17_i686.manylinux2014_i686.whl (5.8 MB view details)

Uploaded Sep 2, 2026 CPython 3.7+manylinux: glibc 2.17+ i686

chrome_client-0.2.1.1-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (5.4 MB view details)

Uploaded Sep 2, 2026 CPython 3.7+manylinux: glibc 2.17+ ARM64

chrome_client-0.2.1.1-cp37-abi3-macosx_13_0_x86_64.whl (4.9 MB view details)

Uploaded Sep 2, 2026 CPython 3.7+macOS 13.0+ x86-64

chrome_client-0.2.1.1-cp37-abi3-macosx_13_0_arm64.whl (4.3 MB view details)

Uploaded Sep 2, 2026 CPython 3.7+macOS 13.0+ ARM64

chrome_client-0.2.1.1-cp36-abi3-win_amd64.whl (10.5 MB view details)

Uploaded Sep 2, 2026 CPython 3.6+Windows x86-64

chrome_client-0.2.1.1-cp36-abi3-win32.whl (9.8 MB view details)

Uploaded Sep 2, 2026 CPython 3.6+Windows x86

chrome_client-0.2.1.1-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (5.6 MB view details)

Uploaded Sep 2, 2026 CPython 3.6+manylinux: glibc 2.17+ x86-64

chrome_client-0.2.1.1-cp36-abi3-manylinux_2_17_i686.manylinux2014_i686.whl (5.8 MB view details)

Uploaded Sep 2, 2026 CPython 3.6+manylinux: glibc 2.17+ i686

chrome_client-0.2.1.1-cp36-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (5.4 MB view details)

Uploaded Sep 2, 2026 CPython 3.6+manylinux: glibc 2.17+ ARM64

chrome_client-0.2.1.1-cp36-abi3-macosx_13_0_x86_64.whl (4.8 MB view details)

Uploaded Sep 2, 2026 CPython 3.6+macOS 13.0+ x86-64

chrome_client-0.2.1.1-cp36-abi3-macosx_13_0_arm64.whl (4.3 MB view details)

Uploaded Sep 2, 2026 CPython 3.6+macOS 13.0+ ARM64

File details

Details for the file chrome_client-0.2.1.1-cp37-abi3-win_arm64.whl.

File metadata

Download URL: chrome_client-0.2.1.1-cp37-abi3-win_arm64.whl
Upload date: Sep 2, 2026
Size: 10.0 MB
Tags: CPython 3.7+, Windows ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for chrome_client-0.2.1.1-cp37-abi3-win_arm64.whl
Algorithm	Hash digest
SHA256	`dc19a16749103553cdf860b4da4843c6ce4e9bd3532634f53f2c79944c7248ee`
MD5	`192bc242e803f27bb9d8dbe2afee687f`
BLAKE2b-256	`11c93844cfdee8487bade254f58fed156606c4e1a5e817bbd2b588794e971558`

Algorithm	Hash digest
SHA256	`b9a59a7a232d181b5d2e73f12baa0c6aede90519719c0b94f5b2707f5f9164b9`
MD5	`f782c22affccabc00137189b903c6c0c`
BLAKE2b-256	`0aae7e6dd73711d558f9cd83d8c31c8581e856aeec30ffb97d3fe402861870c6`

Algorithm	Hash digest
SHA256	`5184e574773ed7e8b33807259d52b2d0e9a7cf7809cc0152dd1c027cb8c5375e`
MD5	`a1b64cbd9d2e6be1a62259a16f93590e`
BLAKE2b-256	`0159030c6bc6a3fec8e1bf9539f1275d248a8513da6b57a0788fd62aea464e92`

Algorithm	Hash digest
SHA256	`9fc5ad0793b5005c8824fe84b728cfb7e931c6ef56120203bdfed8bb5de9ba18`
MD5	`80495d371d3232c35b88aaac43a2d159`
BLAKE2b-256	`647048c81b8f0e4f8ff7137085d1093f7778e48402bd3c41c45f4add72514a9b`

Algorithm	Hash digest
SHA256	`fcad2db96c3c0453c549e08a49025fc6089d065f8e34ad02d4523bd0d35e3d2b`
MD5	`b35c3a61da980cbd0c18b564b6a3fc94`
BLAKE2b-256	`3f5f5662db63c8f6c1c674858d7e59a7bcd8f34c90e48c90c33fe32c317c007e`

Algorithm	Hash digest
SHA256	`c2d1f67e3aa9003955d814c7d44f688ab89a679f75fcbb9ca3812d2702a0ecb7`
MD5	`c434bac5604fea24e888dc509be2f003`
BLAKE2b-256	`d4345f15d797ceb9fcb0ea46a5cfb3df42ff596eb4be9a5161a876c50c976023`

Algorithm	Hash digest
SHA256	`e008ac3d76911462bd4533d3eb599bd6a8f2b38495a32319808b90c54c9dd05b`
MD5	`2cb567b702c19ab74d301138be0d792e`
BLAKE2b-256	`836dd372d3ba21b7d9331590da6b2e2c30622110b77bada978c791b474e73686`

Algorithm	Hash digest
SHA256	`0f24b63197935ad6d53129745151101af85e223ee4f937af4e2916d777c23eb2`
MD5	`46e140126c08e14de52834abb76843c5`
BLAKE2b-256	`c02909ab3cc650153c7f3b73011e6263976e63670fe407164efaf5eaf7b1e611`

Algorithm	Hash digest
SHA256	`9ab1024c336083851ed5cbb080d34139e33d56e4efa537216d3b68868ca1e4dc`
MD5	`d9502b635c6f9fd95f3d90aa954d1e9a`
BLAKE2b-256	`a473ed3079f7f0802454db2827d50cca8ea4d18a656c74e949bf2af9d15fe7f5`

Algorithm	Hash digest
SHA256	`85b4e20183ba45b9dacf3a8722e4c25c6e5f1cb933718981137aa6541d9b9b04`
MD5	`5496e7288559e5f66ef74ce3fe57e385`
BLAKE2b-256	`27d4f5d2de6175d4f303ee4f12f14b2659ce2500ad25968736e9e3df736a0353`

Algorithm	Hash digest
SHA256	`bd37951739f6d128714a38b6b8e927298cf61e25daf7d3378e7790bc9c1a47b5`
MD5	`29479a868884ce58a0a4f84f84a8940f`
BLAKE2b-256	`c962efbdef231e7028c3f0891bcc877ac74be890b45b83bbba8521eb873d83ef`

Algorithm	Hash digest
SHA256	`ed8887290fdc39cdf01c003b4ce0cb1c85c5a9efc9e6336bd8c12da6dd3b90ee`
MD5	`95243c46346bb5f100b5daf3b671272c`
BLAKE2b-256	`e583a5b8a09ecd41ee397fc79898d651938f484f9f818d5b842ae50f20231462`

Algorithm	Hash digest
SHA256	`8190a4616031a79160855da6ee19c5885381ac746a91ae9574aca67bdc3edcf1`
MD5	`cf74c9f0e869f6159707f0d3ee37dc45`
BLAKE2b-256	`13be56d4d5cda29c8c416d2f6bec6bb50a766f32f90454a6db6789891f67dbdd`

Algorithm	Hash digest
SHA256	`e6b567818c45aabced54236cb6bbd3fba7d9b73cffa448367690a51115888003`
MD5	`09976e975d01ff9fc72b300a447592a3`
BLAKE2b-256	`61cf3643520e95071f0db17c4c61736efa7861e275e650cb46e317e3580e1922`

Algorithm	Hash digest
SHA256	`ee4511e87fa148526fbf4e871c0707af77cad821f88f6f241f0aeb38e0b90988`
MD5	`c2d2ae238b10b79d27e7008f7867ed74`
BLAKE2b-256	`220d3d18153d624e903c4baf7db11672445d0b406ec261c7ddd72b9ef92be575`

chrome-client 0.2.1.1

chrome_client

支持范围

操作系统、架构与绑定

Chrome profile

功能矩阵

Python 使用示例

同步 GET、参数、请求头和 JSON

Client/Session、Cookie、代理和证书校验

asyncio 并发

流式读取、大小限制和取消

WebSocket / WSS

超时与错误处理

Requests 与 curl-cffi 语法兼容

目录与验证

Project links

Key dates

1 maintainer

GitHub Statistics

License

Requires

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance