Noble TLS 使用教程

Noble TLS 使用教程

noble-tlsA sophisticated asynchronous HTTP library, based on requests and tls-client. Automatically updates JA3 fingerprints.项目地址:https://gitcode.com/gh_mirrors/no/noble-tls

1、项目介绍

Noble TLS 是一个基于 requests 和 tls-client 的高级异步 HTTP 库。它提供了自动更新 JA3 指纹的功能，支持异步操作、代理、自定义 JA3 字符串、自定义 H2 设置等多种高级特性。Noble TLS 的设计灵感来源于 requests，因此其语法与 requests 非常相似，使用起来非常方便。

2、项目快速启动

安装

首先，你需要安装 Noble TLS 库。你可以通过 pip 进行安装：

pip install noble-tls

基本使用

以下是一个简单的示例，展示了如何使用 Noble TLS 进行基本的 HTTP GET 请求：

import noble_tls
from noble_tls import Client

async def main():
    await noble_tls.update_if_necessary()  # 更新 TLS 客户端库
    session = noble_tls.Session(client=Client.CHROME_111, random_tls_extension_order=True)
    res = await session.get("https://example.com/", headers={"key1": "value1"}, proxy="http://user:password@host:port")
    print(res.text)

# 运行主函数
import asyncio
asyncio.run(main())

3、应用案例和最佳实践

应用案例

Noble TLS 可以用于各种需要高级 HTTP 功能的场景，例如爬虫、API 调用、自动化测试等。以下是一个使用自定义 JA3 字符串的示例：

import noble_tls

async def main():
    await noble_tls.update_if_necessary()  # 更新 TLS 客户端库
    session = noble_tls.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}
    )
    res = await session.get("https://example.com/")
    print(res.text)

# 运行主函数
import asyncio
asyncio.run(main())

最佳实践

• 自动更新：使用 await noble_tls.update_if_necessary() 确保 TLS 客户端库始终是最新的。
• 自定义设置：根据需要自定义 JA3 字符串、H2 设置等，以满足特定需求。
• 错误处理：在实际应用中，建议添加错误处理逻辑，以应对网络请求中可能出现的各种异常情况。

4、典型生态项目

Noble TLS 可以与其他 Python 生态项目结合使用，例如：

• Scrapy：结合 Scrapy 进行更高效的网页抓取。
• FastAPI：在 FastAPI 项目中使用 Noble TLS 进行外部 API 调用。
• Selenium：与 Selenium 结合，进行更复杂的自动化测试。

通过这些生态项目的结合，可以进一步扩展 Noble TLS 的应用场景，提升开发效率和功能丰富性。

noble-tlsA sophisticated asynchronous HTTP library, based on requests and tls-client. Automatically updates JA3 fingerprints.项目地址:https://gitcode.com/gh_mirrors/no/noble-tls