You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
4.1 KiB
4.1 KiB
Alpha Futures Pro 系统启动指南
本文档详细介绍了 Alpha Futures Pro 系统的启动方法、流程顺序和注意事项，帮助您快速部署和使用系统。
系统架构
- 前端：React 19.x + Ant Design 6.x + Vite
- 后端：Node.js 18.x + Express 4.x + TypeScript 5.x
- 数据源：TQSDK、测试数据
- API 接口：后端运行在
http://localhost:3007 - 前端应用：前端运行在
http://localhost:5173（或类似端口）
启动顺序
必须按照以下顺序启动系统组件：
- 后端服务（优先启动）
- 前端服务（后端启动后再启动）
详细启动流程
1. 启动后端服务
步骤 1：进入后端目录
cd d:\workspace\AlphaFuturesPro\backend
步骤 2：安装依赖（首次启动时需要）
npm install
步骤 3：启动后端服务
npm run dev
验证后端服务启动成功：
- 终端显示 "服务器运行在 http://localhost:3007"
- 可以通过浏览器访问
http://localhost:3007/api/config/get测试 API 是否正常响应 - 正常响应会返回系统配置的 JSON 数据
2. 启动前端服务
步骤 1：进入前端目录
cd d:\workspace\AlphaFuturesPro
步骤 2：安装依赖（首次启动时需要）
npm install
步骤 3：启动前端服务
npm run dev
验证前端服务启动成功：
- 终端显示 Vite 服务器启动信息，通常运行在
http://localhost:5173或类似端口 - 可以通过浏览器访问显示的 URL 进入系统
系统访问
- 主页：
http://localhost:5173/（市场概览） - 管理配置：
http://localhost:5173/admin（系统配置界面） - 自选合约：
http://localhost:5173/watchlist（自选合约列表） - 详细分析：
http://localhost:5173/detail/:code（单个合约详细分析） - 风险控制：
http://localhost:5173/risk-control（风险控制界面）
注意事项
-
端口占用：
- 后端默认使用端口 3007，如果被占用需要停止占用该端口的进程后重新启动
- 前端默认使用端口 5173，如果被占用会自动尝试其他端口
-
依赖安装：
- 首次启动或代码更新后，可能需要重新安装依赖
- 后端和前端的依赖需要分别安装
-
配置文件：
- 系统配置会保存在后端的配置文件中，修改配置后会自动生效
- 数据源配置（如 TQSDK 的用户名和密码）需要在管理配置界面中设置
-
数据源连接：
- TQSDK 需要正确配置用户名和密码才能获取数据
- 如果 TQSDK 连接失败，系统会自动使用测试数据（如果启用了测试数据源）
-
网络连接：
- 系统需要网络连接来获取外部数据（如 TQSDK 数据）
- 确保防火墙没有阻止系统的网络请求
常见问题排查
1. 后端服务启动失败
症状：终端显示错误信息，如 "Error: listen EADDRINUSE: address already in use"
解决方案：
- 检查端口 3007 是否被占用
- 停止占用该端口的进程
- 重新启动后端服务
2. 前端访问不通
症状：浏览器显示 "无法访问此网站" 或类似错误
解决方案：
- 检查后端服务是否正常运行
- 检查前端服务是否启动成功
- 确认访问的 URL 是否正确
3. 数据获取失败
症状：前端显示 "获取配置失败" 或 "数据加载失败" 等错误
解决方案：
- 检查后端服务是否正常运行
- 检查数据源配置是否正确
- 检查网络连接是否正常
- 尝试重启后端服务
4. 管理配置界面无法保存配置
症状：点击 "保存配置" 按钮后显示错误信息
解决方案：
- 检查后端服务是否正常运行
- 检查配置数据是否格式正确
- 尝试刷新页面后重新保存
技术支持
如果您在启动或使用系统过程中遇到问题，请检查上述文档内容。如果问题仍然存在，请联系技术支持团队获取帮助。
文档版本：v1.0 最后更新：2026-02-20