Python-TLS-Client

Python-TLS-Client 是一个基于 requests 和 tls-client 的高级 HTTP 库。

安装

pip install tls-client

示例

语法灵感来源于 requests，因此非常相似，只有极少数不同之处。

示例 1 - 预设：

import tls_client
You can also use the following as client_identifier:
Chrome --> chrome_103, chrome_104, chrome_105, chrome_106, chrome_107, chrome_108, chrome109, Chrome110,
           chrome111, chrome112, chrome_116_PSK, chrome_116_PSK_PQ, chrome_117, chrome_120
Firefox --> firefox_102, firefox_104, firefox108, Firefox110, firefox_117, firefox_120
Opera --> opera_89, opera_90
Safari --> safari_15_3, safari_15_6_1, safari_16_0
iOS --> safari_ios_15_5, safari_ios_15_6, safari_ios_16_0
iPadOS --> safari_ios_15_6
Android --> okhttp4_android_7, okhttp4_android_8, okhttp4_android_9, okhttp4_android_10, okhttp4_android_11,
            okhttp4_android_12, okhttp4_android_13
#
more client identifiers can be found in settings.py
session = tls_client.Session(
    client_identifier="chrome112",
    random_tls_extension_order=True
)
res = session.get(
    "https://www.example.com/",
    headers={
        "key1": "value1",
    },
    proxy="http://user:password@host:port"
)

示例 2 - 自定义：

import tls_client
session = tls_client.Session(
    ja3_string="771,4865-4866-4867-49195-49199-49196-49200-52393-52392-49171-49172-156-157-47-53,0-23-65281-10-11-35-16-5-13-18-51-45-43-27-17513,29-23-24,0",
    h2_settings={
        "HEADER_TABLE_SIZE": 65536,
        "MAX_CONCURRENT_STREAMS": 1000,
        "INITIAL_WINDOW_SIZE": 6291456,
        "MAX_HEADER_LIST_SIZE": 262144
    },
    h2_settings_order=[
        "HEADER_TABLE_SIZE",
        "MAX_CONCURRENT_STREAMS",
        "INITIAL_WINDOW_SIZE",
        "MAX_HEADER_LIST_SIZE"
    ],
    supported_signature_algorithms=[
        "ECDSAWithP256AndSHA256",
        "PSSWithSHA256",
        "PKCS1WithSHA256",
        "ECDSAWithP384AndSHA384",
        "PSSWithSHA384",
        "PKCS1WithSHA384",
        "PSSWithSHA512",
        "PKCS1WithSHA512",
    ],
    supported_versions=["GREASE", "1.3", "1.2"],
    key_share_curves=["GREASE", "X25519"],
    cert_compression_algo="brotli",
    pseudo_header_order=[
        ":method",
        ":authority",
        ":scheme",
        ":path"
    ],
    connection_flow=15663105,
    header_order=[
        "accept",
        "user-agent",
        "accept-encoding",
        "accept-language"
    ]
)
res = session.post(
    "https://www.example.com/",
    headers={
        "key1": "value1",
    },
    json={
        "key1": "key2"
    }
)

Pyinstaller / Pyarmor

如果您想使用 Pyinstaller 或 Pyarmor 打包库，请确保在命令中添加以下内容：

Linux - Ubuntu / x86:

--add-binary '{path_to_library}/tls_client/dependencies/tls-client-x86.so:tls_client/dependencies'

Linux Alpine / AMD64：

--add-binary '{path_to_library}/tls_client/dependencies/tls-client-amd64.so:tls_client/dependencies'

MacOS M1 及更早版本：

--add-binary '{path_to_library}/tls_client/dependencies/tls-client-x86.dylib:tls_client/dependencies'

MacOS M2:

--add-binary '{path_to_library}/tls_client/dependencies/tls-client-arm64.dylib:tls_client/dependencies'

Windows：

--add-binary '{path_to_library}/tls_client/dependencies/tls-client-64.dll;tls_client/dependencies'

致谢

特别感谢 Bogdanfinn 开源他的 Golang 版本的 tls-client。 另外，我希望语法尽可能与 requests 保持相似，因为大多数人使用并熟悉它！

--- Tranlated By Open Ai Tx | Last indexed: 2026-02-19 ---