首页/网络/常用端口速查/9901 Envoy Admin 管理口

9901 Envoy Admin 管理口

Envoy 代理的内置管理接口:/stats、/clusters、/config_dump 全在这里;Istio 数据面每个 sidecar 都有它。

常用端口速查网络更新于 2026-10-13

9901 是什么

9901 是 Envoy 代理内置的管理接口端口:/stats、/clusters、/config_dump 等端点提供运行统计、集群状态与完整配置转储,Istio 数据面的每个边车代理都带它。它默认绑定 127.0.0.1,一旦改成全网卡监听,后果立竿见影:配置转储会导出全部路由与集群信息,部分端点还能直接影响代理行为。

基本信息

服务Envoy admin(默认 9901)
协议TCP,HTTP
用途运行统计、配置转储与健康检查
安全等级仅本机或受控运维通道
默认绑定127.0.0.1

典型使用场景

  • 数据面排障:查看路由与集群的实时状态
  • 统计核对:确认请求量、错误率与连接池指标
  • 配置确认:核对当前生效的路由与集群配置
  • 健康检查:通过专用端点判断代理状态
  • 服务网格运维:多边车环境下批量核对状态
  • 暴露面收敛:禁止把管理口改为全网卡监听

常用端点(本机)

常用端点(本机)
curl -s http://127.0.0.1:9901/server_info | head -c 300   # 版本与运行信息
curl -s http://127.0.0.1:9901/stats | head -20          # 运行统计
curl -s http://127.0.0.1:9901/clusters | head -20       # 集群与上游状态
ss -lntp | grep 9901                                    # 确认绑定地址是否为回环

常用端点与信息量

端点内容敏感度
/server_info版本与运行信息低
/config_dump全部路由与集群配置高,含内部拓扑
/stats运行统计指标中,暴露调用量与错误分布
把管理口监听地址改为全网卡,等于把代理的配置与统计公开:任何可达主机都能读取内部拓扑,部分端点还会影响代理行为。
容器与网格环境下,边车管理口常被用作探针入口,排查前先确认是谁在访问、目的是否合理。
配置转储包含上游集群与路由匹配规则,属于高价值信息,导出的文件要按敏感数据处理。
远程排障建议通过端口转发或临时隧道访问管理口,而不是修改监听地址:前者可撤销,也不会留下长期暴露面。

易错点

  • 为远程排障把管理口暴露到网段:任何机器可停代理、导配置、看全量路由
  • 容器里默认绑定被改成全网卡:暴露面随副本数一起放大
  • 把配置转储文件当普通日志存放:内部拓扑信息扩散
  • 用管理口做长期健康检查来源:权限与访问路径缺少约束
  • 排障后未恢复配置:临时监听地址长期保留

数据来源与参考

  • Envoy 官方文档(admin 9901)

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