SQL Server数据库连接超时：VPN正常但SSH端口转发失败

核心排查方向 #

1. 端口转发目标地址配置错误 #

确认Net::SSH::Gateway.open()的目标主机参数：

• 端口转发逻辑是gateway.open(目标主机, 目标端口, 本地绑定端口)，这里的目标主机必须是SSH跳板机视角可访问的SQL Server地址（即192.168.x.x），而非你本地VPN视角的地址。
• 对比PostgreSQL的配置：如果连PostgreSQL时填的是跳板机能访问的地址，而SQL Server填错了，跳板机无法找到目标数据库，必然超时。

2. SQL Server监听绑定限制 #

老旧SQL Server可能存在IP访问限制：

• 登录SQL Server服务器，打开SQL Server配置管理器，检查SQL Server网络配置→TCP/IP协议，确认IP地址列表包含跳板机IP，或设置为0.0.0.0（允许所有IP访问）。
• 检查SQL Server所在服务器的防火墙规则，确认允许跳板机IP访问数据库端口（默认1433）。

3. 端口绑定冲突或自动分配问题 #

• 排查本地端口是否被占用：用lsof -i :本地端口号（Mac/Linux）或netstat -ano | findstr :本地端口号（Windows）检查，避免端口冲突。
• 尝试指定固定本地端口，而非让Net::SSH自动分配，示例：

  gateway.open('192.168.x.x', 1433, 14330) # 本地绑定14330端口
  

  对应database.yml中端口设为14330，再测试连接。

4. Rails SQL Server适配器参数调整 #

SQL Server适配器（如activerecord-sqlserver-adapter）可能需要特殊配置：

• 延长超时时间：在database.yml中添加timeout: 30000（30秒）。
• 关闭加密连接：老旧SQL Server通常不支持加密，添加encrypt: false或trust_server_certificate: true，示例配置：

  development:
    adapter: sqlserver
    host: 127.0.0.1
    port: 14330
    database: your_db_name
    username: your_username
    password: your_password
    timeout: 30000
    encrypt: false
  

5. SSH跳板机转发权限限制 #

• 检查跳板机的sshd_config文件，确认开启AllowTcpForwarding yes和GatewayPorts yes，若为no则端口转发失效。
• 手动用SSH命令测试转发：

  ssh -L 14330:192.168.x.x:1433 跳板机用户名@跳板机IP
  

  再用SQL Server客户端（如sqlcmd）连接127.0.0.1,14330，若手动转发也失败，问题不在Rails配置，而是跳板机或SQL Server的网络设置。

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