如何在flyway.conf中配置自定义HTTP代理连接需代理访问的数据库

Flyway 本身没有内置专门的数据库连接代理业务参数，所有网络代理能力完全基于运行它的 JVM 环境透传——你在 SQL Developer 里配置的自定义代理本质是JVM层面的网络转发规则，只需要把这套规则透传给跑 Flyway 的JVM进程，就能实现连通。

所有JVM层面的网络相关参数，都可以通过flyway.java.property.前缀写在flyway.conf中，Flyway CLI 启动时会自动将这些参数转换为对应的JVM系统属性生效，无需手动修改启动脚本：

• HTTP/HTTPS 代理基础转发参数
  • flyway.java.property.http.proxyHost：填写自定义代理的主机地址，和你SQL Developer中配置的代理主机保持一致
  • flyway.java.property.http.proxyPort：填写自定义代理的监听端口
  • flyway.java.property.https.proxyHost：HTTPS链路下的代理主机地址，和HTTP代理配置保持一致即可
  • flyway.java.property.https.proxyPort：HTTPS链路下的代理端口，和HTTP代理配置保持一致即可
• 代理身份认证参数（如果你的自定义代理需要账号密码鉴权）
  • flyway.java.property.http.proxyUser：代理鉴权使用的用户名
  • flyway.java.property.http.proxyPassword：代理鉴权使用的密码
• 代理绕过规则
  因为你同时存在可直连的database1，必须将其加入绕过列表，避免它的流量被强制转发到代理导致连通失败：
  • flyway.java.property.http.nonProxyHosts：配置无需走代理的目标地址，多个地址用|分隔，将database1的完整主机地址、本地回环地址都加入该列表。

以本地启动的自定义代理（地址127.0.0.1、端口8080，鉴权账密为flyway/proxy123）、database1直连地址为db1.company.internal为例，可直接粘贴到flyway.conf的配置片段如下：

# 配置HTTP/HTTPS代理转发
flyway.java.property.http.proxyHost=127.0.0.1
flyway.java.property.http.proxyPort=8080
flyway.java.property.https.proxyHost=127.0.0.1
flyway.java.property.https.proxyPort=8080

# 配置代理鉴权
flyway.java.property.http.proxyUser=flyway
flyway.java.property.http.proxyPassword=proxy123

# 配置代理绕过规则，database1直连不走代理
flyway.java.property.http.nonProxyHosts=localhost|127.0.0.1|db1.company.internal

• 不要尝试把代理参数拼接在数据库连接URL中：主流数据库驱动（Oracle、PostgreSQL、MySQL等）的原生连接格式不支持自定义HTTP代理的参数格式，这也是之前无法连通database2的核心原因——仅配置数据库连接地址没有透传JVM代理规则。
• 如果你使用的是SOCKS类型的代理，只需要将对应参数替换为socksProxyHost、socksProxyPort，同样通过flyway.java.property.前缀透传即可。
• 配置完成后可先执行flyway info做连通性校验，能正常读取database2的Schema版本元数据就代表配置生效；同时要同步验证database1的直连能力，避免因为代理绕过规则配置缺失导致原有直连链路失效。

内容的提问来源于stack exchange，提问作者Ram