Freqtrade 新人完整上手教程(2025.12 版|Docker|已验证)
适用人群:完全没接触过 Freqtrade 或者之前各种 network / ccxt / python 环境问题想一次就跑通回测闭环。
一、准备条件(只需要这 3 个)
- macOS / Linux / Windows(推荐 macOS / Linux)
- Docker Desktop 已安装并启动
- 能正常访问 Binance(不用代理)
注意:本教程不使用本机 Python 跑 freqtrade,所有 freqtrade 相关操作全部在 Docker 里完成。
二、启动 Docker(很多人卡在这里)
1️⃣ 启动 Docker Desktop
- 打开 Docker Desktop App
- 等右上角 🐳 显示 Running
2️⃣ 验证 Docker daemon 正常
docker info
能输出一大堆信息即可。
三、拉取 Freqtrade 官方镜像(一次性)
docker pull freqtradeorg/freqtrade:stable
看到 Downloaded newer image 即成功。
四、创建项目目录
mkdir -p ~/freqtrade-demo
cd ~/freqtrade-demo
mkdir -p user_data
最终结构:
freqtrade-demo/
└── user_data/
五、初始化 user_data(官方标准步骤)
docker run --rm -it \
-v $(pwd)/user_data:/freqtrade/user_data \
freqtradeorg/freqtrade:stable \
create-userdir --userdir user_data
成功后本地应出现:
user_data/
├── data/
├── logs/
└── strategies/
六、写一份【最小可用】config.json(⚠️ 关键)
这是 2025.12 版本必须能跑回测的配置,已考虑 entry_pricing / exit_pricing 的新校验规则。
user_data/config.json
{"$schema":"https://schema.freqtrade.io/schema.json","max_open_trades":1


