在 Debian/Ubuntu 上完整安装 Zenbot:Node.js 加密货币交易机器人部署实战指南

原创2026-09-25 23:00:461,954 阅读
文章标签:金融科技后端

在 Debian/Ubuntu 上完整安装 Zenbot:Node.js 加密货币交易机器人部署实战指南

Zenbot 是一款基于 Node.js 与 MongoDB 的命令行加密货币交易机器人,支持十余家主流交易所、历史数据回测、纸交易(paper trading)与全自动技术分析策略。本文以 docs/installation/debian-ubuntu.md 为骨架,结合仓库内 zenbot.js、boot.js、conf-sample.js 与 package.json 等源码,完整讲解在 Ubuntu 20.04 及 Debian 系操作系统上从零安装、配置 MongoDB、验证运行 Zenbot 的每一步,读完即可在本机搭建起可用的交易机器人环境。

安装前须知:Zenbot 的运行环境与依赖

根据 docs/installation/requirements.md,运行 Zenbot 的硬性要求只有三条:

  • 操作系统:Linux / macOS 10 / Windows(或用 Docker 运行);
  • Node.js:版本 8.3.0 或更高;
  • MongoDB:任意可用版本。

同时文档给出一个实操建议:尽量使用 64 位处理器与 64 位操作系统,因为 32 位系统会把数据库容量限制在 2GB 以内,回填(backfill)大量历史行情数据时容易成为瓶颈。

Node.js 的版本要求并非空谈,zenbot.js 在进程启动的第一时间就会做硬性检查:

var versions = process.versions
if (semver.gt('8.3.0', versions.node)) {
  console.log('You are running a node.js version older than 8.3.x, please upgrade via https://nodejs.org/en/')
  process.exit(1)
}

也就是说,如果本机 Node 版本低于 8.3.0,机器人会直接拒绝启动并提示升级。package.json 中 engines 字段进一步声明 node >= 10.0.0,因此在新版本操作系统上建议直接安装当前可用的较新 Node 版本(文档中的 setup_15.x 即来源于此思路,见下文)。

基于 apt 的完整安装流程(官方核心步骤)

debian-ubuntu.md 给出的完整命令序列如下,它最初针对 Ubuntu 20.04 编写,同样适用于 Debian 系发行版:

sudo apt-get install curl python2 git build-essential mongodb nodejs

curl -sL https://deb.nodesource.com/setup_15.x | sudo -E bash -

sudo apt-get update
sudo apt-get upgrade -y

sudo apt-get install curl python2 git build-essential mongodb nodejs

git clone https://github.com/deviavir/zenbot.git
cd zenbot

npm install

./zenbot.sh --help

逐段拆解其含义:

  1. 安装基础工具链:curl 用于下载 NodeSource 仓库脚本;git 用于克隆项目源码;build-essential 提供编译工具链,Zenbot 依赖的 talib、tulind 等技术指标原生库在 npm install 时需要本地编译;mongodb 与 nodejs 则来自发行版自带仓库。
  2. 接入 NodeSource 仓库:setup_15.x 脚本会把 Node 15.x 的 apt 源注册到系统中并立即更新包索引,这一步确保后续 apt-get install nodejs 拿到的是新版本,而不是发行版内置的过时版本。若你的发行版较新,可将 15.x 替换为当前受支持的 Node LTS 主版本(需不低于 8.3.0)。
  3. 刷新与升级系统包:apt-get update 同步新加入源后的包索引,apt-get upgrade -y 将已安装包统一升级,避免新旧包版本冲突。
  4. 再次安装依赖:仓库源更新后重跑 apt-get install,此时 nodejs 会解析为 NodeSource 提供的新版本。
  5. 克隆并安装项目:git clone 拉取源码后进入目录执行 npm install 安装全部依赖;npm 会在安装完成后自动执行 postinstall 钩子(见 package.json),该钩子由 post_install.js 实现,负责用 webpack 打包 WebApp 组件并安装 scripts/genetic_backtester/ 下的遗传回测器依赖。
  6. 验证安装:./zenbot.sh --help 打印所有可用命令。该脚本内容极简(zenbot.sh):
