Linux服务器上的MySQL远程连接失败,如何从监听地址到防火墙逐层排查
MySQL 远程连接失败,不能只凭“客户端连不上”就判断是防火墙问题:域名可能解析到错误地址,数据包可能到不了服务器,MySQL 也可能只监听本机地址;即使 TCP 端口可达,账号来源限制或认证配置仍可能拒绝登录。排查时应从客户端向服务器逐层确认,并根据每一步的结果缩小范围。
先记录连接使用的域名或 IP、端口、客户端所在网络、发生时间,以及完整错误信息。确认影响范围也很重要:只有一台客户端失败,优先检查这台客户端的 DNS、路由和本地策略;多个客户端同时失败,则重点检查服务器、入口网络及 MySQL 服务。下面的命令和输出均为示例,实际服务名、配置路径和防火墙管理方式可能随发行版及 MySQL 部署方式不同。
一、先按错误表现建立原因树
远程连接大致经过以下路径:
客户端地址解析 → 网络路由和入口规则 → 服务器防火墙 → MySQL 监听套接字 → MySQL 账号与认证 → 应用连接配置。
不同报错能提供线索,但通常不能单独证明根因:

| 表现或错误 | 优先检查 | 不能据此直接断定 |
|---|---|---|
Unknown MySQL server host、Name or service not known | 客户端 DNS、域名拼写、解析记录 | 服务器 MySQL 是否正常 |
Connection timed out | 路由、云平台入口规则、主机防火墙、目标地址是否正确 | 一定是服务器防火墙 |
Connection refused | 目标主机是否可达、端口是否监听、服务是否启动 | 一定是 MySQL 账号错误 |
No route to host、Network is unreachable | 客户端路由、本地网络、网关及安全策略 | MySQL 配置 |
Access denied for user | 账号、来源主机匹配、密码、认证方式 | TCP 端口不通 |
TLS/SSL 相关错误 | 客户端与服务端 TLS 要求、证书及协议设置 | DNS 或端口必然异常 |
建立判断时,先区分“无法建立 TCP 连接”和“TCP 已连通但 MySQL 拒绝登录”。前者按网络、端口和监听排查;后者转向 MySQL 账号、认证和客户端配置。
二、从客户端确认目标地址与网络路径
1. 检查域名解析
如果连接使用域名,在实际运行 MySQL 客户端的机器上查询解析结果:
getent ahosts db.example.com
也可以使用系统中已安装的 DNS 查询工具:
dig +short db.example.com
如果解析不到地址,检查域名拼写、DNS 记录及客户端当前使用的 DNS 服务器。若解析出多个地址,应逐个确认它们是否都指向预期的数据库入口;其中某个地址已下线或指向旧服务器时,应用可能表现为间歇性失败。
若连接使用 IP,则跳过 DNS 判断,但仍要确认该地址是服务器的正确访问地址。云服务器可能同时有内网 IP 和公网 IP;客户端与服务器处于同一私有网络时,通常应确认应用配置是否使用了预期的网络路径,而不是误连到另一入口。
2. 确认客户端到目标的路由和 TCP 端口
先使用目标实际端口做 TCP 连通性测试。以下以默认端口 3306 为例;若 MySQL 使用其他端口,应替换为实际值。
nc -vz -w 3 db.example.com 3306
示例结果:
Connection to db.example.com 3306 port [tcp/mysql] succeeded!
这表示 TCP 握手成功,能证明该地址的该端口当前可以建立连接,但不能证明 MySQL 账号和密码正确。若命令超时,说明连接过程没有在限定时间内完成,应继续检查网络路径和过滤规则;若立即拒绝,则重点确认目标地址上的端口是否有服务监听。
部分环境没有 nc,可使用 MySQL 客户端直接测试:
mysql --connect-timeout=5 -h db.example.com -P 3306 -u app_user -p
不要把密码直接写在命令行中,以免留在 shell 历史或进程信息里。
若客户端无法连接,且服务器有多个网卡或复杂路由,可在客户端查看路由选择:
ip route get 203.0.113.20
将示例 IP 换成目标地址。确认输出中的出口网卡、源地址和下一跳是否符合预期;服务器端也要核对返回流量是否有可用路由。仅能 ping 通不代表 MySQL 端口可达,因为 ICMP 与 TCP 可能受到不同策略控制。
三、核对入口网络与服务器防火墙
数据包到达 Linux 主机前,还可能经过云平台安全组、网络 ACL、机房边界防火墙或负载均衡等入口设施。若客户端是公网地址,而数据库仅预期接受内网访问,应先核实连接路径是否正确,不要为了快速测试就把 3306 对所有来源开放。
检查入口规则时,逐项对照:
- 规则目标是否为正确的服务器、网卡或负载均衡入口。
- 协议是否为 TCP,端口是否与 MySQL 实际端口一致。
- 来源地址是否包含客户端实际出口 IP。客户端出口 IP 可能与本机内网地址不同。
- 规则变更后是否已应用到正确实例或网络接口。
- 返回方向及相关网络 ACL 是否允许连接正常返回。
之后检查 Linux 主机上的过滤规则。先确认服务器使用哪种防火墙管理工具,不要在不清楚现有策略的情况下直接添加或清空规则:
sudo ufw status verbose
sudo firewall-cmd --state
sudo nft list ruleset
这些命令分别适用于常见的 UFW、firewalld 和 nftables 环境。并非每台机器都安装或启用这三者,也可能使用其他规则管理方式;先查看实际状态,不要把某个工具显示“未运行”当作整个系统没有包过滤规则。
如果准备调整规则,应先记录现有状态和规则来源,确认管理工具及策略由谁维护,并限定端口、来源地址和目标接口。不要使用清空规则集的方式排查。举例来说,在已确认使用 UFW、且数据库只应允许某个固定客户端地址访问时,可以按维护流程增加一条来源受限的规则:
sudo ufw allow from 198.51.100.25 to any port 3306 proto tcp
sudo ufw status numbered
这只是示例,地址须替换为客户端实际出口 IP,且应先确认不会与现有规则或上游策略冲突。变更前保存现有规则或配置;确认无误后记录变更项。若验证失败或需要撤销,应删除本次新增的对应规则,而不是重置整套防火墙。具体回滚命令依规则编号和现场规则而定,执行前再次核对编号及影响范围,避免误删其他业务规则。
用抓包区分“没到服务器”和“服务器没响应”
在有权限且符合变更管理要求时,可在服务器上短时观察目标端口流量:
sudo tcpdump -ni any 'tcp port 3306'
同时从客户端发起一次连接,随后用 Ctrl+C 结束抓包。若能看到客户端发来的 SYN,却看不到服务器返回 SYN-ACK,可继续检查本机防火墙、监听状态和系统策略;若服务器返回 RST,通常要核对端口上是否有服务监听;若服务器抓不到客户端 SYN,则排查重点应前移到客户端出口、路由、云平台或上游网络规则。抓包可能包含连接元数据,不要长时间运行或随意分享输出。
四、检查 MySQL 服务是否运行、监听地址是否正确
1. 确认服务状态和监听端口
Linux 发行版的服务名可能是 mysql 或 mysqld。可以先查询:
systemctl status mysql
systemctl status mysqld
其中一个命令报服务不存在,不等于 MySQL 没有安装;根据实际安装方式选用正确的服务单元。容器部署则还要检查容器状态、端口映射和容器内服务状态。
查看 TCP 监听:
sudo ss -lntp | grep ':3306'
可能出现的示例:
LISTEN 0 151 127.0.0.1:3306 0.0.0.0:* users:(("mysqld",pid=1234,fd=21))
这表示 MySQL 只监听回环地址,远程机器不能通过该监听地址连接。若结果为 0.0.0.0:3306,表示服务在所有 IPv4 本地地址上监听;若为服务器某个内网地址,则只接受发往该地址的连接。[::]:3306 涉及 IPv6 监听,是否同时接受 IPv4 连接还与系统和 MySQL 配置有关,不能仅凭这一行推断。
如果没有任何结果,先确认服务状态、实际端口和是否使用 Unix socket。不要在服务状态未知时盲目重启生产数据库。
2. 核对 MySQL 配置
配置文件位置会因发行版、安装方式和版本而异。可从 MySQL 客户端查询部分运行时设置:
SHOW VARIABLES LIKE 'port';
SHOW VARIABLES LIKE 'bind_address';
SHOW VARIABLES LIKE 'skip_networking';
如果本机没有可用的 MySQL 登录方式,可检查配置文件中 mysqld 相关段落。常见位置包括 /etc/mysql/、/etc/my.cnf 及其包含目录,但不要假设某个路径对所有系统都适用。也可以检查服务启动参数和日志,以确认实际加载的配置。
关注三个设置:
port:服务实际使用的 TCP 端口。bind_address:MySQL 绑定的本地地址。只绑定127.0.0.1时不接受远程 TCP 连接。skip_networking:启用时会禁用 TCP 网络连接,具体效果应结合版本和启动配置确认。
需要修改监听配置时,先备份对应配置文件,并记录原值;同时确认服务器有可用的管理通道,避免改动后失去数据库访问能力。将监听范围改为指定内网 IP,通常比监听所有地址更容易控制暴露范围。只有在了解网络边界、访问规则和安全要求后,才考虑监听所有接口。修改后按本机的维护流程重启或重新加载服务,并观察服务状态及错误日志;重启会影响正在使用该数据库的连接,应安排在可接受的维护窗口内。若配置错误导致服务无法启动,恢复备份文件并按原方式启动服务。
查看日志时,可先尝试:
sudo journalctl -u mysql --since "30 minutes ago"
sudo journalctl -u mysqld --since "30 minutes ago"
如果服务将日志写入独立文件,应依据实际配置查找。日志中的配置解析错误、端口占用、权限问题或启动失败信息,往往能解释为什么没有建立预期监听。
五、TCP 可达后检查 MySQL 账号与应用连接
1. 账号的来源主机是否匹配
MySQL 账号不是只有用户名,通常还要匹配来源主机。'app_user'@'localhost' 与 'app_user'@'10.0.2.15' 是不同的账号定义。远程连接时,即使用户名正确,服务器上也可能没有匹配该来源地址的账号,或者该账号权限不足。
在有权限的管理会话中,可以先查看账号定义和授权:
SELECT user, host
FROM mysql.user
WHERE user = 'app_user';
SHOW GRANTS FOR 'app_user'@'10.0.2.15';
示例中的来源主机应替换为实际授权对象;如果不确定 MySQL 识别到的来源地址,应结合网络路径和服务端日志核实。不要通过直接修改系统表来修复授权。新增或调整账号前,先确认数据库实例、用户名、来源范围和业务权限,并保留现有授权信息供回滚。生产环境不要为了测试而授予全库、全表或所有来源的权限。
远程连接成功后,再按应用需要授予最小权限。授权调整会改变数据库访问范围,应在确认目标数据库和账号后执行,并通过 SHOW GRANTS 复核。
2. 区分密码、认证插件与 TLS 问题
如果报错为 Access denied,先核对实际连接的用户名、密码、来源地址以及应用是否加载了正确的配置文件或密钥。不要在日志、工单或聊天记录中公开密码。若客户端和服务端使用不同版本,还应检查认证插件是否兼容;以服务端账号定义、MySQL 错误日志和客户端完整报错为依据判断,不要未经确认就更改账号认证方式。
如果错误明确涉及 SSL/TLS,再核对服务端是否要求加密、客户端是否启用了相应选项,以及证书、CA 文件路径和证书名称是否匹配。不要为绕过证书错误而关闭验证,尤其是连接经过不可信网络时。先确认客户端实际使用的连接参数,再与服务端的 TLS 配置对应检查。
3. 检查中间转发和应用配置
如果连接经过负载均衡、数据库代理、端口映射或容器网络,客户端测试的目标端口可能不是 MySQL 主机的本地 3306。应分别核对外部入口端口、转发目标地址和目标端口,并确认入口是否把流量转发到了正确实例。对于容器,还要区分容器内监听地址、宿主机发布端口及容器网络规则。
命令行能够连接但应用仍失败时,重点检查应用的数据库主机、端口、账号、数据库名、TLS 选项、连接池配置和运行环境中的实际密钥来源。还应确认应用所在主机的出口地址与刚才测试的客户端一致。命令行测试成功并不证明应用使用了相同的网络、DNS 或凭据。
面向需要承载 MySQL、业务后台和接口服务的场景,A5idc数据提供中国香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器资源,覆盖常规建站、AMD计算、存储、多IP及不同带宽线路方案。部分配置采用SSD或NVMe存储并配备较大内存,可作为数据库与多任务应用的基础;结合CN2、国际及地区线路选项,支持按访问区域和网络路径规划部署环境。
六、定位后按风险处理,并验证恢复
建议按照从低风险到高风险的顺序处理:先确认域名和目标地址,再测试 TCP 端口,接着核对入口规则、主机防火墙和监听状态,最后才调整 MySQL 配置或账号。每次只改变一个主要因素,并记录变更前后的结果,避免同时修改 DNS、防火墙、监听和授权,导致根因难以追溯。
恢复后至少完成以下验证:
- 在原失败客户端上,使用实际域名和端口再次测试 TCP 连通性。
- 使用应用对应的账号执行一次真实登录或受控查询,确认不是只恢复了端口。
- 检查 MySQL 服务状态、监听地址和错误日志,确认没有因配置变更引入新的异常。
- 从未授权来源确认访问仍被阻止,验证防火墙及账号来源限制没有被扩大。
- 观察应用连接池、连接错误率和数据库连接数,确认恢复不是短暂现象。
若问题只在负载高峰或一段时间后出现,还要观察连接数、连接池耗尽、文件描述符限制、网络丢包及服务端错误日志。MySQL 端口可达但连接频繁失败时,持续性指标往往比一次性连通测试更有诊断价值。
七、设置复发监控点
为减少同类故障的排查时间,可监控数据库入口的 DNS 解析结果、指定来源到目标端口的 TCP 可达性、MySQL 服务状态、监听端口和连接错误率。对云平台入口规则、防火墙、MySQL 配置及授权变更保留记录,便于将故障开始时间与近期变更对照。
监控探测应使用受控账号和最小权限,并避免把密码写入脚本参数或普通日志。公网数据库入口尤其要关注来源范围是否发生意外扩大。只有同时跟踪“网络是否到达”和“MySQL 是否成功认证”,才能区分入口故障与应用认证故障,避免把两类问题混为一谈。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/6560.html



