someengineering/fixbackend

FIX服务后端镜像文档

镜像概述和主要用途

该Docker镜像提供FIX（Financial Information eXchange，信息交换）协议服务的后端实现，用于在交易系统中处理FIX消息的接收、解析、路由、处理及响应，支持***市场中常见的交易相关业务逻辑。

核心功能和特性

• FIX会话管理：支持FIX协议标准的会话建立、维持、重连及关闭流程，处理心跳（Heartbeat）、测试请求（Test Request）等会话层消息
• 消息处理：提供消息解析、验证、路由机制，支持自定义业务逻辑插件处理交易相关消息（如订单、执行报告、取消请求等）
• 协议版本支持：兼容主流FIX协议版本（如FIX 4.2、4.4、5.0等），可通过配置指定或自动协商版本
• 可配置性：通过环境变量或配置文件自定义会话参数（如心跳间隔、重连次数）、消息处理规则及业务逻辑路径
• 日志与监控：内置详细日志记录（INFO/WARN/ERROR级别），支持输出至标准输出或文件，便于问题排查与系统监控

使用场景和适用范围

• ***机构交易系统后端，处理与交易所、经纪商、清算所等外部实体的FIX协议通信
• 量化交易平台，作为策略引擎与交易执行系统间的FIX消息处理中间层
• ***信息交换网关，实现不同内部系统间基于FIX协议的消息转换与路由

使用方法和配置说明

基本运行命令

bash
docker run -d \
  --name fix-backend \
  -p 8080:8080 \  # 服务监听端口
  -v ./config:/app/config \  # 挂载配置文件目录
  -e FIX_VERSION=4.4 \  # 指定FIX协议版本
  -e SESSION_ID=TRADER001 \  # 会话标识
  -e LOG_LEVEL=INFO \  # 日志级别
  fix-backend:latest

Docker Compose配置示例

yaml
version: '3'
services:
  fix-backend:
    image: fix-backend:latest
    container_name: fix-backend
    ports:
      - "8080:8080"
    volumes:
      - ./config:/app/config
      - ./logs:/app/logs  # 挂载日志目录
    environment:
      - FIX_VERSION=4.4
      - SESSION_ID=TRADER001
      - LOG_LEVEL=INFO
      - HEARTBEAT_INTERVAL=30  # 心跳间隔（秒）
      - RECONNECT_MAX_RETRIES=5  # 最大重连次数
      - CONFIG_PATH=/app/config/session.yaml  # 配置文件路径
    restart: unless-stopped

环境变量配置说明

配置文件说明

配置文件（默认路径/app/config/default.yaml）用于定义会话参数、消息路由规则等详细配置，示例格式：

yaml
session:
  sender_comp_id: "TRADER001"  # 发送方CompID
  target_comp_id: "EXCHANGE001"  # 接收方CompID
  heartbeat_interval: 30
  reconnect_delay: 10  # 重连延迟（秒）
routing:
  rules:
    - message_type: "D"  # 订单消息
      handler: "order_handler"  # 处理插件名称
      destination: "execution-service"  # 目标服务
logging:
  file_path: "/app/logs/fix-backend.log"
  max_size: 100  # 日志文件最大大小（MB）
  max_backup: 5  # 日志文件备份数量

日志与监控

• 日志默认输出至标准输出，可通过LOG_LEVEL调整详细程度
• 挂载日志目录（如示例中./logs:/app/logs）可持久化存储日志文件
• 服务状态可通过访问http://<容器IP>:<PORT>/health端点检查（返回200 OK表示服务正常）