飞驰 HTTP → GB/T 32960 桥接服务

目标

将飞驰车辆数据平台中的 20 辆 GB_T32960 车辆转换为 GB/T 32960.3-2016 标准 TCP 报文，并发送到岭牛内网车辆网关的 32960 端口。

服务必须满足：

每 10 秒发现实时增量，不重复转发平台持续返回的最后一帧；
使用 0x05 完成平台登录，实时数据使用 0x02，历史补传使用 0x03；
每帧收到内网网关成功 ACK 后才推进持久化游标；
自动完成 CSRF 初始化、验证码识别、RSA 密码登录和 R_SESS 会话维护；
源会话返回 401/403 时自动重新登录，并重放一次原 API 请求；
TCP 断线后重新登录，并用相同原始帧重试一次；
重启后从本地游标继续，默认补齐最近 1 小时、每次查询 20 分钟；
保留源接口调用、目标 ACK、错误和活跃车辆等 Prometheus 指标；
不转发离线车辆反复返回的旧快照。
离线车辆最后快照按源时间仅补发一次 0x03，不伪装成实时 0x02。

数据路径

飞驰 HTTP API
  ├─ 车辆发现 vehicleRealStatuss
  ├─ 实时明细 vehicleRealStatussByVId
  └─ 历史明细 hisdataQuerys
          │
          ▼
feichi-bridge
  字段映射 → 去重 → 32960 编码 → ACK 后提交游标
          │
          ▼
内网 vehicle-gateway :32960

桥接服务当前编码 V2016 ## 报文。源平台确认的主要字段如下：

32960 数据	飞驰字段
数据时间	`2000`（兼容 `9999`）
车速、里程、挡位	`2201`、`2202`、`2203`
加速/制动踏板	`2208`、`2209`
运行模式、DCDC	`2213`、`2214`
充电状态、车辆状态	`2301`、`3201`
总电压、总电流、绝缘电阻	`2613`、`2614`、`2617`
SOC	`7615`
原始经纬度	`2502`、`2503`
单体电压、温度	`2003`、`2103`
极值	`2601`—`2612`
燃料电池主要数据	`2110`—`2121`
驱动电机复合数据	`2307`、`2308`

定位必须使用 2502/2503 原始坐标；.gd 字段是页面地图转换坐标，不能写进国标数据。

自动登录与认证文件

服务按照网页端协议执行 first-login → randCode → login：读取 x-api-csrf/CSRF，验证码图片交给 ECS 本机、禁网运行的专用 OCR 容器，密码使用网页端同一 RSA 公钥做 PKCS#1 v1.5 加密，登录成功后保存响应中的 R_SESS。OCR 结果不会被直接信任；登录接口是最终校验，错误时会换一张验证码重试。密码、Cookie、验证码图片和响应正文均不写日志。

/opt/lingniu-go-native/secrets/feichi-auth.json：

{
  "username": "replace-me",
  "password": "replace-me"
}

文件权限必须为 0600。飞驰若提供机器账号、长期 Token 或正式接口鉴权，仍应优先切换到供应商承诺的方式。

/opt/lingniu-go-native/secrets/feichi-target.json：

{
  "platformId": "FEICHIBRIDGE00001",
  "username": "bridge",
  "password": "replace-me"
}

platformId 必须正好 17 字节。目标网关启用 GB32960_AUTH_MODE=enforce 时，需在网关凭据文件中登记同一平台账号和密码。

环境配置

/opt/lingniu-go-native/env/feichi-bridge.env 最小配置：

FEICHI_BASE_URL=http://mob.fsfeichi.com.cn:8000
FEICHI_AUTH_SECRET_FILE=/opt/lingniu-go-native/secrets/feichi-auth.json
FEICHI_TARGET_SECRET_FILE=/opt/lingniu-go-native/secrets/feichi-target.json
FEICHI_TARGET_ADDR=127.0.0.1:32960
FEICHI_STATE_FILE=/var/lib/lingniu-feichi-bridge/state.json
HEALTH_ADDR=127.0.0.1:20219

可调参数及默认值：

