安装 Freqtrade

安装¶

本页介绍如何为运行机器人准备环境。

freqtrade 文档描述了多种安装 freqtrade 的方式：

• Docker 镜像
• 脚本安装
• 手动安装
• Conda 安装

建议在评估 freqtrade 工作原理时，优先使用预构建的 Docker 镜像 快速开始。

信息¶

Windows 安装请参考 Windows 安装指南。

最简单的安装和运行 Freqtrade 的方式是克隆 Github 仓库，然后运行适用于你平台的 ./setup.sh 脚本。

依赖要求¶

这些依赖适用于 脚本安装 和 手动安装。

安装指南¶

• Python >= 3.11
• pip
• git
• virtualenv（推荐）

安装代码¶

我们为 Ubuntu、MacOS 和 Windows 收集/整理了安装说明。这些仅供参考，其他发行版可能略有不同。

操作系统相关步骤在前，通用部分适用于所有系统。

# 更新仓库
sudo apt-get update

# 安装软件包
sudo apt install -y python3-pip python3-venv python3-dev python3-pandas git curl

# 安装软件包
brew install gettext libomp

sudo apt-get install python3-venv libatlas-base-dev cmake curl libffi-dev
# 使用 piwheels.org 加速安装
sudo echo "[global]\nextra-index-url=https://www.piwheels.org/simple" > tee /etc/pip.conf

git clone https://github.com/freqtrade/freqtrade.git
cd freqtrade

bash setup.sh -i

Freqtrade 仓库¶

Freqtrade 是一个开源加密货币交易机器人，代码托管在 github.com

# 下载 freqtrade 仓库 develop 分支
git clone https://github.com/freqtrade/freqtrade.git

# 进入下载目录
cd freqtrade

# 选项 (1)：新手用户
git checkout stable

# 选项 (2)：高级用户
git checkout develop

(1) 该命令将仓库切换到 stable 分支。如果你想保持在 (2) develop 分支，则无需切换。

你可以随时用 git checkout stable/git checkout develop 在分支间切换。

脚本安装¶

Freqtrade 的一种安装方式是使用提供的 Linux/MacOS ./setup.sh 脚本，该脚本会安装所有依赖并帮助你配置机器人。

请确保已满足依赖要求并已下载 Freqtrade 仓库。

使用 /setup.sh -install (Linux/MacOS)¶

在 Debian、Ubuntu 或 MacOS 上，freqtrade 提供了安装脚本。

# --install，从零安装 freqtrade
./setup.sh -i

激活虚拟环境¶

每次打开新终端，都需运行 source .venv/bin/activate 激活虚拟环境。

# 激活虚拟环境
source ./.venv/bin/activate

你现在可以运行机器人了。

/setup.sh 脚本的其他选项¶

你还可以用 ./script.sh 更新、配置和重置机器人代码库。

# --update，git pull 更新代码
./setup.sh -u
# --reset，强制重置 develop/stable 分支
./setup.sh -r

--install

此选项会安装机器人及大部分依赖：

你需要预先安装 git 和 python3.11+。

• 必需软件如：ta-lib
• 在 .venv/ 下设置虚拟环境

此选项结合了安装任务和 --reset

--update

此选项会拉取当前分支最新代码并更新虚拟环境。建议定期用此选项更新机器人。

--reset

此选项会强制重置分支（仅限 stable 或 develop），并重建虚拟环境。

手动安装¶

请确保已满足依赖要求并已下载 Freqtrade 仓库。

设置 Python 虚拟环境（virtualenv）¶

你将会在独立的 virtual environment 下运行 freqtrade

# 在 /freqtrade/.venv 目录下创建虚拟环境
python3 -m venv .venv

# 运行虚拟环境
source .venv/bin/activate

安装 python 依赖¶

python3 -m pip install --upgrade pip
python3 -m pip install -r requirements.txt
# 安装 freqtrade
python3 -m pip install -e .

你现在可以运行机器人了。

（可选）安装后任务¶

在带有 systemd 的 Linux 上，作为可选的安装后任务，你可以将机器人设置为 systemd service，或配置日志输出到 syslog/rsyslog 或 journald。详见 高级日志。

Conda 安装¶

Freqtrade 也可通过 Miniconda 或 Anaconda 安装。

推荐使用 Miniconda，因为其安装体积更小。Conda 会自动准备和管理 Freqtrade 的大量依赖库。

什么是 Conda？¶

Conda 是多语言的软件包、依赖和环境管理器：conda 文档

用 conda 安装¶

安装 Conda¶

Linux 安装方法

Windows 安装方法

全部问题请按提示回答。

安装后，务必关闭并重新打开终端。

下载 Freqtrade¶

下载并安装 freqtrade。

# 下载 freqtrade
git clone https://github.com/freqtrade/freqtrade.git

# 进入下载目录 'freqtrade'
cd freqtrade      

Freqtrade 安装：Conda 环境¶

conda create --name freqtrade python=3.12

进入/退出 freqtrade 环境¶

查看可用环境：

conda env list

进入已安装环境：

# 进入 conda 环境
conda activate freqtrade

# 退出 conda 环境（此处无需执行）
conda deactivate

用 pip 安装最后的 python 依赖：

python3 -m pip install --upgrade pip
python3 -m pip install -r requirements.txt
python3 -m pip install -e .

你现在可以运行机器人了。

重要快捷命令¶

# 列出已安装 conda 环境
conda env list

# 激活 base 环境
conda activate

# 激活 freqtrade 环境
conda activate freqtrade

# 退出所有 conda 环境
conda deactivate                              

anaconda 进一步信息¶

祝你交易顺利！

你已准备就绪¶

你已成功安装 freqtrade。

初始化配置¶

# 步骤 1 - 初始化用户文件夹
freqtrade create-userdir --userdir user_data

# 步骤 2 - 创建新配置文件
freqtrade new-config --config user_data/config.json

你已可以运行机器人，详见 机器人配置，请务必以 dry_run: True 开始，并确认一切正常。

配置方法详见 机器人配置 文档。

启动机器人¶

freqtrade trade --config user_data/config.json --strategy SampleStrategy

故障排查¶

常见问题：“command not found”¶

如果你用 (1)脚本 或 (2)手动 安装，需在虚拟环境下运行机器人。如果出现如下错误，请确保 venv 已激活。

# 如果：
bash: freqtrade: command not found

# 则激活虚拟环境
source ./.venv/bin/activate

MacOS 安装错误¶

新版 MacOS 可能会因 error: command 'g++' failed with exit status 1 安装失败。

这通常需要手动安装 SDK 头文件，MacOS 10.14 可用如下命令：

open /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg

如果该文件不存在，说明你用的是其他版本的 MacOS，请上网查找具体解决方法。