Cloud Architecture

云端自研 EDI 部署方案

Rust + Axum 单一服务承担 AS2 端点、报文引擎与映射;Redis 做任务与重试,PostgreSQL 存伙伴与报文状态, 对象存储永久归档原始报文。部署在海外云节点,由固定出口 IP 对接买方防火墙白名单。

数据流

一份报文在系统里的完整路径

入站与出站共用同一套引擎,传输层可替换。

买方 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 服务

Rust

AS2 入站端点、报文解析与生成、997 回执、映射引擎、内部 API,全部在一个可横向扩展的服务内。

AS2 模块

S/MIME

X.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 通道,可以把协议问题和业务问题分开排查。

需要一份针对你买方环境的部署清单?

提交买方与现有系统情况,我们给出节点、通道、证书与网络配置建议。

提交需求