WhoDB 数据库连接配置支持自定义端口的技术解析

背景

WhoDB 作为一款数据库管理工具，其环境变量配置方式原本通过 JSON 格式支持多数据源连接，但在早期版本中缺失了对自定义端口的支持。这在需要连接非标准端口（如 MySQL 的 13306 或 PostgreSQL 的高端口）的数据库场景中存在明显限制。

技术演进

最新版本通过代码更新完善了这一功能，现在用户可以在环境变量配置中显式指定端口参数。以下是典型配置示例的演进对比：

原始配置（无端口支持）

WHODB_MYSQL: '[{"host":"localhost","user":"user","password":"password","database":"mysql"}]'

新版配置（支持端口参数）

WHODB_MYSQL: '[{
  "host":"localhost",
  "user":"user",
  "password":"password",
  "database":"mysql",
  "port": 13306
}]'

实现原理

该功能的实现涉及 WhoDB 核心连接模块的改造：

1. 配置解析层：增强 JSON 解析器，识别新增的 port 字段
2. 连接池构建：将端口参数传递到底层数据库驱动（如 pg、mysql2 等）
3. 向后兼容：当未指定端口时，自动回退到数据库默认端口（MySQL 3306，PostgreSQL 5432）

应用场景

此特性特别适用于：

• 开发环境需要隔离多实例的场景
• 企业级安全策略要求使用非标准端口
• 容器化部署时端口映射的特殊配置
• 云数据库服务通常提供的随机端口

最佳实践建议

1. 对于生产环境，建议将端口配置与敏感信息一起纳入 secrets 管理
2. 使用 Docker 时可通过环境变量注入动态端口：

environment:
  WHODB_POSTGRES: '{
    "host":"db.prod.example",
    "port":${DB_PORT},
    "user":"${DB_USER}",
    "password":"${DB_PASS}" 
  }'

3. 端口参数应配合 TLS/SSL 配置共同使用，确保非标准端口的安全性

总结

WhoDB 对自定义端口的支持完善了其作为多数据库管理工具的适用性，使开发者能够更灵活地适配各种基础设施环境。该特性已通过完整测试并合并到主分支，用户更新至最新版本即可使用。