配置MySQL Workbench连接AWS Bitnami实例及SSH连接故障求助

我之前在Bitnami WordPress实例上也碰到过几乎一模一样的问题，给你几个排查和解决的方向，应该能搞定：

• 确认MySQL root密码（别和WordPress admin密码搞混）
  很多人会误以为Bitnami的MySQL root密码就是WordPress管理员密码，但实际上两者是完全分开的。你可以登录到SSH实例后，执行以下命令查看专属的MySQL root密码：

  cat /home/bitnami/bitnami_credentials
  

  输出内容里会明确标注MySQL root password，用这个密码去尝试连接，这是最常见的出错原因。

• 验证SSH隧道的可用性
  先绕开MySQL Workbench，用命令行测试隧道是否能正常建立并连接MySQL：

  1. 在本地终端执行端口转发命令：

     ssh -L 3307:127.0.0.1:3306 bitnami@IP-Address -i my_key_file
     

  2. 保持这个窗口打开，另开一个本地终端，尝试连接MySQL：

     mysql -h 127.0.0.1 -P 3307 -u root -p
     

     如果这个连接成功，说明隧道和MySQL本身没问题，问题出在MySQL Workbench的配置细节上；如果失败，继续往下排查。

• 检查MySQL服务状态与绑定地址

  1. 登录SSH实例后，确认MySQL服务是否正常运行：

     sudo /opt/bitnami/ctlscript.sh status mysql
     

     如果显示未运行，执行启动命令：

     sudo /opt/bitnami/ctlscript.sh start mysql
     

  2. 检查MySQL配置是否绑定了127.0.0.1（确保只能通过本地/隧道访问）：
     查看配置文件内容：

     cat /opt/bitnami/mysql/my.cnf
     

     找到bind-address字段，确认值为127.0.0.1，如果是其他值（比如实例公网IP），可能会导致隧道连接失败。

• 调整SSH密钥文件权限
  密钥文件权限过宽会被SSH客户端拒绝，这在Linux/macOS上尤为常见：
  在本地终端执行：

  chmod 600 <path-to-key-file>
  

  Windows用户则需要右键密钥文件→属性→安全→高级，确保只有当前用户拥有读取权限，删除其他用户的权限条目。

• 检查MySQL root用户的访问权限
  虽然隧道连接属于本地访问，但偶尔会出现root用户权限限制的情况：

  1. 登录SSH实例后，进入MySQL命令行：

     mysql -u root -p
     

     输入之前从bitnami_credentials获取的密码。
  2. 查看root用户的允许访问主机：

     SELECT user, host FROM mysql.user WHERE user = 'root';
     

     如果结果里没有localhost或127.0.0.1，执行以下命令添加权限：

     GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY '你的MySQL root密码' WITH GRANT OPTION;
     FLUSH PRIVILEGES;
     

按照上面的步骤逐一排查，大概率能解决你的连接问题。

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