ruyihttp

Requests 风格的 Python HTTP 客户端，使用 Firefox NSS / Necko 原生网络能力。 一条 pip install 即可安装，支持 HTTP/1.1、HTTP/2、HTTP/3、会话、代理和流式请求，无需启动浏览器。

保留你熟悉的 get()、post()、Session 和 Response 用法，通过 Python 接口调用随包附带的原生 DLL。 适合接口调用、数据采集、会话维护，以及需要 NSS TLS 连接的 Python 项目。

pip install -U ruyihttp

import ruyihttp as requests

response = requests.get("https://example.com", timeout=30)
response.raise_for_status()
print(response.text)

快速开始 · 常用功能 · 更多用法 · 赞助商 · 问题反馈

赞助商

想出现在这里？

FastAIToken FastAIToken 是面向开发者的 AI API 聚合平台，支持 OpenAI、Claude、Gemini，以及 DeepSeek、GLM、Kimi 等模型。提供多种模型渠道、公开状态页及 7×24 小时真人技术支持。渠道价格与活动以平台页面为准。 注册与了解详情：http://www.fastaitoken.com/register

快速开始

需要 Windows x64 和 64 位 Python 3.10–3.14。DLL 随 wheel 自动安装，Python 依赖由 pip 解析。

python -m pip install -U ruyihttp
python -c "import ruyihttp; print(ruyihttp.__version__)"

也可以从 GitHub Releases 下载 wheel 后用 pip 安装。 如果系统提示缺少 VCRUNTIME 或 MSVCP，请安装 Microsoft Visual C++ x64 Redistributable。

使用 Session

Session 可复用连接、Cookie 和默认请求头：

import ruyihttp

with ruyihttp.Session() as session:
    session.headers.update({"User-Agent": "my-client/1.0"})
    response = session.get(
        "https://httpbin.org/get",
        params={"page": 1, "keyword": "ruyihttp"},
        timeout=(5, 30),
    )
    response.raise_for_status()
    print(response.json())

常用功能

更多用法

发送 JSON

import ruyihttp

response = ruyihttp.post(
    "https://httpbin.org/post",
    json={"name": "ruyihttp", "enabled": True},
    timeout=30,
)
response.raise_for_status()
print(response.json())

使用代理

import ruyihttp

response = ruyihttp.get(
    "https://example.com",
    proxies={"https": "http://127.0.0.1:8080"},
    timeout=30,
)

SOCKS 代理先安装可选依赖，再使用 socks5h://127.0.0.1:1080 等代理地址：

pip install "ruyihttp[socks]"

流式下载

import ruyihttp

with ruyihttp.get("https://example.com", stream=True, timeout=30) as response:
    response.raise_for_status()
    with open("page.html", "wb") as output:
        for chunk in response.iter_content(chunk_size=65536):
            output.write(chunk)

配置重试

from ruyihttp import Session
from ruyihttp.adapters import HTTPAdapter
from urllib3.util import Retry

with Session() as session:
    session.mount("https://", HTTPAdapter(max_retries=Retry(total=3)))
    response = session.get("https://example.com", timeout=(5, 30))
    response.raise_for_status()

查看 TLS 信息

import ruyihttp

response = ruyihttp.get("https://example.com", timeout=30)
print(response.tls)

反馈与交流

欢迎通过 Issues 反馈问题或提出功能建议。 反馈时请附上 Python 版本、ruyihttp 版本、最小复现代码和错误信息，分享前移除 Cookie、Token 等私密数据。

相关项目：ruyiPage 提供 Firefox 浏览器自动化能力，适合需要页面操作的场景。

许可证

Python 接口代码采用 MPL-2.0。 原生 DLL、第三方组件许可及对应源码提供状态见 THIRD_PARTY_NOTICES.md。