Mojaloop Account Lookup Service Docker镜像文档

镜像概述和主要用途

本Docker镜像是Mojaloop开源支付平台的核心组件之一，封装了account-lookup-service服务。该服务主要用于在支付流程中提供账户信息查询功能，支持参与方（如机构、支付服务提供商）之间的账户信息查找，是实现跨机构支付、促进普惠的关键服务。

核心功能和特性

• 账户信息查询：提供API接口支持账户标识（如MSISDN、账户ID、***等）的验证与信息查询
• 多标识类型支持：兼容多种账户标识格式，满足不同参与方的账户体系需求
• Mojaloop生态集成：与Mojaloop平台其他组件（如central-ledger、quoting-service）无缝协同
• 可配置策略：支持自定义账户查询规则和路由策略，适配不同业务场景
• 高可用性设计：支持水平扩展，满足高并发支付场景的查询需求
• 标准化接口：遵循Mojaloop API规范，确保跨系统互操作性

使用场景和适用范围

适用场景

• ***机构间的跨机构支付账户验证
• 移动支付应用中的账户信息查询
• 数字***服务的账户标识有效性校验
• ***或企业福利发放的账户信息核实

适用范围

• 部署Mojaloop开源支付平台的***机构
• 提供普惠***服务的支付服务提供商
• 构建基于Mojaloop标准的支付生态系统的技术团队
• 需要符合GSMA Mobile Money API规范的支付系统

使用方法和配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name account-lookup-service \
  -p 3000:3000 \
  -e DB_HOST=mysql \
  -e DB_PORT=3306 \
  -e DB_USER=root \
  -e DB_PASSWORD=password \
  -e DB_DATABASE=account_lookup \
  -e PORT=3000 \
  mojaloop/account-lookup-service

Docker Compose部署

yaml
version: '3.8'

services:
  account-lookup-service:
    image: mojaloop/account-lookup-service
    container_name: account-lookup-service
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - PORT=3000
      - LOG_LEVEL=info
      # 数据库配置
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_USER=root
      - DB_PASSWORD=password
      - DB_DATABASE=account_lookup
      # 外部服务配置
      - CENTRAL_LEDGER_URL=[***]
      - CACHE_ENABLED=true
      - CACHE_TTL=300
    depends_on:
      - mysql

  mysql:
    image: mysql:8.0
    container_name: als-mysql
    environment:
      - MYSQL_ROOT_PASSWORD=password
      - MYSQL_DATABASE=account_lookup
    ports:
      - "3306:3306"
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  mysql-data:

环境变量配置参数

健康检查

服务启动后可通过以下端点检查健康状态：

GET http://localhost:3000/health

健康检查返回状态码200表示服务正常运行。

数据持久化

建议通过挂载外部卷或使用独立数据库服务（如MySQL集群）实现账户数据的持久化存储，避免容器重启导致数据丢失。

注意事项

• 生产环境中需配置数据库连接池参数，优化查询性能
• 建议配合服务发现机制（如Consul、Kubernetes Service）使用，实现动态服务路由
• 高并发场景下需配置适当的缓存策略，减少数据库查询压力
• 所有敏感配置（如数据库密码）建议通过环境变量注入或密钥管理服务获取，避免硬编码