120 lines
2.6 KiB
Markdown
120 lines
2.6 KiB
Markdown
# 安装指南
|
||
|
||
## 虚拟环境设置
|
||
|
||
由于现代 Linux 系统（如 Ubuntu 22.04+）不允许直接在系统 Python 中安装包，必须使用虚拟环境。
|
||
|
||
## 推荐方案：项目根目录统一虚拟环境
|
||
|
||
在项目根目录创建一个虚拟环境，供 backend 和 trading_system 共享：
|
||
|
||
```bash
|
||
# 在项目根目录
|
||
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 虚拟环境
|
||
|
||
```bash
|
||
cd backend
|
||
python3 -m venv .venv
|
||
source .venv/bin/activate
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### Trading System 虚拟环境
|
||
|
||
```bash
|
||
cd trading_system
|
||
python3 -m venv .venv
|
||
source .venv/bin/activate
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
或者使用安装脚本：
|
||
|
||
```bash
|
||
cd trading_system
|
||
./setup.sh
|
||
```
|
||
|
||
## 验证安装
|
||
|
||
### 验证后端依赖
|
||
|
||
```bash
|
||
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')"
|
||
```
|
||
|
||
### 验证交易系统依赖
|
||
|
||
```bash
|
||
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 未安装
|
||
|
||
```bash
|
||
# Ubuntu/Debian
|
||
sudo apt install python3-venv python3-full
|
||
|
||
# CentOS/RHEL
|
||
sudo yum install python3-venv
|
||
```
|
||
|
||
### 虚拟环境激活失败
|
||
|
||
确保使用正确的路径：
|
||
|
||
```bash
|
||
# 检查虚拟环境是否存在
|
||
ls -la .venv/bin/activate
|
||
|
||
# 使用绝对路径激活
|
||
source /path/to/auto_trade_sys/.venv/bin/activate
|
||
```
|
||
|
||
## 生产环境部署
|
||
|
||
生产环境建议使用 Supervisor 或 systemd，在配置中指定虚拟环境的 Python 路径：
|
||
|
||
```ini
|
||
# 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
|
||
```
|