首页/网络/常用端口速查/9870 HDFS NameNode Web UI

9870 HDFS NameNode Web UI

Hadoop 3 的 NameNode 管理界面:集群概览、数据块状态、启动/快照操作都在 http://namenode:9870(Hadoop 2 时代是 50070)。

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

HDFS NameNode Web UI 与 9870 端口

9870 是 Hadoop 3 中 HDFS NameNode 的 Web UI 与 HTTP 服务端口。集群概览、数据块状态、文件系统浏览、快照与安全模式操作都在这个页面上完成;Hadoop 2 时代对应的端口是 50070,版本混布的环境里两种端口会同时存在。它还同时承载 WebHDFS REST 接口,因此不只是给人看的页面。

基本信息

服务HDFS NameNode Web UI 与 HTTP 服务
端口/协议TCP HTTP 9870,Hadoop 2 为 50070
相关端口8020 NameNode RPC、9864 DataNode UI、8088 YARN UI
接口能力页面操作加 WebHDFS REST,可读写文件
权限要求遵循 HDFS 权限体系,UI 可配置 Kerberos 认证
安全等级仅大数据网段,禁止公网暴露

典型使用场景

  • 集群巡检:查看容量、块状态、活跃与缺失副本数
  • 故障处置:确认安全模式状态并按流程进入或退出
  • 文件排查:按路径定位文件与块分布,查看副本所在节点
  • 运维操作:触发快照、检查升级与回滚状态
  • 接口集成:WebHDFS 供采集脚本读取目录与文件信息

页面与接口检查

页面与接口检查
curl -s 'http://nn01:9870/jmx?qry=Hadoop:service=NameNode,name=NameNodeStatus' | head -c 300  # 节点状态
curl -s 'http://nn01:9870/webhdfs/v1/?op=LISTSTATUS' | head -c 300                               # WebHDFS 列目录
ss -lntp | grep -E ':(9870|8020) '                                                               # 核对 UI 与 RPC
# 启用 Kerberos 的集群用 curl --negotiate -u : 带上票据访问
# Hadoop 2 环境把端口换成 50070 再做同样检查

页面与端口对照

端口角色说明
9870NameNode Web UI 与 WebHDFSHadoop 3 默认
50070NameNode Web UIHadoop 2 时期的默认端口
8020NameNode RPC客户端与 DataNode 的元数据通道
9864DataNode Web UI单节点的块与存储状态

运维要点

  • 把 UI 访问范围按集群控制权限看待,而不是当成普通监控页面
  • 混布环境同时盘点 9870 与 50070,避免监控漏掉旧节点
  • WebHDFS 暴露前确认底层是否已启用认证与授权
  • 变更快照与安全模式要有审批流程,页面点一下就生效
  • 把 8020 的可用性一并纳入监控,页面绿不代表客户端能读写
页面里能执行进入安全模式等影响全局的操作,因此访问范围等同于集群控制权限范围。生产集群应经认证代理或 VPN 限制访问,而不是只依赖网络边界。
未开启认证的 9870 等于对任何可达客户端开放 HDFS 读写能力,WebHDFS 可直接下载或写入数据。云上部署务必绑定内网地址并配置认证。

易错点

  • 把 9870 直接暴露公网:WebHDFS 可未授权读写数据,数据面完全敞开
  • 只按 Hadoop 3 的 9870 排查:混布环境里旧节点仍用 50070,监控会漏掉一半节点
  • 只查 UI 端口忽略 8020:页面正常但客户端读写失败,问题出在 RPC 通道
  • 在生产页面随手触发快照或退出安全模式:缺少变更流程,可能引发长尾性能问题

数据来源与参考

  • Apache Hadoop 官方文档(9870 NameNode UI)

相关工具

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