如何从GitHub特性分支安装支持ClickHouse的Flyway？

安全阿岳

2026-7-13

安装支持ClickHouse的Flyway特性分支版本（MacOS环境）

因为brew仅能安装Flyway官方发布的稳定版本，不包含这个带ClickHouse支持的特性分支代码，所以需要手动从源码构建：

1. 准备依赖环境
先安装JDK（11及以上版本）和Maven：
```
brew install openjdk maven
```
配置JAVA_HOME（路径可通过brew info openjdk查看，根据实际安装版本调整）：
```
export JAVA_HOME=/usr/local/opt/openjdk/libexec/openjdk.jdk/Contents/Home
```
2. 克隆并切换到特性分支
拉取对应代码仓库，切换到支持ClickHouse的分支：
```
git clone https://github.com/f1yegor/flyway.git
cd flyway
git checkout clickhouse-support
```
3. 构建Flyway
用Maven编译打包，跳过测试环节加快构建速度：
```
mvn clean install -DskipTests
```
4. 部署构建好的Flyway
构建完成后，flyway-commandline/target目录下会生成命令行工具压缩包，解压到本地目录：
```
unzip flyway-commandline/target/flyway-*-commandline.zip -d ~/flyway-clickhouse
```
5. 配置环境变量
把Flyway的可执行目录添加到系统PATH，方便全局调用。编辑你的shell配置文件（比如~/.zshrc或~/.bashrc）：
```
echo 'export PATH="$HOME/flyway-clickhouse/flyway-*/bin:$PATH"' >> ~/.zshrc
```
生效配置：
```
source ~/.zshrc
```
6. 验证与配置ClickHouse支持
运行以下命令确认安装成功：
```
flyway -v
```
配置Flyway连接ClickHouse时，在flyway.conf中设置：
```
flyway.url=jdbc:clickhouse://localhost:8123/your_database_name
flyway.driver=com.clickhouse.jdbc.ClickHouseDriver
flyway.user=your_username
flyway.password=your_password
```
同时需要下载ClickHouse的JDBC驱动jar包，放到Flyway安装目录下的drivers文件夹中。