参数	默认值	说明
`FEICHI_POLL_INTERVAL_SECONDS`	10	实时轮询间隔
`FEICHI_DISCOVERY_INTERVAL_SECONDS`	300	车辆清单刷新间隔
`FEICHI_FETCH_CONCURRENCY`	4	明细接口并发数
`FEICHI_SOURCE_STALE_SECONDS`	120	超过该时间不作为实时帧转发
`FEICHI_STALE_REISSUE_ENABLED`	true	将离线旧快照去重后仅补发一次为 `0x03`
`FEICHI_HTTP_TIMEOUT_SECONDS`	15	HTTP 超时
`FEICHI_OCR_IMAGE`	`lingniu/feichi-captcha-ocr:1.0.0`	本机验证码 OCR 镜像
`FEICHI_OCR_TIMEOUT_SECONDS`	20	单次验证码识别超时
`FEICHI_LOGIN_MAX_ATTEMPTS`	20	单轮自动登录最多验证码次数
`FEICHI_LOGIN_RETRY_SECONDS`	1	验证码/登录失败重试间隔
`FEICHI_TARGET_TIMEOUT_SECONDS`	10	TCP 写入和 ACK 超时
`FEICHI_BACKFILL_ENABLED`	true	是否启用历史补传
`FEICHI_BACKFILL_LOOKBACK_SECONDS`	3600	无游标时回看范围
`FEICHI_BACKFILL_WINDOW_SECONDS`	1200	单次历史查询窗口
`FEICHI_BACKFILL_SAFETY_SECONDS`	30	历史与实时之间的安全延迟
`FEICHI_BACKFILL_INTERVAL_SECONDS`	3600	补传巡检周期

飞驰地址当前是明文 HTTP。部署时应限制服务的出口目的地址，并避免认证文件、Cookie、响应原文进入代理访问日志。

构建与启动

cd go/vehicle-gateway
go test ./internal/feichibridge ./cmd/feichi-bridge
CGO_ENABLED=0 go build -trimpath -o feichi-bridge ./cmd/feichi-bridge

docker build -t lingniu/feichi-captcha-ocr:1.0.0 ../../deploy/feichi-ocr
install -d -m 0750 /var/lib/lingniu-feichi-bridge
systemctl daemon-reload
systemctl enable --now lingniu-go-feichi-bridge

检查：

curl -fsS http://127.0.0.1:20219/healthz
curl -fsS http://127.0.0.1:20219/readyz
curl -fsS http://127.0.0.1:20219/metrics | grep vehicle_feichi_bridge
journalctl -u lingniu-go-feichi-bridge -f
jq '.vehicles | to_entries[] | select(.value.last_realtime_ack_at or .value.last_backfill_ack_at) |
    {vin: .key, realtime_ack: .value.last_realtime_ack_at, backfill_ack: .value.last_backfill_ack_at}' \
    /var/lib/lingniu-feichi-bridge/state.json

上线验收

先选 1 辆在线车灰度 30 分钟，再开放全部 20 辆。验收需要同时满足：

网关收到一次 0x05 登录，后续实时帧为 0x02；
同一源时间和同一内容只落一条，重启后无持续重复；
断开目标 TCP 后能重连、重新登录并继续收到 ACK；
使源会话过期后能自动重登；连续登录失败时 /readyz 变为 503，游标不前移；
两辆离线车不会把历史最后一帧当实时数据周期发送；
原始经纬度、总压、总流、SOC、单体电压和温度与平台页面抽样一致；
20 辆车连续运行 24 小时后，源/目标计数和平台记录数差异可解释。

已知边界

页面接口不是飞驰承诺的稳定开放 API，接口结构升级可能要求同步调整客户端；
验证码识别依赖本机 OCR 镜像和飞驰当前验证码样式；样式变化会触发登录失败告警，不会导致未 ACK 数据推进游标；
源接口只提供离散快照，无法恢复平台未保存或查询窗口之外的原始上行帧；
映射结果是标准 32960 语义报文，不是车辆原始二进制报文的逐字节复制。

6.9 KiB Raw Blame History Unescape Escape