juspaydotin/hyperswitch-control-center

镜像概述

Hyperswitch Control Center 是 Hyperswitch 支付处理平台的官方管理界面，提供基于 Web 的可视化操作环境，用于集中管理 Hyperswitch 基础设施的配置、监控和运维工作。该镜像封装了完整的前端和后端服务，可快速部署并与 Hyperswitch 核心服务集成，简化支付系统的日常管理流程。

核心功能与特性

配置管理

• 支付网关配置：支持添加、编辑和删除支付网关（如 Stripe、***、Adyen 等）的连接参数，包括 API 密钥、终端 ID 和环境（测试/生产）设置。
• 路由规则管理：可视化配置交易路由策略，支持按金额、地区、卡类型等条件设置优先级路由规则，实现流量分配和容灾切换。
• 自定义参数：支持配置手续费规则、退款策略、通知模板等系统级参数。

交易监控

• 实时交易流：展示实时处理中的交易数据，包括交易 ID、金额、状态、支付方式和网关响应信息。
• 历史记录查询：支持按时间范围、交易状态、金额等条件筛选历史交易，提供导出（CSV/Excel）功能。
• 异常告警：自动识别失败交易、超时请求等异常情况，并通过界面提示或 Webhook 推送告警。

系统状态

• 服务健康检查：监控 Hyperswitch 核心服务（API 服务、路由服务、数据库等）的运行状态，展示存活状态和响应延迟。
• 性能指标：实时展示交易吞吐量（TPS）、平均响应时间、错误率等关键性能指标，支持趋势图表查看。
• 资源占用：显示当前服务的 CPU、内存、磁盘 IO 等资源使用情况。

用户与权限

• 多角色管理：支持管理员、操作员、只读用户等角色定义，限制不同用户对配置修改、交易查看等功能的访问权限。
• 操作审计：记录用户的关键操作（如配置修改、权限变更），生成审计日志用于合规审计。

使用场景

支付系统日常管理

支付系统管理员通过该界面进行日常配置维护，如更新支付网关密钥、调整路由规则，确保支付流程正常运行。

开发与测试环境配置

开发人员可在测试环境中快速配置模拟支付网关，验证新功能或路由策略的正确性，缩短测试周期。

运维监控

运维人员通过实时监控面板跟踪系统状态，及时发现并处理服务异常或性能瓶颈，保障支付系统稳定性。

合规与审计

财务或合规团队通过审计日志和交易记录，满足监管要求（如 PCI DSS）的合规检查需求。

使用方法

前提条件

• 已部署 Hyperswitch 核心服务（API 服务、数据库等），且网络可互通。
• Docker 环境版本 ≥ 20.10，或 Docker Compose 版本 ≥ 2.10。

Docker 快速启动

基础运行命令

bash
docker run -d \
  --name hyperswitch-control-center \
  -p 8080:8080 \  # 映射容器端口到主机（默认 8080）
  -e HYPERSWITCH_API_URL=http://hyperswitch-api:8000 \  # Hyperswitch API 服务地址
  -e DB_HOST=hyperswitch-db \  # 数据库主机地址（需与 Hyperswitch 共享数据库或独立部署）
  -e DB_PORT=5432 \  # 数据库端口（默认 5432，PostgreSQL）
  -e DB_USER=control_center_user \  # 数据库用户名（需提前创建并授权）
  -e DB_PASSWORD=your_secure_password \  # 数据库密码
  -e JWT_SECRET=your_jwt_secret_key \  # 用于生成登录令牌的密钥（建议使用随机字符串）
  hyperswitch/control-center:latest

环境变量配置

Docker Compose 部署示例

创建 docker-compose.yml 文件，整合 Hyperswitch Control Center 与依赖服务（如数据库）：

yaml
version: '3.8'

services:
  control-center:
    image: hyperswitch/control-center:latest
    ports:
      - "8080:8080"
    environment:
      - HYPERSWITCH_API_URL=http://hyperswitch-api:8000
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_USER=control_center
      - DB_PASSWORD=secure_password
      - DB_NAME=hyperswitch_control
      - JWT_SECRET=your_jwt_secret_key_here
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:14-alpine
    environment:
      - POSTGRES_USER=control_center
      - POSTGRES_PASSWORD=secure_password
      - POSTGRES_DB=hyperswitch_control
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:

启动服务：

bash
docker-compose up -d

访问与使用

1. 访问界面：服务启动后，通过浏览器访问 http://<主机IP>:8080。
2. 初始登录：默认管理员账号为 admin@hyperswitch.io，密码为 admin123（首次登录需强制修改密码）。
3. 配置集成：登录后在「系统设置」→「API 连接」中验证 Hyperswitch API 服务连通性，完成后即可开始使用配置管理、交易监控等功能。

数据持久化

为避免容器重启导致配置和日志丢失，建议通过挂载卷持久化数据：

• 配置文件：若需自定义配置（如 Nginx 反向代理设置），可挂载 /app/config 目录。
• 日志文件：日志默认存储在 /app/logs，可挂载该目录到主机。
• 数据库：推荐使用外部数据库（如示例中的独立 PostgreSQL 服务）并挂载数据卷，避免容器内数据库数据丢失。