smc.peering.tw 完全解析:台湾海缆动态地图如何实时监控海底电缆断线
smc.peering.tw 完全解析:台湾海缆动态地图如何实时监控海底电缆断线
smc.peering.tw 是一个面向普通用户的台湾海缆动态地图,以互动地图的形式实时展示连接台湾与世界的海底电缆(海缆)系统、登陆点位置,以及当前和历史的海缆断线事件。当一条国际海底电缆发生故障时,网站会用红色高亮受损区段、在事件面板列出故障详情与预估修复时间,并统计台湾对外连线条数的变化,是观察国际网络基础设施健康状况的一扇窗口。
为什么需要海缆断线监控?
台湾对外(尤其是对日本、美国、东南亚)的网络流量,高度依赖数十条海底电缆。一条海缆断线可能影响某条国际链路,但如果同一方向还有冗余路径,流量可以绕行。对于网络工程师、运营者甚至普通网友,最想知道的是:
- 哪条海缆断了? 断了哪个区段(segment)?
- 影响面有多大? 台湾对外连线条数少了多少?
- 预计多久修好? 是否已恢复?
smc.peering.tw 正是围绕这三个问题构建的免费开源仪表盘,支持英文与繁体中文界面,桌面与移动端均可流畅使用。
快速上手:如何本地运行海缆动态地图
项目基于 React、TypeScript 与 Vite,构建简单,只需三步即可在本地跑起来:
-
克隆仓库
git clone https://gitcode.com/gh_mirrors/sm/smc.peering.tw cd smc.peering.tw -
安装依赖(需 Node.js 18 及以上版本)
npm install -
准备数据并启动
数据文件放在 src/data/ 目录下(本仓库不包含实际数据文件,格式说明见下文),然后运行:
npm run dev浏览器打开
http://localhost:5173即可看到地图;发布版本则执行npm run build,产物输出到dist目录。
核心功能详解
海缆地图:断线区段一眼可辨
地图由 src/components/Map.tsx 实现,基于 Maplibre GL 渲染矢量底图,并在其上绘制每条海缆的完整路径与登陆点。每条海缆被拆分为若干区段(segment),状态着色逻辑集中在 src/lib/cable-status.ts:
| 线条颜色 | 含义 |
|---|---|
| 🔴 红色 | 该区段断线(disconnected) |
| 🟡 黄色 | 部分断线(partial_disconnected),仍有部分流量可用 |
| 🩵 蓝色等 | 正常,颜色按海缆系统区分 |
| ⬜ 灰色 | 已退役或建设中的区段,不参与状态计算 |
地图上还有一个状态筛选器(src/components/CableFilter.tsx),可以只看"全部 / 正常 / 断线"海缆,方便在密集线路中快速定位故障。
事件(Incident)面板:追踪每一次断线
右侧事件面板由 src/components/IncidentList.tsx 驱动,区分"发生中"与"历史"两类事件。每条事件包含:发生时间、所属海缆与区段、事件标题、详细描述、预估修复时间(ETR)与实际恢复时间,并显示故障已持续的天数。
值得一提的是,事件描述中会出现不少专业缩写,项目专门内置了事件术语表(src/lib/incident-glossary.ts 与 src/i18n/locales/zh-tw.json),鼠标悬停即可看到解释,例如:
- CLS(海缆上陆站):海底电缆在陆地端接入电信网络的设施;
- Shunt Fault(漏电故障):绝缘受损导致供电导体向海水漏电,不一定代表光纤已断;
- ETR(预估修复时间):可能随维修进度调整,并非保证完修时间。
这对新手非常友好——不用懂海缆工程,也能读懂新闻里的故障通报。
Uptime 时间轴:回看过去一年的海缆健康
打开 src/components/dialog/Timeline.tsx 对应的时间轴视图,可以看到最近 365 天内每条海缆的"正常 / 断线 / 部分断线"状态条,相当于给每条电缆画了一条心电图,直观回答"哪条缆最近最不稳定"。建设中(building)的海缆会自动过滤,避免干扰统计。
拓扑视图:从 ISP 视角看影响面
这是较新的全页视图(src/components/TopologyPage.tsx),把"海缆区段 → 承载的 ISP 服务 → 目的地"组织成依赖图。计算逻辑在 src/lib/topology.ts:只要某条逻辑路由中任一区段断线,对应节点即判定为 disconnected;否则若存在部分断线区段则降级为 partial_disconnected。
换句话说,地图告诉你"哪里断了",拓扑图告诉你"断了之后谁受影响"。
对外连线计数器:数字化的故障感知
地图上的 src/components/OutageCounter.tsx 会实时统计"台湾对外连线总条数 vs 当前受影响条数"。项目特别注明:条数不等于带宽,它统计的是可用连线路径数量,用于快速感知国际链路整体健康度,而非实际传输容量。
数据从哪来:JSON 数据与转换脚本
这是一个纯静态展示应用,所有数据由 JSON 文件驱动,核心文件都在 src/data/ 下:
| 文件 | 作用 |
|---|---|
landing-points.json |
海缆登陆点(上陆站)名称与经纬度坐标 |
incidents.json |
断线事件列表(时间、状态、区段、描述、修复时间) |
cables/*.json |
每条海缆的配色、可用路径、沿线设备与区段坐标 |
topology.json |
ISP 与海缆区段的节点/边依赖关系 |
事件数据的加工脚本是 convert_incidents.py:它从上游数据表拉取 TSV 数据,过滤出近两年内的事件,再转写成前端可直接加载的 incidents.json。完整的数据字段格式(含海缆区段坐标、available_path 可用路径等)在 README.md 的 Data Format 一节有详细定义。
前端状态判定(某区段是否断线、断线是否沿路径传播)由 src/lib/cable-status.ts 统一计算,被地图、时间轴、拓扑与计数器复用,保证四处显示的状态始终一致。
项目结构速览
| 路径 | 说明 |
|---|---|
| src/App.tsx | 应用入口与整体布局 |
| src/components/Map.tsx | 海缆地图主体 |
| src/components/dialog/ | 事件、时间轴、拓扑、关于等弹窗视图 |
| src/lib/ | 状态计算、拓扑与术语表等核心逻辑 |
| src/i18n/ | 英文 / 繁体中文语言包 |
| package.json | 依赖与脚本(dev / build / lint / preview) |
项目由 TWDS 赞助,采用 MIT 协议发布(见 LICENSE),完整版本演进记录可参考 README.md 的 Version History——从 v1.0 首版到 v3.12 增加海缆元数据与术语表,功能迭代非常活跃。
总结:适合谁用?
- 网络工程师 / ISP 运营者:用地图 + 拓扑视图快速定位故障区段与影响面;
- 技术爱好者与新闻读者:看到"某海缆断线"新闻时,来这里验证范围与恢复进度;
- 学习者:这是一个很好的 React + Maplibre GL 实战案例,数据驱动、组件化清晰、国际化完整,代码量适中。
下次再看到海缆断线的新闻,不妨打开这张海缆动态地图,亲手确认一下红色线条出现在哪里——这就是 smc.peering.tw 最有意思的地方。
