auto_trade_sys/docs/INSTALL.md
薇薇安 86b85c2609 a
2026-01-25 11:19:39 +08:00

2.6 KiB
Raw Blame History

安装指南

虚拟环境设置

由于现代 Linux 系统(如 Ubuntu 22.04+)不允许直接在系统 Python 中安装包,必须使用虚拟环境。

推荐方案:项目根目录统一虚拟环境

在项目根目录创建一个虚拟环境,供 backend 和 trading_system 共享:

# 在项目根目录
cd /path/to/auto_trade_sys

# 创建虚拟环境
python3 -m venv .venv

# 激活虚拟环境
source .venv/bin/activate  # Linux/Mac
# 或 .venv\Scripts\activate  # Windows

# 安装后端依赖(包含交易系统依赖)
cd backend
pip install -r requirements.txt

# 安装交易系统依赖(如果需要额外依赖)
cd ../trading_system
pip install -r requirements.txt

独立虚拟环境方案

如果需要独立管理,可以分别为 backend 和 trading_system 创建虚拟环境:

Backend 虚拟环境

cd backend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Trading System 虚拟环境

cd trading_system
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

或者使用安装脚本:

cd trading_system
./setup.sh

验证安装

验证后端依赖

cd backend
source ../.venv/bin/activate  # 或 source .venv/bin/activate
python -c "import fastapi; print('FastAPI:', fastapi.__version__)"
python -c "import pymysql; print('PyMySQL installed')"

验证交易系统依赖

cd trading_system
source ../.venv/bin/activate  # 或 source .venv/bin/activate
python -c "from binance import AsyncClient; print('python-binance installed')"
python -c "import unicorn_binance_websocket_api; print('Unicorn WebSocket installed')"

常见问题

错误externally-managed-environment

原因:系统 Python 环境被保护,不允许直接安装包。

解决:使用虚拟环境(见上方方案)。

错误python3-venv 未安装

# Ubuntu/Debian
sudo apt install python3-venv python3-full

# CentOS/RHEL
sudo yum install python3-venv

虚拟环境激活失败

确保使用正确的路径:

# 检查虚拟环境是否存在
ls -la .venv/bin/activate

# 使用绝对路径激活
source /path/to/auto_trade_sys/.venv/bin/activate

生产环境部署

生产环境建议使用 Supervisor 或 systemd在配置中指定虚拟环境的 Python 路径:

# Supervisor 配置示例
[program:auto_trade_system]
command=/path/to/auto_trade_sys/.venv/bin/python /path/to/auto_trade_sys/trading_system/main.py
directory=/path/to/auto_trade_sys/trading_system