#!/bin/sh
env node zenbot.js $@

即用 env node 以当前 Node 环境执行 zenbot.js,并把参数原样透传。

获取源码的另一种方式:wget 下载压缩包

如果目标机器没有安装 git,或希望跳过 git 元数据,docs/installation/README.md 提供了等价方案:

wget https://github.com/deviavir/zenbot/archive/master.tar.gz
tar -xf zenbot-master.tar.gz
mv zenbot-master zenbot

解压后进入 zenbot 目录,后续步骤与 git 克隆方式完全一致。

创建并理解配置文件 conf.js

安装完依赖后,第一步是生成配置文件:

cp conf-sample.js conf.js

conf-sample.js 是仓库自带的默认配置模板,conf.js 才是运行时真正读取的配置。boot.js 揭示了二者的合并机制:启动时依次加载命令行 --conf 指定的覆盖文件、根目录 conf.js(缺失则告警并回退)、以及 conf-sample.js 作为默认值,通过 _.defaultsDeep 逐层合并,因此 conf.js 只需填写需要修改的项。

两种运行模式

  • 纸交易(paper trading)模式:conf.js 保持原样即可直接运行。机器人会用模拟余额观察真实行情并模拟下单,是验证策略最安全的入口;
  • 真实交易模式:必须为使用的交易所填入 API 密钥。官方文档特别强调:API 密钥不需要充值/提现(deposit/withdrawal)权限,只读行情与交易权限就足够,从安全角度也不建议授予更多权限。

MongoDB 连接配置详解

conf-sample.js 开头即 MongoDB 配置块(conf-sample.js),全部支持通过环境变量覆盖:

配置项 环境变量 默认值 说明
c.mongo.db ZENBOT_MONGODB_DATABASE zenbot4 数据库名
c.mongo.connectionString ZENBOT_MONGODB_CONNECTION_STRING null 完整连接串;提供后不再需要 host/port 等
c.mongo.host ZENBOT_MONGODB_HOST localhost MongoDB 主机地址
c.mongo.port ZENBOT_MONGODB_PORT 27017 MongoDB 端口
c.mongo.username ZENBOT_MONGO_USERNAME null 用户名(可选)
c.mongo.password ZENBOT_MONGO_PASSWORD null 密码(可选)
c.mongo.replicaSet ZENBOT_MONGO_REPLICASET null 副本集名称,单机部署保持默认
c.mongo.authMechanism ZENBOT_MONGO_AUTH_MECHANISM null MongoDB 认证机制,如 SCRAM-SHA-1

对应地,boot.js 会按以下优先级构造连接串:优先使用 c.mongo.connectionString;否则拼接 mongodb://user:pass@host:port/db,并附带 replicaSet 与 authMechanism 查询参数。若 MongoDB 未启动或连接失败,机器人会打印 WARNING: without MongoDB some features (such as backfilling/simulation) may be disabled. 警告后继续启动,但回填与模拟功能将不可用(boot.js)。

其他常用配置

同一文件中还包含交易行为参数,可按需调整:

  • 止损相关:c.sell_stop_pct(跌破买入价多少百分比卖出,0 禁用)、c.buy_stop_pct、c.profit_stop_enable_pct / c.profit_stop_pct(移动止盈);
  • 订单执行:c.order_type(maker / taker)、c.post_only、c.max_slippage_pct、c.buy_pct / c.sell_pct(默认 99%)、c.order_adjust_time、c.order_poll_time;
  • 模拟与行情:c.currency_capital(默认 1000)、c.asset_capital(默认 0)、c.days(默认回填 14 天)、c.poll_trades(默认 30 秒)、c.avg_slippage_pct;
  • 默认交易对与策略:c.selector(默认 gdax.BTC-USD)、c.strategy(默认 trend_ema)。

完整默认值可随时查看 conf-sample.js,其中每个字段都带有注释说明。

安装依赖与注册全局命令

cd zenbot
npm install

这一步骤会拉取 package.json 中声明的全部依赖(含 ccxt、mongodb、commander、tulind、talib 等),并在结束时触发 postinstall 打包 WebApp 与遗传回测器组件,耗时取决于网络与 CPU。

