2.6 KiB
2.6 KiB
安装指南
虚拟环境设置
由于现代 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