HTTP客户端缓存模块里，内存LRU存储在达到容量上限时如何决定移除哪条记录，直接影响缓存命中率和内存占用。Ruby HTTPX的ResponseCache插件内置了Store::Memory::LRU实现，其Evict方法采用近似LRU算法，通过采样一部分键并淘汰其中最久未访问的条目，避免维护全局访问时间戳带来的...

栏目：Ruby 时间：10-07 Ruby HTTPX ResponseCache LRU淘汰策略

HTTPS 代理一旦启用中间人能力，客户端访问公网资源时常常出现 certificate verify failed 报错：代理服务器用自己的根证书重新签发站点证书，客户端若不信任该根证书，TLS 握手就无法完成。本文聚焦 Ruby HTTPX 的 Proxy::HTTPS 插件，说明如何正确加载代理 CA 证书、调整 SSL 上...

栏目：Ruby 时间：10-05 Ruby HTTPX HTTPS代理 MITM证书信任

为什么 SOCKS5 UDP 中继链路总是在空闲几十秒后自动关闭，导致音视频推流和游戏加速任务反复重连？排查服务端和网络后，问题往往出在客户端 HTTPX 代理插件的清理间隔默认值上。HTTPX::Plugins::Proxy::SOCKS5::UDPRelay::Association::Cleanup::Interval::Default::Value 这...

栏目：Ruby 时间：10-03 Ruby HTTPX SOCKS5 UDP代理 清理间隔配置

配置链式代理时经常会遇到这样的现象：上游代理的认证信息明明填写了，下游代理却仍然返回 407 Proxy Authentication Required。原因通常是 Basic 凭证被放错了层级。HTTPX 的代理插件将下游代理认证封装在 HTTPX::Plugins::Proxy::Chain::Downstream::Auth::Basic::Credent...

栏目：Ruby 时间：10-03 Ruby HTTPX 下游代理 基本认证凭证

向一个启用了基本认证的HTTP代理发起请求时，Ruby程序如果只配置了代理地址而缺少凭据，往往会直接收到407 Proxy Authentication Required。HTTPX库通过插件机制把代理认证逻辑封装在HTTPX::Plugins::Proxy::HTTP::BasicAuth中，可以在代理连接阶段自动注入认证头。本文将拆解...

栏目：Ruby 时间：10-02 Ruby HTTPX 代理基本认证 HTTP BasicAuth

HTTPX作为高性能的Ruby HTTP客户端，提供了灵活的代理链支持，而下游代理认证是其中容易让人困惑的一环。这篇文章直接说明下游代理在代理链中的位置，以及如何通过HTTPX::Plugins::Proxy::Chain::Downstream::Auth模块来设置认证信息。我们将用可运行的代码示例展示如何在初始...

栏目：Ruby 时间：10-01 Ruby HTTPX 下游代理认证 代理链

HTTPX 的响应缓存插件启用 Redis 存储以后，HTTP 响应对象并不能直接写入 Redis。写入前必须经过一个序列化步骤，把 Ruby 对象变成 Redis 可接受的字节串；读取时再逆向恢复成缓存条目。HTTPX::Plugins::ResponseCache::Store::Redis::Serialize 模块正是承担这一转换的核心。...

栏目：Ruby 时间：09-30 Ruby HTTPX ResponseCache 序列化

为什么两个看似相同的 HTTP 请求，一个能命中缓存，另一个却总是回源？问题多半出在缓存键生成上。HTTPX 的 ResponseCache 插件并不是直接拿 URL 当缓存键，而是通过 HTTPX::Plugins::ResponseCache::KeyGenerator 把请求对象转成稳定字符串。本文从默认生成规则入手，分析请求方...

栏目：Ruby 时间：09-30 Ruby HTTPX ResponseCache 缓存键生成

直接给 Ruby HTTP 客户端接入熔断器，最容易被忽略的不是失败阈值，而是半开状态下的试探请求如何计数。HTTPX::Plugins::CircuitBreaker 把断路逻辑做成插件，默认按连续失败次数触发打开，冷却结束后进入半开状态，只允许少量请求通过来判断下游是否恢复。本文从故障判定、计数规...

