关于HikiMu地震预警服务

HikiMu 地震预警系统依托福建省地震局公开预警信息，以及 ExptechTW 提供的台湾气象署（CWA） API，为用户提供及时、精准的地震预警服务。系统实时对接地震局监测数据，一旦检测到地震活动，将立即触发预警机制。

本服务为个人公益项目，旨在弥补台湾地区地震对福建沿海造成的预警盲区，不替代福建省地震局法定地震预警服务，相关数据仅作避险参考。

系统基于哈弗辛公式（Haversine formula）：
距离 = 2R × arcsin(√(sin²(Δφ/2) + cosφ1·cosφ2·sin²(Δλ/2)))
结合预设的 6.8km/s 地震波传播速度，推算用户剩余避险时间。因本地预估烈度算法较为复杂，预览界面中不同颜色仅用于标识震源强度等级，依次为：蓝色、黄色、橙色、红色。

本平台主要服务于中国台湾及大陆华南沿海地区，地震速报信息分别由台湾气象署（CWA）与福建省地震局（FJEA）提供。目前大陆地区可使用 地牛Wake Up!、DPIP、DPIP、TREM 等同类服务，其对台湾本地地震的响应速度普遍较快。福建省地震局自研速报系统虽已在台湾地区布设观测站点，但受地震活动复杂性与地域差异影响，对台湾本地地震的监测效果仍与当地系统存在一定差距。

实际运行中，福建省地震局系统对大陆境内地震的预警表现稳定可靠。为兼顾不同区域监测需求，系统采用双数据源互补策略：
• 大陆近海地震：优先使用福建省地震局数据
• 台湾地区地震：同步接入台湾气象署数据

该设计既保留福建地震局对大陆区域地震的监测优势，又借助台湾数据源补齐沿海预警盲区，实现更全面、稳定的地震预警覆盖。

此项目开始的时间是2024年03月04日

API接口方面

访问规范与前提条件

HikiMu-EEW 地震预警系统提供了 API 接口，用户可以通过这些接口获取实时的地震速报信息。使用前请确保 API 监控转发程序状态 正常。

1. 访问端口
API 需通过 8266 端口 以 HTTP GET 方式访问，地址格式为：http://*.*.*.*:8266/{name.json}。请勿使用 80 或 443 端口，以免在周审时被误判为异常流量。
WebSocket 端口传输方式：
- 8200 端口 (加密)

2. WebSocket 连接规则
- 连接限制：此 WebSocket 不能使用域名连接，仅支持 IP 连接。
- 证书要求：使用 8200 加密端口连接时，需先信任相关证书。浏览器或 WebSocket 客户端会提示证书不受信任，需手动接受证书（或配置客户端忽略证书验证），否则连接会被阻止。

3. 请求频率限制
- API 抓包（如 Python 抓包）：请求频率不得超过 1 秒 5 次，否则可能被封禁 IP。
- WebSocket 连接：每个 IP 每秒最多 10 次请求，超出后 IP 会被封禁 10 分钟。请控制请求频率，不要短时间内大量请求。

4. 连接超时与活性检测
- 请求超时：每个请求 30 秒内必须完成（读取 + 发送），超时则自动断开连接。
- 活性检测：服务器会定期发送 Ping 包检测连接活性，若 15 秒内无响应则断开连接。
- 闲置断开：若 300 秒（5 分钟）内没有任何数据收发，连接会被服务器主动关闭，建议客户端实现自动重连机制。

5. 封禁规则
若因频率过高或异常行为被封禁，IP 会被暂时加入黑名单（时长 10 分钟）。封禁期间无法建立任何连接，所有请求会被拒绝。被封禁后请等待自动解封，不要反复尝试重连，否则可能延长封禁时间。

6. 访问验证与权限
服务器不要求任何 API Key、Token 或用户名密码（未来若有调整将另行通知）。服务器仅允许访问 api 目录下的文件，非 api 目录文件无法访问。
注：使用 User-Agent（用户标识）伪装时，请确保您所添加的域名或 IP 是经过授权或是合法的，境外域名或 IP 会被重点关注。若使用带域名的用户标识时，经核查后发现使用伪官方域名或 IP 来获取数据，您的 IP 或域名可能会被列入黑名单，后续将无法获取数据。

地震预警核心 API

1. 地震触发检测接口
http://119.29.227.6:8266/wake_up.json
说明：任意地区发生地震时触发。
返回格式：
- 触发时：{"ring": true}
- 2 分钟后或无地震：{"ring": false}

2. 福建地震局地震速报 API（HikiMu中转）
http://119.29.227.6:8266/fjea_list.json
刷新频率：约 2 秒刷新一次，数据来源：福建省地震局。若无新数据，3 分钟后恢复为空数组 []。
http://119.29.227.6:8266/moinc.json
刷新频率：约 2 秒刷新一次。

3. ExptechTW 地震速报 API（HikiMu中转）
http://119.29.227.6:8266/trem-eew.json
刷新频率：约 2 秒刷新一次，数据来源：ExptechTW。默认返回空数组，地震发生时返回数据。
author 字段说明：
- cwa：台湾气象署
- fjdzj：福建地震局
- scdzj：四川地震局
返回示例： 

[
  {
    "author": "cwa",
    "eq": {
      "depth": 10,
      "lat": 23.45,
      "loc": "花蓮縣卓溪鄉",
      "lon": 121.34,
      "mag": 4.7,
      "max": 4,
      "time": 1741793261000
    },
    "final": 0,
    "id": "1140871",
    "serial": 4,
    "status": 0,
    "time": 1741793288000
  }
]

使用注意事项

  • 测站数据仅供参考，部分测站因固件测试可能存在数据不准确，实际数据以官方发布为准。
  • 部分接口存在延迟，请结合实际场景判断。
  • WebSocket 连接需严格遵循端口、证书及频率要求，避免因违规操作导致 IP 封禁。
  • 使用前请熟悉 HikiMu 地震预警系统整体操作。
  • websocket 随时可能维护或调整，若遇到连接问题请先检查服务器状态
  • 请不要在公共网络环境下使用

关于HikiMu地震预警网页版

HikiMu 地震预警系统网页版提供主题模式选择
戳我可前往 WEB版本 >> HikiMu地震预警网页版