场景导入：为什么你的 n8n 连不上数据库？
作为 N8N大学 的首席主编，我见过太多新手在配置数据库连接时卡住。明明数据库就在那里，但在 n8n 的 MySQL 节点里测试连接却总是报错，或者连上了却读不出数据。
这种痛苦我懂。当你满怀期待地想要自动化数据同步，却被冷冰冰的 "Connection refused" 或 "Access denied" 挡在门外，那种挫败感足以浇灭刚燃起的热情。
其实，连接本地 MySQL 和远程 MySQL，看似只是 IP 地址的区别，实则涉及网络架构、权限验证和安全策略的深层差异。今天，笔者就带你彻底搞懂这两者的实战差异，让你少走弯路。
核心痛点：本地 vs 远程，到底差在哪？
很多同学以为只要数据库用户名密码正确，n8n 就一定能连上。这是一个巨大的误区。连接的本质是网络通信，而通信取决于“路”是否通畅。
本地连接（Localhost） 通常指 n8n 服务和数据库服务运行在同一台机器或同一个 Docker 网络内。这里的关键是“监听地址”和“Socket 文件”。
远程连接（Remote） 则意味着 n8n 服务和数据库服务在不同的机器上。这里的关键是“防火墙”、“端口开放”和“用户主机限制”。
理解了这个底层逻辑，我们才能对症下药。
实战差异一：连接本地 MySQL
如果你的 n8n 是用 Docker 部署的，且 MySQL 也在同一个宿主机上，这里最容易踩坑。
1. Host 字段的玄机
在 n8n 的 MySQL 节点配置中，Host 字段至关重要。
- 如果 n8n 和 MySQL 都在 Docker 容器中：使用
mysql（容器名）或mysql（Docker Network 别名）。 - 如果 n8n 在 Docker 中，MySQL 在宿主机上：这里是个大坑！你不能用
localhost，因为容器里的 localhost 指向容器自己。此时应使用宿主机的局域网 IP（如192.168.1.100）。
2. 端口与 Socket
默认端口是 3306。但如果你的 MySQL 配置了 Socket 连接，n8n 节点可能无法直接通过 TCP/IP 访问。对于本地连接，只要 IP 正确且端口未被防火墙拦截，通常连接速度极快。
实战差异二：连接远程 MySQL
连接远程数据库（如阿里云 RDS、腾讯云 CDB 或自建 VPS）是生产环境的常态，也是报错的重灾区。
1. 防火墙与安全组
这是 90% 的连接失败原因。云服务商通常有双重防火墙：
- 云平台安全组： 必须在控制台放行 n8n 所在服务器的 IP，或者直接放行公网 IP 段（0.0.0.0/0，不推荐）访问 3306 端口。
- 服务器内部防火墙： 检查 iptables 或 ufw 是否允许 3306 入站。
2. 用户权限限制
MySQL 默认只允许 root@localhost 本地访问。如果你在远程连接，必须创建一个允许指定 IP 或所有 IP 访问的用户：
GRANT ALL PRIVILEGES ON your_db.* TO 'n8n_user'@'%' IDENTIFIED BY 'your_password';注意这里的 '%'，它代表允许任何主机连接。在生产环境中，建议将其替换为 n8n 服务器的具体公网 IP，以提高安全性。
避坑指南：N8N 节点配置的常见报错
在配置 n8n 的 MySQL 节点时，以下两个报错你一定见过。
Error: connect ECONNREFUSED
含义： 连接被拒绝。
原因： 路不通。要么 IP 错了，要么端口没开，要么数据库根本没监听该 IP。
解决： 使用 telnet [ip] 3306 命令测试连通性。如果在 n8n 服务器上无法 telnet 通，绝对不是 n8n 的问题，先去修网络。
Error: ER_ACCESS_DENIED_ERROR
含义： 访问被拒绝。
原因： 用户名密码错误，或者该用户没有从当前 IP 连接的权限。
解决： 检查 n8n 节点里的 Credentials 是否多打了空格。如果是远程连接，确认 MySQL 用户表中是否包含了 n8n 服务器的 IP。
进阶技巧：SSH 隧道连接内网数据库
这是 N8N大学 给大家的一个高阶解决方案。如果你的数据库在内网（如公司局域网），外网无法直接访问，但你有一台可以 SSH 登录的跳板机。
你不需要在 n8n 节点里配置复杂的 SSH 参数（n8n 原生 MySQL 节点不支持 SSH 隧道配置）。
最佳实践： 在 n8n 所在的服务器上建立 SSH 隧道转发。
ssh -N -L 3307:localhost:3306 user@跳板机IP这条命令将跳板机的 3306 端口映射到 n8n 服务器的 3307 本地端口。然后在 n8n 的 MySQL 节点中，Host 填 localhost，Port 填 3307。完美解决内网穿透问题。
FAQ 问答
1. n8n 的 MySQL 节点支持 SSL 连接吗？
是的。在 Credentials 配置中，展开 SSL 选项，上传 CA 证书、客户端证书和私钥即可。很多云数据库强制要求 SSL 连接，否则无法通过。
2. 为什么我用公网 IP 连本地 MySQL 连不上？
家用宽带通常没有公网 IP，且运营商封锁了 80 和 448 以外的端口，3306 基本被封。此外，家用路由器需要做端口映射（Port Forwarding），这非常复杂且不安全，建议使用内网穿透或 VPN。
3. 如何测试我的 Credentials 是否正确？
在 n8n 编辑器中，点击 MySQL 节点，右侧侧边栏会有“Credentials”区域。点击“Save”后，通常会有绿色的“Connection successful”提示。如果没有，请仔细阅读报错信息。
总结与资源
连接本地 MySQL 和远程 MySQL 的核心差异在于网络可达性和权限控制。本地连接关注 IP 和 Docker 网络，远程连接关注防火墙和用户授权。
不要盲目修改代码，先用 telnet 或 ping 确认网络通不通，再用数据库客户端（如 DBeaver）确认账号能不能用。最后，再把确认过的参数填入 n8n。
如果你在实战中遇到了更诡异的报错，欢迎在 N8N大学 的社区留言。记住，每一个报错背后，都是一个等待被理解的网络协议。
