通过 Localtonet 访问 PostgreSQL 服务器
本页内容 9 个章节
用 psql、pgAdmin、DBeaver 或你的应用,从另一个网络连接到你机器上的 PostgreSQL 服务器:TCP 隧道会为 5432 端口提供一个公共主机名和端口。
工作原理 #
Localtonet 客户端运行在托管 PostgreSQL 的机器上,或同一网络中的另一台设备上。一条 TCP 隧道指向 PostgreSQL 端口 5432。Localtonet 会为隧道提供一个由主机名和端口组成的公共地址。连接到该地址的 PostgreSQL 客户端就能访问你的服务器。TCP 隧道的详细说明见 TCP 页面。
启动隧道之前请先检查 pg_hba.conf。通过隧道的连接是从 Localtonet 客户端访问 PostgreSQL 的,而客户端是本地地址。如果 pg_hba.conf 中有针对 127.0.0.1 的 trust 规则,任何能访问隧道的人都可以不输入密码直接进入。参见下面的设置。
开始之前 #
- 一个 Localtonet 账户,以及已通过 AuthToken 连接的 Localtonet 客户端。参见快速开始。
- 设备上正在运行 PostgreSQL。请检查
psql -h 127.0.0.1 -p 5432 -U <DB_USER> -d <DB_NAME>在设备本机上可以执行,并且会要求输入密码。 - 一个用于远程访问的 PostgreSQL 角色,配有强密码,并且只拥有它所需的权限。请不要使用
postgres超级用户。
创建隧道 #
-
打开 TCP - UDP 页面 #
打开我的隧道 › TCP - UDP,然后展开创建 TCP - UDP 隧道。
-
填写表单 #
字段 填写内容 协议 TCP 设备令牌 设备上的 Localtonet 客户端所使用的令牌。 服务器区域 选择离你的设备较近的区域,以降低延迟。 本地 IP 地址 当 PostgreSQL 与客户端运行在同一台设备上时,填 127.0.0.1。如果服务器在网络中的另一台机器上,请填该机器的地址。本地端口 5432,或者postgresql.conf中的port值。URL 类型 随机子域名。自定义子域名可让你自选名称,但需要有余额。 选择创建隧道。
-
启动隧道并复制地址 #
隧道会出现在你的隧道下。选择启动。URL 列以
host:port的形式显示公共地址,服务器端口列则单独显示端口。
从外部连接 #
使用 psql 时,主机写在 -h 后面,端口写在小写的 -p 后面。psql 会询问密码。
psql -h <TUNNEL_HOST> -p <TUNNEL_PORT> -U <DB_USER> -d <DB_NAME>应用通常使用连接 URI。sslmode=require 会让客户端拒绝未加密的会话:
postgresql://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?sslmode=require在 pgAdmin 或 DBeaver 中,把隧道的主机名填入主机字段,把隧道的端口填入端口字段。
隧道之后需要注意的 PostgreSQL 设置 #
listen_addresses 可以保持本地 #
Localtonet 客户端从你自己的设备连接到 PostgreSQL。PostgreSQL 不必监听公共接口:当客户端运行在同一台机器上时,默认的 listen_addresses = 'localhost' 就足够了。请保持这样,使隧道成为从外部访问的唯一途径。
pg_hba.conf 按客户端地址决定,而这个客户端就是 Localtonet 客户端 #
PostgreSQL 会根据连接来源的地址,从 pg_hba.conf 中选择认证方式。通过隧道时,该地址就是 Localtonet 客户端:当客户端运行在 PostgreSQL 所在的机器上时是 127.0.0.1。匹配的规则必须要求输入密码:
# TYPE DATABASE USER ADDRESS METHOD
host <DB_NAME> <DB_USER> 127.0.0.1/32 scram-sha-256请替换针对 127.0.0.1/32 或 ::1/128 的所有 trust 规则,并重新加载 PostgreSQL。如果客户端运行在另一台设备上,请在规则中使用该设备的地址,并设置 listen_addresses,让 PostgreSQL 同时监听它自己的网络地址。
出于同样的原因,pg_hba.conf 中的地址规则无法区分不同的访问者。请改为在隧道上用 IP 限制来限制访问者。
保持地址不变 #
主机名会一直跟随隧道。端口则由服务器在隧道启动时分配。如果在隧道的设置中开启了保留端口?,那么隧道或 Localtonet 客户端重启时端口保持不变,这正是应用中的连接 URI 所需要的。如果关闭,重启后端口会改变。在账户有余额期间创建的隧道,启动时默认开启保留端口?。开启它需要有余额,且隧道已启动。
有余额时,你还可以在服务器端口 › 更换中选择端口,例如 5432(前提是该服务器上没有其他隧道在使用它)。参见端口。
免费版。在免费版中,TCP 隧道会在 30 分钟后停止,之后可以再次启动。每次启动后端口可能不同。参见套餐与余额。
保护它 #
- IP 限制。在隧道的设置中,选择 IP 限制 › 管理,选择仅允许这些,然后添加要连接的应用和人员的地址。使用我的 IP 会填入你当前的地址。更改会立即生效。IP 限制需要有余额。参见访问控制。
- 对本地地址使用密码认证(如上所述),并使用没有超级用户权限的专用角色。
- PostgreSQL 中的 TLS。隧道默认不是端到端加密的,所以请让 PostgreSQL 对会话加密:在服务器上配置证书并设置
ssl = on,然后用sslmode=require连接。 - 限制。隧道设置中的到期日期、带宽限制和速度限制可以限定隧道能使用多久、使用多少。参见限制与到期。
- 请求日志 › 显示会列出对隧道发起的连接及访问者的 IP 地址。
常见问题 #
psql: connection refused,或连接超时
请检查隧道是否已启动、其连接列是否显示开、你使用的是服务器端口中的当前端口,以及 PostgreSQL 是否在设备上隧道的本地 IP 地址和本地端口处响应。如果你使用了 IP 限制,请检查你当前的地址是否在列表中。
FATAL: no pg_hba.conf entry for host "127.0.0.1"
隧道正常,PostgreSQL 也已响应。pg_hba.conf 中没有规则能同时匹配 Localtonet 客户端的地址、你的用户和数据库。请添加上面所示的规则,并重新加载 PostgreSQL。
FATAL: password authentication failed for user "…"
隧道正常。请检查角色的密码,以及该角色是否设置了密码:创建时没有设置密码的角色无法用 scram-sha-256 登录。
我没有输入密码就进去了
有一条 trust 规则匹配了 Localtonet 客户端的地址。请停止隧道,把规则改为 scram-sha-256,重新加载 PostgreSQL,然后再次启动隧道。
重启后应用程序断开了连接
端口没有被保留,所以在隧道或客户端重启时发生了变化。请开启保留端口?,或者在应用中更新端口。
隧道在半小时后自行停止了
在免费版中,TCP 隧道会在 30 分钟后停止。选择启动开始新的会话,或者充值余额以取消会话时长限制。
“你需要购买余额才能使用此功能。”
保留端口?、服务器端口、IP 限制和自定义子域名需要有余额。请在余额中充值。