对冲刷量交易系统 - 生产部署指南

🎯 系统概述

业务目标: 多平台多账户 Delta 中性对冲刷量交易系统

同一平台/多个平台多账户开出基本头寸
不断增加/减少头寸增加交易量
保持持仓量，尽可能全局 Delta 中性

技术架构: Node.js + TypeScript + PM2 + 健康检查 + 结构化日志

📋 P0 生产模块完成情况

✅ 已完成 - 立即可用

1. 健康检查系统

位置: src/infrastructure/health/
功能:
- 系统健康状态监控
- 交易所连接状态检查
- 账户可用性验证
- REST API 端点 (/health, /health/summary, /health/live, /health/ready)
测试: examples/health_check_test.ts - ✅ 通过

2. 结构化日志系统

位置: src/utils/ProductionLogger.ts
功能:
- JSON 格式日志输出
- 业务日志 (交易、对冲、账户、WebSocket)
- 审计日志记录
- 日志轮转和压缩
- 性能: 333K+ logs/sec
测试: examples/production_logger_test.ts - ✅ 通过

3. PM2 生产配置

位置: ecosystem.config.js
功能:
- 进程管理和自动重启
- 日志管理和轮转
- 健康检查集成
- 优雅关闭处理
- 生产环境变量管理

4. 生产主程序

位置: src/main-production.ts
功能:
- 完整的生产环境启动流程
- 健康检查和日志系统集成
- 优雅关闭和错误处理
- 对冲业务逻辑集成

5. 部署脚本和工具

部署脚本: scripts/production-setup.sh - 自动化部署
监控脚本: 系统状态监控和日志清理
健康检查: 独立的健康检查脚本

🚀 快速部署

系统选择

运行方式	命令	适用场景
完整系统	`yarn start:complete`	开发测试、演示
生产版本	`yarn start:prod`	生产环境直接运行
PM2管理	`yarn deploy:production`	生产环境高可用

1. 环境准备

# 检查 Node.js 版本
node --version  # 需要 18+

# 安装 PM2 (如果未安装)
npm install -g pm2

# 克隆项目并安装依赖
git clone <your-repo>
cd binance-api
yarn install

2. 环境变量配置

# 复制环境变量模板
cp env.example .env

# 配置必要的环境变量
export NODE_ENV=production
export LOG_LEVEL=info
export LOG_DIR=./logs
export HEALTH_CHECK_PORT=3001
export ENABLE_HEALTH_API=true
export ENABLE_STRUCTURED_LOGGING=true

# 配置交易所 API 密钥
export PACIFICA_PRIVATE_KEY=your_pacifica_private_key
export ASTER_ORDER_USER=your_aster_user_address
export ASTER_API_KEY=your_aster_api_key
export ASTER_API_SECRET=your_aster_api_secret

3. 自动化部署

# 运行自动化部署脚本
chmod +x scripts/production-setup.sh
./scripts/production-setup.sh

4. 手动部署 (可选)

# 构建项目
yarn build

# 启动生产环境
pm2 start ecosystem.config.js --env production

# 查看状态
pm2 list
pm2 logs trading-hedge-system

📊 监控和运维

健康检查端点

# 完整健康检查
curl http://localhost:3001/health

# 健康状态摘要
curl http://localhost:3001/health/summary

# 存活性检查 (Liveness Probe)
curl http://localhost:3001/health/live

# 就绪性检查 (Readiness Probe)
curl http://localhost:3001/health/ready

日志管理

# 查看实时日志
pm2 logs trading-hedge-system

# 查看系统状态
./scripts/system-status.sh

# 清理旧日志
./scripts/cleanup-logs.sh

PM2 管理命令

# 查看进程列表
pm2 list

# 重启系统
pm2 restart trading-hedge-system

# 停止系统
pm2 stop trading-hedge-system

# 查看监控面板
pm2 monit

# 重载配置
pm2 reload ecosystem.config.js --env production

🔧 配置说明

关键配置参数

// ecosystem.config.js - 主要配置
{
  name: 'trading-hedge-system',
  instances: 1,                    // 单实例运行
  max_memory_restart: '1G',        // 内存限制
  min_uptime: '30s',              // 最小运行时间
  max_restarts: 5,                // 最大重启次数
  kill_timeout: 30000,            // 优雅关闭超时
  health_check: {
    endpoint: 'http://localhost:3001/health',
    interval: 30000               // 30秒健康检查
  }
}

