https://www.jinzhi.site/tags/envoy/ Recent content in Envoy on chengzhycn's blog Hugo en-us Tue, 28 Apr 2026 15:18:28 +0800 https://www.jinzhi.site/posts/2026-04/envoy-go-http-filter/ Tue, 28 Apr 2026 15:18:28 +0800 https://www.jinzhi.site/posts/2026-04/envoy-go-http-filter/ <p>Go HTTP 过滤器 (<code>envoy.filters.http.golang</code>) 允许使用 Go 编写 Envoy HTTP 过滤器。Go 代码被编译为共享库 (<code>.so</code>)，在运行时通过 <code>dlopen</code> 加载，并借由 CGo bridge 集成到 Envoy 的 C++ 过滤器链中。</p> <h2 id="架构">架构</h2> <p>Go HTTP Filter 主要分为两端：</p> <ul> <li><strong>C++ 端</strong>：负责 DSO 加载、过滤器链集成以及线程安全。</li> <li><strong>Go 端</strong>：通过 Go SDK 实现过滤器逻辑，通过 CGo 与 C++ 通信。</li> </ul> <p>ABI 边界由 <code>contrib/golang/common/go/api/api.h</code> 中的共享 C 结构体定义。</p> <p><img src="https://www.jinzhi.site/images/notes/envoy-go-http-filter/1d4a997271052a5a6344e5235da18b13_MD5.jpeg" alt="1d4a997271052a5a6344e5235da18b13_MD5"></p> <h2 id="dso-动态共享对象-加载机制">DSO (动态共享对象) 加载机制</h2> <p>Go HTTP 过滤器通过 <code>contrib/golang/common/dso/</code> 中定义的专用 DSO 机制加载 Go 编译的共享库。这与 Envoy 核心扩展中的 <code>dynamic_modules</code> 是两套独立的实现。</p> <h3 id="核心组件">核心组件</h3> <h4 id="1-dso-管理器-dsomanager">1. DSO 管理器 (DsoManager)</h4> <p><code>DsoManager</code> 类 (<code>contrib/golang/common/dso/dso.h</code>) 负责管理共享库的生命周期：</p>