数据流
一份报文在系统里的完整路径
入站与出站共用同一套引擎,传输层可替换。
买方 EDI 系统(Amazon Vendor / Walmart / 车企)
HTTPS (AS2) / SSH (SFTP) / OFTP2
入口层 · Caddy / Nginx(TLS 终止、WAF、IP 白名单)
↓
通道
AS2 Handler
验签 / 解密 / MDN
通道
SFTP 轮询
目录隔离 / 原子写
核心
X12 引擎
解析 / 生成 / 校验
↓ 映射模板
业务系统 · ERP / MES / 自有平台(HTTP API 双向)
Redis · 队列与重试
PostgreSQL · 伙伴与状态
OSS · 报文归档
组件
每一层负责什么
Axum EDI 服务
RustAS2 入站端点、报文解析与生成、997 回执、映射引擎、内部 API,全部在一个可横向扩展的服务内。
AS2 模块
S/MIMEX.509 证书管理、签名与加密、同步或异步 MDN、失败重试。证书私钥从 KMS 读取,不落盘。
Redis 队列
Async出站报文异步发送、回执超时重试、告警推送,避免 HTTP 请求阻塞业务操作。
PostgreSQL
State伙伴配置、映射模板、报文元数据、回执记录与状态机流转,全部可查询可审计。
SFTPGo(可选)
SFTP为使用 SFTP 的买方提供隔离目录与密钥认证,文件事件触发解析。
对象存储归档
OSS原始报文、MDN、997 文件长期保存,用于对账、客诉与审计追溯。
方案优势
- ▸报文与证书数据不经过第三方 VAN,自主可控
- ▸海外节点部署,显著降低跨境丢包与 MDN 超时
- ▸新增买方只增加映射模板,不需要重构引擎
- ▸开放 HTTP API,可嵌入自有 ERP、MES、Workbuddy
- ▸原始报文全量归档,支持逐笔追溯与对账
- ▸状态机明确,重试与告警策略可配置
必须正视的风险
- ▸AS2 密码学细节多(签名算法、证书链、MDN 类型),必须测试环境先跑通
- ▸买方防火墙白名单与证书轮换需要双方 EDI 团队配合
- ▸业务校验规则以买方 IG 为准,网上资料无法替代
- ▸国内节点对接欧美买方链路不稳定,不建议作为生产入口
落地建议
怎么选节点与通道
节点选择
对接北美买方优先美西或新加坡节点,对接欧洲优先法兰克福;不要用国内节点直连海外生产环境。
固定出口 IP
买方通常要求报备服务器出口 IP,提前申请固定 EIP 并提供给买方加入白名单,否则出站报文会被静默丢弃。
证书与密钥
TLS 证书与 AS2 业务证书是两套东西。AS2 私钥托管在 KMS,设置到期提醒,提前 30 天启动轮换。
先 SFTP 后 AS2
开发阶段用 SFTP 验证报文解析与生成逻辑,稳定后再接 AS2 通道,可以把协议问题和业务问题分开排查。