若希望在任意目录直接使用 zenbot 命令而非 ./zenbot.sh,可选执行:

npm link

npm link 会把 package.json 中 bin 字段指向的 ./zenbot.sh 软链到全局,之后即可:

zenbot --help

安装 MongoDB 的注意事项

apt-get install mongodb 安装的是发行版仓库中的 MongoDB 版本,足以支撑本地开发与回测。安装后确认服务已启动:

sudo systemctl status mongodb     # 查看服务状态
sudo systemctl start mongodb      # 未启动时手动拉起

默认情况下 Zenbot 会连接 localhost:27017 上的 zenbot4 数据库,因此无需任何额外初始化操作即可让回填、模拟等依赖数据库的功能正常工作。若你是通过 Docker 运行的 MongoDB 或使用了云数据库,则需在 conf.js 中通过 connectionString 或 host/port/username/password 指向正确地址。

安装验证与常见问题排查

完成上述步骤后,用下面的命令确认环境就绪:

./zenbot.sh --help          # 打印全部可用命令
./zenbot.sh list-selectors  # 列出所有支持的交易对(需 MongoDB 正常)
./zenbot.sh list-strategies # 列出内置策略

常见的安装期问题与应对:

  • Node 版本过低:启动时提示 You are running a node.js version older than 8.3.x,说明系统 Node 太旧。重跑 curl -sL https://deb.nodesource.com/setup_15.x | sudo -E bash - 后再 apt-get install nodejs 升级,或改用 docs/installation/README.md 中的安装流程。
  • MongoDB 连接失败:启动时出现 WARNING: MongoDB Connection Error,先检查 mongod 进程与 27017 端口监听,再核对 conf.js 中数据库地址与认证信息(boot.js 会打印实际尝试的连接串,便于定位)。
  • python2 包不可用:Ubuntu 20.04 及更新版本的默认仓库中 python2 包可能已移除。若 apt-get install 报错,可将其从安装列表中去掉,Zenbot 本体并不依赖 Python 运行,python2 仅服务于个别历史脚本场景。
  • 依赖编译失败:build-essential 未安装会导致 talib/tulind 等原生模块编译失败,重新安装该包后清空 node_modules 再 npm install 即可。

Docker 部署:跳过系统级安装的替代方案

若不想污染宿主机环境,官方提供了一等一的 Docker 支持(详见 docs/installation/docker.md)。在完成 git clone 获取源码后:

cd zenbot
docker-compose up    # 加 -d 可后台运行

容器启动成功后,通过 docker-compose exec 执行机器人命令:

docker-compose exec server zenbot list-selectors
docker-compose exec server zenbot backfill <selector> --days <days>

更新镜像时执行 docker pull deviavir/zenbot:unstable 后重新 docker-compose up -d 即可。Windows 用户使用 docker-compose --file=docker-compose-windows.yml up。关于 Docker 的完整说明可参考 docker-compose.yml 与 Dockerfile。

安装完成后的下一步

环境就绪后,建议按以下顺序开始实战:

  1. 查看命令总览:./zenbot.sh --help,命令定义位于 commands/ 目录(trade、sim、backfill、buy、sell、balance 等);
  2. 回填历史数据:./zenbot.sh backfill <selector> --days <days>,为所选交易对下载行情,流程细节见 commands/backfill/;
  3. 运行模拟回测:./zenbot.sh sim <selector>,先用 conf-sample.js 中的模拟资金(默认 1000 货币)验证策略表现;
  4. 纸交易观察:./zenbot.sh trade <selector> --paper,用模拟余额观察实时行情下的策略行为;
  5. 填入真实 API 密钥:确认策略与参数后,在 conf.js 中为所选交易所(如 gdax、binance、kraken 等)填入仅含交易权限的密钥,再切换真实交易。

安装与配置是整个 Zenbot 体系中门槛最低、但也最容易被忽略的一环——Node 版本、MongoDB 连接串、API 权限三者任一出错都会直接影响后续回测与交易的可靠性,建议对照本文逐步核验后再进入策略调试阶段。

登录后查看全文
zenbot