Docker-based QLib Factor Backtesting Environment

项目简介

本项目提供了一个基于Docker的QLib因子回测环境，用于量化投资策略的开发、测试和回测。

功能特性

• ✅ 自动数据更新（每天19:45）
• ✅ Alpha158因子计算
• ✅ CSI300股票池回测
• ✅ 涨幅前300股票回测
• ✅ Jupyter Notebook集成
• ✅ 完整的日志系统
• ✅ 容器化部署

环境要求

• Docker 20.10+
• Docker Compose 2.0+
• 至少8GB RAM（推荐16GB）
• 至少50GB可用磁盘空间

快速开始

1. 启动Docker容器

docker-compose up -d

2. 访问Jupyter Notebook

http://localhost:8888

获取访问token：

docker logs quant_factors-qlib-factor-backtest-1 | grep token

3. 运行回测Notebook

在Jupyter Notebook中，导航到notebooks/目录，选择要运行的回测Notebook：

• csi300_backtest.ipynb：CSI300股票池回测
• top300_backtest.ipynb：涨幅前300股票回测

项目结构

├── quant_factors/
│   ├── cli/                 # 命令行接口
│   ├── data/                # 数据更新相关代码
│   ├── docker/              # Docker相关配置和脚本
│   ├── factor/              # 因子计算相关代码
│   ├── notebooks/           # Jupyter Notebook模板
│   └── utils/               # 通用工具函数
├── specs/                   # 规格文档
├── logs/                    # 日志文件
├── docker-compose.yml       # Docker Compose配置
├── pyproject.toml           # 项目配置
└── requirements.txt         # 依赖包列表

命令行使用

# 安装依赖
pip install -e .

# 使用命令行工具
quant-factors --help

手动运行

1. 下载数据

python -m quant_factors.data.downloader

2. 更新数据

python -m quant_factors.data.updater

3. 计算因子

python -m quant_factors.factor.alpha158

日志查看

# 查看容器日志
docker logs -f quant_factors-qlib-factor-backtest-1

# 查看项目日志
cat logs/quant_factors.log.*

常见问题

1. 容器启动失败

解决方案：

• 检查Docker版本是否符合要求
• 检查系统资源是否充足
• 查看容器日志获取具体错误信息

2. Jupyter Notebook无法访问

解决方案：

• 检查容器是否正在运行
• 检查端口映射是否正确
• 检查防火墙设置

3. 数据下载失败

解决方案：

• 检查网络连接
• 检查GitHub仓库是否可用
• 手动下载数据并解压到~/.qlib/qlib_data/cn_data目录

许可证

MIT License

注意事项

本项目仅供研究和学习使用，不构成投资建议。投资有风险，入市需谨慎。