日志配置

// 生产日志配置
{
  level: 'info',                   // 日志级别
  enableFile: true,                // 文件日志
  logDir: './logs',               // 日志目录
  maxFileSize: 100,               // 100MB 文件轮转
  enableRotation: true,           // 启用轮转
  enableAudit: true              // 审计日志
}

健康检查配置

// 健康检查配置
{
  port: 3001,                     // API 端口
  enableDetailedResponse: true,   // 详细响应
  checkInterval: 30000           // 检查间隔
}

📈 性能指标

生产就绪度评估

指标	当前状态	目标状态	状态
健康检查系统	✅ 完成	✅ 完成	🟢
结构化日志	✅ 完成	✅ 完成	🟢
PM2 配置	✅ 完成	✅ 完成	🟢
生产主程序	✅ 完成	✅ 完成	🟢
自动化部署	✅ 完成	✅ 完成	🟢

性能测试结果

日志性能: 333K+ logs/sec
健康检查响应: < 100ms
内存使用: ~200MB (正常负载)
系统启动时间: < 30秒

🚨 监控告警

关键告警指标

系统健康状态 - 健康检查失败
内存使用率 - 超过 80%
日志错误率 - 超过 1%
交易所连接 - 连接断开
全局 Delta - 超出风险阈值

Grafana 监控面板 (待实施)

# 未来集成 Prometheus + Grafana
# 当前使用 PM2 内置监控
pm2 monit

🔐 安全配置

生产安全检查清单

环境变量存储敏感信息
HTTPS/WSS 加密通信
审计日志记录
API 密钥轮换 (P1 优先级)
IP 白名单 (P1 优先级)
防火墙配置 (P1 优先级)

📋 运维检查清单

部署前检查

环境变量配置正确
交易所 API 密钥有效
网络连接正常
磁盘空间充足 (>10GB)
内存资源充足 (>2GB)

部署后验证

系统健康检查通过
所有交易所连接正常
账户余额可访问
日志正常输出
PM2 进程稳定运行

日常运维

每日检查系统状态
每周清理日志文件
每月检查性能指标
定期更新依赖包

🆘 故障排除

常见问题

健康检查失败

# 检查服务状态
curl http://localhost:3001/health
pm2 logs trading-hedge-system

内存使用过高

# 检查内存使用
pm2 monit
# 重启进程
pm2 restart trading-hedge-system

交易所连接失败

# 检查网络连接
ping api.pacifica.fi
# 验证 API 密钥
echo $PACIFICA_PRIVATE_KEY

日志文件过大

# 清理日志
./scripts/cleanup-logs.sh
# 检查轮转配置

🔄 版本升级

滚动升级流程

# 1. 备份当前版本
cp -r . ../backup-$(date +%Y%m%d)

# 2. 更新代码
git pull origin main

# 3. 安装依赖和构建
yarn install
yarn build

# 4. 重载 PM2 配置
pm2 reload ecosystem.config.js --env production

# 5. 验证部署
curl http://localhost:3001/health

回滚策略

# 如果升级失败，快速回滚
pm2 stop trading-hedge-system
cp -r ../backup-YYYYMMDD/* .
pm2 start ecosystem.config.js --env production

📞 支持联系

系统状态: 生产就绪 ✅ 部署时间: < 5分钟 预期可用性: 99.5%+

PRODUCTION_DEPLOYMENT.md 7.9 KB Historia Czysty

对冲刷量交易系统 - 生产部署指南

🎯 系统概述

📋 P0 生产模块完成情况

✅ 已完成 - 立即可用

1. 健康检查系统

2. 结构化日志系统

3. PM2 生产配置

4. 生产主程序

5. 部署脚本和工具

🚀 快速部署

系统选择

1. 环境准备

2. 环境变量配置

3. 自动化部署

4. 手动部署 (可选)

📊 监控和运维

健康检查端点

日志管理

PM2 管理命令

🔧 配置说明

关键配置参数

日志配置

健康检查配置

📈 性能指标

生产就绪度评估

性能测试结果

🚨 监控告警

关键告警指标

Grafana 监控面板 (待实施)

🔐 安全配置

生产安全检查清单

📋 运维检查清单

部署前检查

部署后验证

日常运维

🆘 故障排除

常见问题

🔄 版本升级

滚动升级流程

回滚策略

📞 支持联系

PRODUCTION_DEPLOYMENT.md 7.9 KB

Historia Czysty