substrate-telemetry-frontend 镜像文档

概述

substrate-telemetry-frontend 是 Substrate 区块链生态系统的官方遥测前端 Docker 镜像，用于配合遥测后端服务，实现 Substrate 节点网络的可视化监控。该镜像提供直观的用户界面，帮助开发者和节点运营商实时查看网络中节点状态、性能指标及区块链数据，是维护 Substrate 网络健康运行的关键工具。

核心功能与特性

• 实时节点监控：展示网络中所有活跃 Substrate 节点的连接状态、同步进度及基本信息
• 性能指标可视化：通过图表直观展示区块高度、出块速度、交易量、节点延迟等关键指标
• 网络拓扑展示：可视化呈现节点间连接关系，帮助理解网络结构
• 数据筛选与搜索：支持按节点ID、链名称、地理位置等条件筛选节点数据
• 响应式设计：适配桌面及移动设备，满足不同场景下的监控需求

使用场景

• 节点运营商：监控自有 Substrate 节点集群的运行状态及资源占用
• 区块链开发者：调试节点性能问题，优化链上参数配置
• 网络维护团队：实时跟踪全网健康状态，及时发现异常节点或网络瓶颈
• 社区展示：向用户或投资者公开网络实时数据，增强项目透明度

使用方法与配置说明

前提条件

• 已部署并运行 substrate-telemetry 后端服务（用于数据收集与处理）
• Docker 环境版本 ≥ 19.03
• 网络端口 80/443 可访问（或自定义端口映射）

基本部署（docker run）

docker run -d \
  --name substrate-telemetry-frontend \
  -p 80:80 \
  -e REACT_APP_API_URL=[***] \
  ***/substrate-telemetry-frontend

环境变量配置

Docker Compose 配置示例

version: '3.8'

services:
  telemetry-frontend:
    image: ***/substrate-telemetry-frontend
    container_name: telemetry-frontend
    restart: always
    ports:
      - "80:80"
    environment:
      - REACT_APP_API_URL=[***]
      - REACT_APP_TITLE=MySubstrateChain Telemetry
    depends_on:
      - telemetry-backend

  telemetry-backend:
    image: ***/substrate-telemetry-backend
    container_name: telemetry-backend
    restart: always
    ports:
      - "8000:8000"
    command: --listen 0.0.0.0:8000

访问前端界面

部署完成后，通过以下地址访问遥测界面：

http://<宿主机IP>:<映射端口>

例如：[***]

数据持久化与升级

• 本镜像为静态前端应用，无本地数据存储需求，升级时直接拉取新版本镜像并重启容器即可
• 建议通过环境变量配置外部化关键参数，避免镜像重新构建

常见问题

• Q: 界面无数据显示？
  A: 检查 REACT_APP_API_URL 是否指向正确的后端服务，确保后端服务正常运行且网络连通

• Q: 如何自定义界面样式？
  A: 需基于源码修改并重新构建镜像，具体参见 官方源码仓库 开发指南

官方文档与资源

• 完整文档
• Substrate 官方文档
• Docker Hub 镜像仓库