mojaloop/central-ledger

Mojaloop Central Ledger 镜像文档

镜像概述

Mojaloop Central Ledger是开源支付互操作性平台Mojaloop的核心组件，旨在实现不同***机构间的支付互通。作为中央分类账系统，其核心功能是记录所有支付交易、执行清算流程并完成最终结算，确保支付交易的准确性、可追溯性和实时性，为支付生态系统提供基础账务支持。

核心功能与特性

• 交易全生命周期管理：完整记录支付交易的发起、授权、处理、完成等全流程状态，提供可审计的交易日志
• 实时清算与结算：支持实时交易清算，支持净额结算与总额结算两种模式，满足不同支付场景需求
• 支付互操作性支持：兼容ISO 20022等国际支付标准，提供标准化接口，支持多类型***机构接入
• 高可用架构设计：支持集群部署模式，具备故障转移能力，保障支付系统7×24小时稳定运行
• 合规与安全保障：内置交易验证机制，支持***监管合规要求，确保交易数据的完整性和安全性

使用场景与适用范围

• 机构间支付互通：银行、信用合作社、移动货币运营商等服务提供商间的跨机构实时支付处理
• 实时支付系统构建：***或中央银行部署全国性实时支付系统的核心账务组件
• 跨境支付网络：作为跨境支付互操作性解决方案的中央分类账，支持多币种交易处理
• ***科技产品开发：***科技企业基于Mojaloop生态构建定制化支付产品的基础组件

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name central-ledger \
  -p 3000:3000 \
  -e DB_HOST=mysql-host \
  -e DB_USER=central_ledger_user \
  -e DB_PASSWORD=secure_password \
  -e DB_DATABASE=central_ledger \
  docker.xuanyuan.run/mojaloop/central-ledger:latest

环境变量配置

Docker Compose 部署示例

yaml
version: '3.8'

services:
  central-ledger:
    image: docker.xuanyuan.run/mojaloop/central-ledger:latest
    container_name: central-ledger
    restart: always
    ports:
      - "3000:3000"
    environment:
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_USER=central_ledger
      - DB_PASSWORD=central_ledger_pwd
      - DB_DATABASE=central_ledger
      - PORT=3000
      - LOG_LEVEL=info
      - NODE_ENV=production
    depends_on:
      - mysql
    networks:
      - mojaloop-network

  mysql:
    image: docker.xuanyuan.run/mysql:5.7
    container_name: central-ledger-mysql
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=root_pwd
      - MYSQL_DATABASE=central_ledger
      - MYSQL_USER=central_ledger
      - MYSQL_PASSWORD=central_ledger_pwd
    volumes:
      - mysql-data:/var/lib/mysql
      - ./init-scripts:/docker-entrypoint-initdb.d
    networks:
      - mojaloop-network

networks:
  mojaloop-network:
    driver: bridge

volumes:
  mysql-data:

注意事项

• 数据库初始化：首次部署需确保数据库已初始化，可通过挂载包含SQL初始化脚本的目录（如示例中./init-scripts）自动执行表结构创建
• 数据持久化：生产环境中必须配置外部数据库或持久化卷，避免容器重启导致数据丢失
• 性能调优：高并发场景下需调整JVM参数、数据库连接池大小及缓存配置
• 安全配置：生产环境中应通过环境变量或配置文件设置强密码，并限制数据库访问权限
• 版本兼容性：需确保与Mojaloop生态其他组件（如account-lookup、quoting-service）版本兼容