如何基于Traffic Server实现请求头改写与特定代理缓存架构？

一、实现目标架构的可行方案 #

Apache Traffic Server（TS）完全可以通过自身扩展机制实现你描述的请求转换+缓存架构，无需依赖第三方插件，核心实现方式有两种：

1. Lua脚本扩展（轻量快速实现） #

TS原生支持Lua脚本，可通过以下步骤落地逻辑：

• 在remap.config中为目标Origin Server配置Lua脚本拦截规则，当客户端发送简单请求到达TS时触发脚本执行。
• 脚本内部调用TS的HTTP客户端API（ts.http.client_request）向Translator服务发起请求，获取转换后的复杂请求参数（包括需添加的请求头、路径等）。
• 修改TS发往Origin Server的请求（通过ts.server_request对象），替换为Translator返回的复杂请求格式后转发。
• 结合TS自带的缓存机制，在脚本中配置缓存键（比如基于转换后的请求路径+关键参数）、缓存时长，实现对Origin响应的缓存。

2. C++插件扩展（高性能定制化） #

如果需要更高性能或更复杂的逻辑，可编写TS的C++插件：

• 注册TS_HTTP_READ_REQUEST_HDR_HOOK钩子，拦截客户端请求。
• 在钩子函数中，使用TS的异步HTTP客户端发起对Translator的请求，获取转换规则。
• 修改TS的服务器请求对象（TSHttpTxn），更新请求头、URL等信息后，继续转发到Origin Server。
• 借助TS的缓存API（TSCache系列函数），自定义缓存策略，实现对Origin响应的缓存。

TS本身的缓存是核心特性，只需通过records.config或扩展脚本配置缓存规则，即可为特定Origin Server缓存结果，无需额外插件。

二、请求头丢失问题的排查与解决 #

客户端添加的请求头未出现在TS发往Origin的请求中，通常是以下原因导致，对应解决方法：

• TS默认过滤特定头：TS会自动过滤Connection、Proxy-Connection等与代理相关的头，若你的自定义头被误过滤，可检查records.config中的proxy.config.http.strip_headers参数，移除其中包含的目标头。
• 未配置转发自定义头：对于自定义请求头，需确保TS允许转发。在records.config中设置proxy.config.http.forward.proxy_headers = 1，并可通过proxy.config.http.forward.add_x_forwarded_for等参数控制转发行为。
• 未显式保留头：若上述配置无效，可在Lua脚本或C++插件中显式保留目标头。比如在Lua脚本中，将客户端请求头复制到服务器请求头：

  local custom_header = ts.client_request.header['X-My-Custom-Header']
  if custom_header then
      ts.server_request.header['X-My-Custom-Header'] = custom_header
  end
  

内容的提问来源于stack exchange，提问作者Lightbells