Hummingbot Docker 快速入门指南¶

引言¶

本简短指南将向您介绍使用 Docker 安装和部署 Hummingbot 的过程。您将逐步学习如何使用 Docker Compose 设置 Hummingbot，这是一个用于定义和运行多容器 Docker 应用程序的工具，然后运行您的第一个算法交易策略！

您将学到的内容¶

1. 安装 Docker：安装 Docker 和 Docker Compose 的分步说明，

2. Hummingbot 界面：了解 Hummingbot 界面的基本要素，包括布局和导航。

3. 运行脚本：学习如何作为 Hummingbot 脚本运行算法交易策略。

4. 连接 API 密钥：掌握将 API 密钥与 Hummingbot 集成的关键过程，确保在各种交易所进行安全的基于 API 的机器人交易。

让我们开始！¶

在所有准备工作就绪后，是时候释放您交易工具的全部功能了。让我们开始吧！

安装¶

系统先决条件¶

云服务器或本地机器¶

Docker Compose¶

Hummingbot 使用 Docker Compose，这是一种用于定义和运行多容器 Docker 应用程序的工具。Docker Desktop 已经包含了 Docker Compose 以及 Docker Engine 和 Docker CLI，这些都是 Compose 的先决条件。

克隆 Hummingbot 仓库¶

在您的终端中，克隆 Hummingbot Github 仓库：

git clone https://github.com/hummingbot/hummingbotcd hummingbot

启动实例¶

docker-compose.yml 文件包含部署 Humminggbot 的基本说明：

使用以下命令创建 Docker 容器：

docker compose up -d

这将在后台启动容器，我们需要 attach 到容器才能向其发送命令。运行下面的命令：

连接到容器¶

docker attach hummingbot

现在我们应已运行 Hummingbot，在下一节中我们将介绍 Hummingbot 界面

用户界面¶

Hummingbot 通过 命令行界面 (CLI) 操作，这是一种基于文本的系统，非常适合自动化加密货币交易。与图形界面不同，CLI 依靠文本命令来运行。让我们深入了解如何有效使用它。

创建密码¶

如果您是首次使用 Hummingbot，系统会提示您创建密码。密码没有字符要求，不过我们建议使用强密码以增强安全性。

Hummingbot 中的密码用于加密 API 密钥、密钥和钱包私钥等敏感数据。出于安全考虑，密码仅以加密形式本地存储，我们无法访问该密码。

设置密码后，您现在应该会进入 Hummingbot 的主界面。

用户界面指南¶

命令行界面分为几个关键区域：

• 输入窗格（左下角）：在此输入您的命令。

• 输出窗格（左上角）：显示您的命令执行结果。

• 日志窗格（右侧）：在此可以查看日志消息。

• 顶部导航栏：显示版本、当前策略和策略文件。

• 底部导航栏：显示交易、CPU 使用率、内存、线程数和运行时长。

欲了解更深入的内容，请访问 用户界面

有用的快捷键¶

• CTRL + P + CTRL + Q - 退出机器人但在后台继续运行

• CTRL + X - 退出配置

• 双击 CTRL + C - 完全退出机器人

• CTRL + V 在 Hummingbot 中粘贴不起作用，要粘贴请尝试以下命令之一：

  • CTRL+SHIFT+V

  • SHIFT + RMB（右键按钮）

  • SHIFT + INS

接下来，让我们学习如何在 Hummingbot 中运行一个简单的 PMM 脚本

运行脚本¶

简单的方向性 RSI 示例¶

让我们使用 v2_directional_rsi.py 脚本。这是一个可配置的脚本，使用相对强弱指数（RSI）来交易加密货币期货合约。对于可配置的脚本，第一步是创建配置文件。以下是创建方法：

create --script-config v2_directional_rsi.py

当您输入 create --script-config 命令并按 SPACE 键时，Hummingbot 会在脚本文件夹中显示可用的脚本，如下所示。

选择 v2_directional_rsi.py 脚本并按 ENTER 键。

然后您会被引导配置设置。在此阶段，您可以修改选项或直接按 ENTER 键接受默认值。

给配置命名并按 ENTER 键保存。

配置保存后我们现在可以启动脚本。输入以下命令来启动脚本！

start --script v2_directional_rsi.py --conf conf_v2_directional_rsi_config_1.yml

请注意，按 SPACE 键后，在 --script 和 --conf 参数后会出现自动补全功能，您可以从列表中选择正确的脚本/配置文件，然后按 ENTER 键

按 ENTER 键后，你应该能够在日志窗格中看到活动。使用 status 命令获取更多细节或按 CTRL + S。它应类似如下屏幕。

状态

要停止脚本运行，请在 Hummingbot 终端中输入 stop 命令

stop

恭喜！您已成功运行了您的第一个脚本。接下来，我们将学习如何连接 API 密钥进行实盘交易。

添加 API 密钥¶

虽然 Hummingbot 中的模拟交易不需要 API 密钥，但实盘交易需要。本指南将帮助您将交易所 API 密钥连接到 Hummingbot 进行实时交易。

生成 API 密钥¶

首先，您需要从要连接的交易所生成 API 密钥。每个交易所都有自己的设置流程。

在此示例中，我们将连接 Binance API 密钥。请前往 Binance 连接器文档获取有关如何为 Binance 生成 API 密钥的说明。

查看 连接器列表 获取目前已与 Hummingbot 集成的交易所列表

将 API 密钥连接到 Hummingbot¶

在 Hummingbot 中运行 connect 命令来连接到我们想要的交易所。在本例中，对于 Binance 请使用以下命令 -

connect binance

您应该会收到提示输入您的 API 密钥 - 您可以使用下面的命令将它们粘贴到 Hummingbot 终端中。请注意，CTRL + V 不起作用，如果您尝试使用它会在日志面板中得到一个 Pyperclip error。

• CTRL+SHIFT+V

• SHIFT + RMB（右键按钮）

• SHIFT + INS

输入您的 API 密钥后，如果一切顺利，您应该会收到成功消息。您也可以再次运行 connect 命令并检查 Binance 旁边的两列是否都显示 Yes 来确认。

现在您的 Binance API 密钥已连接到 Hummingbot。根据需要对其他交易所重复这些步骤。

接下来做什么？¶

如果您认真考虑深入研究并增强您的交易机器人能力，请考虑Botcamp，这是一个针对做市商和算法交易者的专业培训项目。这个全面的项目每月结合新内容模块和实时会话，帮助您了解市场的复杂性。您将学习使用 Dashboard 创建和回测做市策略、方向性交易和其他策略。

最重要的是，您将通过 Bot Battles 获得实践经验，这是 Botcamp 的月度机器人交易竞赛。这是一个衡量您的进度并向他人学习的好机会。此外，加入 Botcamp 社区可以让您扩展您的专业网络，组建团队一起竞争，并分享见解。

再次感谢您加入我们的这次旅程。希望您在这里获得的知识在您的交易事业中为您带来好运。祝您未来的交易机器人项目一切顺利！