AIS Stream

在全球航运业数字化和海事安全监控日益重要的今天，获取实时、准确的船舶自动识别系统（AIS）数据至关重要。aisstream.io 提供了一个强大且免费的 WebSocket API，让开发者能够轻松流式传输全球船舶的实时位置、航向、速度及货物信息，是构建海事监控大屏、物流追踪系统或事故预警平台的理想选择。

核心功能：一站式海事数据流

aisstream.io 将所有复杂的海事数据交互简化为单个 WebSocket 连接。一旦连接建立，客户端即可订阅并接收以下关键数据流：

• 📍 实时位置追踪：毫秒级更新的船舶经纬度坐标。
• 🧭 航行状态监控：包括航向 (Course)、对地速度 (SOG)、船首向 (Heading) 及航行状态 (Navigational Status)。
• 🚢 船舶静态信息：船名、MMSI 码、IMO 编号、船舶类型、尺寸等。
• 📦 货物与目的地：部分数据包含载货信息及预计到达时间 (ETA)。
• ⚠️ 事故与异常监测：通过数据分析发现潜在的海事事故或异常停泊行为。

认证与安全：API Key 机制

为了保障数据服务的稳定与安全，aisstream.io 采用严格的 API Key 认证机制：

1. 用户注册：需通过 GitHub 或其他支持的方式登录官网生成账户。
2. 密钥管理：在控制台创建专属 API Key，支持随时撤销。
3. 强制加密：所有连接必须使用 WSS (WebSocket Secure) 协议，严禁明文传输，确保密钥与数据链路安全。

注意：一旦密钥被撤销（无论是用户主动还是平台风控），它将立即失效，但在控制台中仍可见以便审计。

⚠️ 关键架构限制：为何不支持浏览器直连？

开发者需注意：aisstream.io 明确不支持跨域资源共享 (CORS)，禁止从浏览器前端直接连接。

这并非技术缺陷，而是基于安全与架构的最佳实践设计：

1. 保护 API 密钥安全

• 风险：若允许前端直连，API Key 必须硬编码在 JavaScript 中或暴露在网络请求里，任何访问你网站的人都能轻易窃取密钥并滥用你的配额。
• 正确模式：后端代理模式。
  • 你的后端服务器使用 API Key 连接 aisstream.io。
  • 后端处理数据过滤、聚合后，再通过你自己的 WebSocket 或 SSE 推送给前端。
  • 结果：API Key 永远保存在受控的后端环境中，绝不暴露于公网。

2. 避免流量限制误伤

• 风险：aisstream.io 对每个 API Key 设有并发连接数和流量限制。如果你的 Web 应用有 1000 个用户，且都尝试用同一个 Key 直连，会瞬间触发限流，导致所有用户无法获取数据。
• 正确模式：后端单点连接。
  • 无论前端有多少用户，后端只维持一个到 aisstream.io 的连接。
  • 后端将数据广播给所有前端用户。
  • 结果：极大节省配额，提升系统稳定性。