通过 Localtonet 访问 MySQL 服务器
本页内容 9 个章节
从另一个网络连接你机器上的 MySQL 或 MariaDB 服务器:TCP 隧道会为 3306 端口提供一个公共主机名和端口,任何 MySQL 客户端都可以使用。
工作原理 #
Localtonet 客户端运行在托管 MySQL 的机器上,或同一网络中的另一台设备上。TCP 隧道指向 MySQL 端口 3306。Localtonet 会为隧道提供一个由主机名和端口组成的公共地址。连接到该地址的 MySQL 客户端就能访问你的服务器。TCP 隧道的详细说明见 TCP 页面。
不要在没有访问控制的情况下暴露数据库。已启动的隧道可被任何知道其地址的人访问。在把真实数据放到隧道后面之前,请阅读安全防护。
开始之前 #
- 一个 Localtonet 账户,以及使用你的 AuthToken 连接的 Localtonet 客户端。参见快速入门。
- 设备上正在运行 MySQL。请确认
mysql -h 127.0.0.1 -P 3306 -u <DB_USER> -p在设备本机上可以正常工作。 - 一个用于远程访问的 MySQL 账户,使用强密码,并且只授予它所需的权限。不要使用
root。
创建隧道 #
-
打开 TCP - UDP 页面 #
打开 我的隧道 › TCP - UDP,并展开创建 TCP - UDP 隧道。
-
填写表单 #
字段 填写内容 协议 TCP 设备令牌 设备上的 Localtonet 客户端所使用的令牌。 服务器区域 选择离你的设备较近的区域,以降低延迟。 本地 IP 地址 当 MySQL 与客户端运行在同一台设备上时,填 127.0.0.1。对于网络中另一台机器上的 MySQL 服务器,请填写该机器的地址。本地端口 3306,或 MySQL 配置中的port值。URL 类型 随机子域名。自定义子域名可以让你选择名称,并且需要余额。 选择创建隧道。
-
启动隧道并复制地址 #
隧道会显示在你的隧道下。选择启动。URL 列以
host:port的形式显示公共地址,服务器端口列则单独显示端口。
从外部连接 #
使用 mysql 命令行客户端时,主机写在 -h 之后,端口写在大写的 -P 之后。小写的 -p 表示要求输入密码。
mysql -h <TUNNEL_HOST> -P <TUNNEL_PORT> -u <DB_USER> -p <DB_NAME>应用程序通常使用连接 URL:
mysql://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>在 MySQL Workbench 或 DBeaver 等图形客户端中,将隧道的主机名填入主机,将隧道的端口填入端口。除非你把隧道的服务器端口设置为 3306,否则不要把端口保留为 3306。
隧道后面需要注意的 MySQL 设置 #
绑定地址可以保持为本地 #
Localtonet 客户端从你自己的设备连接到 MySQL。MySQL 不必监听公网接口:当客户端运行在同一台机器上时,bind-address = 127.0.0.1 就足够了。请保持这样,这样隧道就是来自外部的唯一通道。
账户的主机是 Localtonet 客户端,而不是访客 #
MySQL 账户由用户名加上连接来源的主机组成。通过隧道时,每个连接都来自 Localtonet 客户端。当客户端运行在 MySQL 所在的机器上时,该主机就是 localhost:
CREATE USER '<DB_USER>'@'localhost' IDENTIFIED BY '<DB_PASSWORD>';
GRANT SELECT, INSERT, UPDATE, DELETE ON <DB_NAME>.* TO '<DB_USER>'@'localhost';如果服务器启用了 skip_name_resolve,请使用 '127.0.0.1' 代替 'localhost'。如果客户端运行在另一台设备上,请使用该设备在网络中的地址。
这也意味着 MySQL 中的主机规则无法区分不同的访客:所有到达隧道的人看起来都是同一个主机。请改用IP 限制在隧道上限制访客。
保持地址不变 #
主机名会跟随隧道保持不变。端口则由服务器在隧道启动时分配。在隧道的设置中开启保留端口?后,隧道或 Localtonet 客户端重启时端口保持不变,这正是应用程序中的连接字符串所需要的。关闭时,重启后端口会改变。账户有余额时创建的隧道默认开启保留端口?。开启它需要余额和一个已启动的隧道。
有余额时,你还可以在服务器端口 › 更换下选择端口,例如在该服务器上没有其他隧道使用 3306 时选用 3306。参见端口。
免费版。在免费版上,TCP 隧道会在 30 分钟后停止,可以再次启动。每次启动后端口可能不同。参见套餐与余额。
保护它 #
- IP 限制。在隧道的设置中,选择 IP 限制 › 管理,选择仅允许这些,并添加要连接的应用程序和人员的地址。可以是单个地址、
10.0.0.0/16这样的范围,也可以同时添加多个。更改会立即生效。IP 限制需要余额。参见访问控制。 - 专用账户,使用强密码和最小的权限集,如上面的示例所示。请删除没有密码的账户。
- MySQL 中的 TLS。隧道默认不是端到端加密的,因此请让 MySQL 加密会话:使用
REQUIRE SSL创建账户,并使用--ssl-mode=REQUIRED连接(MariaDB 客户端使用--ssl)。 - 限制。隧道设置中的到期日期、带宽限制和速度限制可以限制隧道的使用时长和用量。参见限制与到期。
- 请求日志 › 显示会列出连接到隧道的记录以及访客的 IP 地址。
常见问题 #
ERROR 2003: Can't connect to MySQL server
客户端无法建立连接。请检查隧道已启动且其连接列显示开,检查你使用的是服务器端口中的当前端口,并检查 MySQL 在设备上隧道的本地 IP 地址和本地端口处有应答。如果你使用了 IP 限制,请检查你当前的地址在列表中。
ERROR 1045: Access denied for user '…'@'localhost'
隧道正常工作,MySQL 也有应答。消息中的主机就是 Localtonet 客户端,如上文所述。请检查密码,并检查是否存在恰好对应该用户和主机的账户。
ERROR 1130: Host '…' is not allowed to connect to this MySQL server
没有任何账户与 MySQL 看到的主机匹配。请为消息中给出的主机创建账户。
重启后应用程序断开了连接
端口没有被保留,所以在隧道或客户端重启时发生了变化。请开启保留端口?,或在应用程序中更新端口。
隧道在半小时后自行停止
在免费版上,TCP 隧道会在 30 分钟后停止。选择启动即可开始新的会话,或者充值余额以取消会话限制。
“你需要购买余额才能使用此功能。”
保留端口?、服务器端口、IP 限制和自定义子域名需要余额。请在余额下充值。