Hyperswitch Web镜像文档

镜像概述

Hyperswitch Web镜像是预配置的容器化Web应用，封装了Hyperswitch核心Web服务，用于简化支付处理系统的部署与集成。该镜像提供多支付渠道接入、交易路由、实时监控等功能，支持快速集成至现有支付生态，适用于企业级支付解决方案的容器化部署。

核心功能与特性

• 多渠道接入：集成全球主流支付渠道（、电子、银行转账等），统一API接口简化接入流程
• 智能交易路由：基于成本、成功率动态路由交易，优化支付体验与成本控制
• 高可用性设计：支持水平扩展，内置健康检查与故障恢复机制，保障服务稳定性
• 安全合规：符合PCI DSS安全标准，数据加密传输与存储，确保交易安全
• 实时监控：提供交易日志、性能指标与告警功能，支持Web界面与API监控管理

使用场景

• 电商平台支付系统构建与升级
• 企业级SaaS应用支付模块集成
• 跨境支付解决方案快速部署
• 支付网关二次开发与定制化需求

使用方法

前提条件

• Docker Engine 20.10+
• Docker Compose 2.0+（可选，用于多容器部署）
• 最低配置：1GB内存，10GB磁盘空间

快速启动（docker run）

通过以下命令启动Hyperswitch Web服务：

docker run -d \
  --name hyperswitch-web \
  -p 8080:8080 \
  -e DATABASE_URL=postgresql://user:password@db-host:5432/hyperswitch \
  -e API_KEY=your_secure_api_key \
  -e PAYMENT_CHANNELS=stripe,***,adyen \
  hyperswitch/web:latest

Docker Compose配置

创建docker-compose.yml文件配置服务与依赖组件：

version: '3.8'

services:
  hyperswitch-web:
    image: hyperswitch/web:latest
    container_name: hyperswitch-web
    ports:
      - "8080:8080"
    environment:
      - DATABASE_URL=postgresql://user:password@postgres:5432/hyperswitch
      - API_KEY=your_secure_api_key
      - PAYMENT_CHANNELS=stripe,***
      - LOG_LEVEL=info
      - PORT=8080
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:14-alpine
    container_name: hyperswitch-db
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=hyperswitch
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:

启动服务：docker-compose up -d

环境变量配置

访问与验证

服务启动后，通过以下方式验证：

• Web管理界面：访问http://<容器IP>:8080，使用默认凭据（用户名：admin，密码：通过API_KEY或ADMIN_PASSWORD配置）登录
• API健康检查：发送GET请求至http://<容器IP>:8080/health，返回{"status":"ok"}表示服务正常

注意事项

• 生产环境需替换默认API_KEY与数据库凭据，启用HTTPS加密传输
• 通过Docker Volume挂载配置文件与日志目录，避免容器重启导致数据丢失
• 高并发场景建议通过水平扩展（增加容器实例）与负载均衡提升处理能力