栏目：Ruby 时间：09-27 Ruby HTTPX CircuitBreaker 半开状态

把代理地址写进环境变量就以为 Ruby HTTPX 会自动走完整的链式代理，往往会在运行时遇到连接被拒绝或认证失败。HTTPX 的代理能力集中在 proxy 插件中，而 HTTPX::Plugins::Proxy::Chain::Upstream 这一层级负责描述链式代理中的上游节点。它不仅仅是设置一个 URI，还涉及认证...

栏目：Ruby 时间：09-21 Ruby HTTPX 上游代理 链式代理

HTTPX的链式代理认证机制依托ProxyAuth模块在请求转发前逐跳注入凭证，与单一代理认证不同，链式场景要求每个代理节点独立处理鉴权头。许多开发者误以为代理链共享同一套认证信息，导致在配置多跳代理时频繁遭遇407错误。该模块通过拦截CONNECT请求并为每一跳重写Proxy-Author...

栏目：Ruby 时间：09-14 Ruby HTTPX 链式代理认证 ProxyAuth

当单个代理节点无法满足需求时，多级代理链式转发就成了必须面对的问题。HTTPX作为Ruby生态中一个现代化的HTTP客户端库，其Plugins::Proxy::Chain插件允许开发者将多个代理服务器串联起来，让请求依次经过每一跳再到达目标地址。本文围绕HTTPX的代理链实现展开，先介绍链式代理...

栏目：Ruby 时间：09-07 Ruby HTTPX Proxy Chain 多级代理

SOCKS5代理握手过程中，客户端发出连接命令后，服务端会返回一条命令回复，其中状态字段决定了这次代理请求是否成功。Ruby的HTTPX库在其代理插件中，通过CommandReply下的Status常量以及Success对应的Handler来解析并处理成功状态的回复。本文从SOCKS5协议的命令回复报文结构入...

栏目：Ruby 时间：09-03 Ruby HTTPX Socks5代理 CommandReply状态处理

在HTTP客户端调试中，最令人困惑的往往不是最终返回的错误状态，而是请求过程中到底经历了哪些重定向、重试和连接切换。Ruby HTTPX的ResponseLogger插件恰好把这一过程完整地呈现出来。它能在标准输出或自定义日志器中详细打印每一个请求与响应对，涵盖请求方法、URL、请求头...

栏目：Ruby 时间：08-25 Ruby HTTPX ResponseLogger 请求响应日志

Ruby 的 HTTP 请求一旦失败，很多业务代码只能手工写循环重试，繁琐又容易漏掉边界条件。HTTPX 客户端内置的 Retries 插件把重试逻辑抽离成配置项，开发者只需声明最大重试次数、重试等待时间、可重试的异常类型和状态码，插件就会在请求失败后自动判断是否再次发送。这个插件适...

栏目：Ruby 时间：08-24 Ruby HTTPX Retries插件 重试机制

HTTP代理在处理HTTPS请求时，往往被误认为只是简单转发流量，实际上需要先建立一条端到端的TCP隧道，CONNECT方法正是这条隧道的起点。Ruby HTTPX 的 Proxy::HTTP::Connect 插件封装了这一过程，让开发者无需手动构造 CONNECT 报文，即可通过 HTTP 代理访问 HTTPS 目标站点。该插件...

栏目：Ruby 时间：08-23 Ruby HTTPX HTTP代理 CONNECT隧道

HTTPX 作为 Ruby 生态中功能完善的 HTTP 客户端，其 SOCKS5 代理支持依赖一套状态机完成协议握手。命令回复阶段的 Status 模块定义了多种返回码，其中 Success 对应数值 0，表示 CONNECT 命令已被代理服务器接受并成功建立隧道。理解这一状态的处理逻辑，有助于排查代理连接失败...

栏目：Ruby 时间：08-22 Ruby HTTPX Socks5代理 命令回复状态