下载 dbbot

dbbot 通过单一 GitHub 仓库和单一发行包分发，其中包含 MySQL、ClickHouse 和监控相关子目录。

方法一：下载发行版（推荐）

适用场景：生产环境、离线安装、版本可追溯。

请下载 release 资产 dbbot-${dbbot_version}.tar.gz，不要使用 GitHub 发布页默认提供的 Source code (tar.gz/zip)。后者是源码快照，适合查看源码或参与开发，不适合作为本文的直接部署输入。

dbbot_version="$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/fanderchan/dbbot/releases/latest)")"
wget "https://github.com/fanderchan/dbbot/releases/download/${dbbot_version}/dbbot-${dbbot_version}.tar.gz"
tar -zxvf "dbbot-${dbbot_version}.tar.gz" -C /usr/local/

如果你需要可复现安装，请把 releases/latest 换成固定 tag，或直接手工指定 dbbot_version。

发布页：https://github.com/fanderchan/dbbot/releases

解压后常见目录：

• bin/dbbotctl
• mysql_ansible
• clickhouse_ansible
• monitoring_prometheus_ansible
• portable-ansible-v0.5.0-py3

官方发行包还会包含控制节点 CLI dbbotctl。解压到 /usr/local/dbbot 后，建议先做本地环境校验，再执行 playbook：

/usr/local/dbbot/bin/dbbotctl version
/usr/local/dbbot/bin/dbbotctl doctor

后续如需升级发行包，建议统一通过 dbbotctl release upgrade 执行，而不是手工删除旧目录再回拷配置。完整流程见：dbbot 升级与回滚。

方法二：克隆源码仓库

如果你需要的是完整源码仓库，请直接 git clone，不要把 GitHub 发布页里的 Source code 归档当作发行包使用。

适用场景：提前体验新功能、跟踪修复、参与协作。

cd /usr/local
git clone https://github.com/fanderchan/dbbot
cd dbbot

建议根据你的实际环境切换到对应分支或 tag 后再使用。

下一章：部署 dbbot 和配置 Ansible