如何启动 etcd gateway TCP 代理转发客户端流量并验证可用性【免费下载链接】etcdDistributed reliable key-value store for the most critical data of a distributed system项目地址: https://gitcode.com/GitHub_Trending/et/etcd当你有一个已经运行起来的 etcd 集群但不想让每个客户端都记住所有成员的地址时可以用 etcd 自带的gateway子命令启动一个 TCP 层OSI level 4代理它在固定的监听地址上接受连接把流量原样转发给后端的 etcd 客户端端口。客户端只需把--endpoints指向 gateway 的监听地址即可。gateway 本身不存储数据、不解析请求只做 TCP 转发见 server/proxy/tcpproxy/doc.go 对 tcpproxy 包的说明。启动前的前提至少有一个可访问的 etcd 实例在运行默认 gRPC 客户端端点为127.0.0.1:2379这是 gateway--endpoints参数的默认值。本机上有etcd和etcdctl可执行文件。gateway 的监听地址不能和后端端点解析到同一主机——启动时 server/etcdmain/gateway.go 会检查这一点冲突时打印SRV or endpoint (...) should not resolve to the gateway listen addr并直接退出。启动 gateway最简命令在 etcd 集群所在机器或能访问它的机器上执行etcd gateway --endpoints127.0.0.1:2379 start--endpoints接收逗号分隔的多个 etcd 集群端点endpoint 带http://等 schema 时会被自动剥掉只保留host:port。其余可用参数及默认值如下定义见 server/etcdmain/gateway.go参数默认值用途--listen-addr127.0.0.1:23790gateway 监听地址客户端流量进入的入口--endpoints127.0.0.1:2379逗号分隔的后端 etcd 集群端点--retry-delay1m对失败端点重试前的延迟--discovery-srv空用于引导初始集群的 DNS 域名--discovery-srv-name空使用 DNS 发现时查询的服务名--insecure-discoveryfalse是否接受不安全的 SRV 记录--trusted-ca-file空使用 discovery-srv 时校验所发现端点的 TLS CA 文件如果没有任何端点可用gateway 打印no endpoints found后退出。判断启动是否成功gateway 开始接受连接前会输出一条 Info 日志ready to proxy client requests日志中会带上实际的 endpoints 列表。e2e 测试 tests/e2e/gateway_test.go 就是用等待这条日志作为启动完成的判定条件可以把它当作你的核对基准。验证流量是否真的被转发把 etcdctl 的端点从真实 etcd 地址换成 gateway 的监听地址默认127.0.0.1:23790执行一次写入etcdctl --endpoints127.0.0.1:23790 put foo bar返回OK即说明请求经 gateway 的 TCP 代理到达了后端 etcd 并被处理e2e 测试预期输出为OK\r\n。再读取确认etcdctl --endpoints127.0.0.1:23790 get foo能看到bar的值即完成闭环验证。多端点转发与端点失效时的行为配置多个--endpoints时转发行为由 server/proxy/tcpproxy/userspace.go 中的TCPProxy实现每个新连接按轮询方式round robin挑选一个活跃后端若后端来自带 priority/weight 的 SRV 记录则先选最低 priority再按 weight 加权。拨号某个后端失败时该端点被标记为不活跃日志输出deactivated endpoint含地址、重试 interval 和错误并继续尝试其他端点。后台 monitor 每隔--retry-delay默认 1 分钟尝试重新激活不活跃的端点成功则日志输出activated失败则输出failed to activate endpoint (stay inactive for another interval)。也就是说个别后端宕机不会导致 gateway 退出只会看到 deactivated/activated 日志所有后端都不可达时新连接会被直接关闭。可选通过 DNS 发现后端如果不想在命令行里硬编码成员地址可以给--discovery-srv传 DNS 域名来发现初始集群端点此时--discovery-srv-name指定查询的服务名--insecure-discovery控制是否接受不安全的 SRV 记录--trusted-ca-file指定用于校验所发现端点的 TLS CA 文件。注意只有在 DNS 发现结果为空时gateway 才会回退到--endpoints提供的地址。边界与限制gateway 是纯 TCP 层代理不做 gRPC 语义处理也不做负载均衡健康探测之外的任何事它转发的是监听端口对应的客户端 gRPC 流量。监听地址与后端端点解析到同一地址时启动即失败需要为 gateway 选一个独立的--listen-addr。端点参数写错无法解析 host:port时gateway 打印解析错误并退出可据此排查配置。【免费下载链接】etcdDistributed reliable key-value store for the most critical data of a distributed system项目地址: https://gitcode.com/GitHub_Trending/et/etcd创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考