pgAdmin4中通过JSON导入服务器时指定SSH身份文件路径的方法

在数据库管理工具pgAdmin4的使用过程中，管理员经常需要批量导入服务器配置。pgAdmin4提供了通过JSON文件导入服务器配置的功能，但在某些特定场景下，官方文档中描述的JSON格式存在不足。

问题背景

当用户需要通过SSH隧道连接PostgreSQL服务器时，通常需要指定身份认证文件（Identity File）。然而，在pgAdmin4 8.13版本的官方文档中，JSON格式说明并未包含用于指定SSH身份文件路径的字段。这导致用户在通过JSON文件导入服务器配置时，无法预先设置SSH身份文件路径，只能在导入后手动配置，降低了工作效率。

解决方案

经过开发团队的确认和修复，现在可以在JSON配置文件中使用TunnelIdentityFile字段来指定SSH身份文件的路径。这是一个合法的JSON配置示例：

{
  "Servers": {
    "1": {
      "Name": "My Server",
      "Host": "db.example.com",
      "Port": 5432,
      "MaintenanceDB": "postgres",
      "Username": "postgres",
      "SSLMode": "prefer",
      "TunnelAuthentication": 1,
      "TunnelIdentityFile": "/path/to/identity_file.pem"
    }
  }
}

技术细节

1. TunnelAuthentication：设置为1表示使用SSH隧道认证
2. TunnelIdentityFile：指定SSH身份文件的完整路径
3. 文件路径可以是绝对路径或相对路径，但建议使用绝对路径以确保可靠性

使用场景

这种方法特别适用于以下场景：

• 批量部署多台服务器配置
• 自动化运维脚本中
• 团队共享标准化的服务器配置
• 需要频繁重建开发环境的情况

注意事项

1. 确保指定的身份文件路径在目标系统上有效
2. 身份文件应设置适当的权限（通常为600）
3. 对于Windows系统，路径应使用双反斜杠或正斜杠
4. 导入前建议先验证JSON文件的语法正确性

此功能的添加显著提升了pgAdmin4在复杂网络环境下的配置管理能力，使数据库管理员能够更高效地完成服务器配置的批量部署工作。