跳到内容
Localtonet Localtonet 控制台

通过 Localtonet 访问 MongoDB 服务器

获取本页帮助
本页内容 9 个章节
  1. 工作原理
  2. 开始之前
  3. 创建隧道
  4. 打开 TCP - UDP 页面
  5. 填写表单
  6. 启动隧道并复制地址
  7. 从外部连接
  8. 隧道背后需要注意的 MongoDB 设置
  9. 启用访问控制
  10. bindIp 可以保持为本地
  11. 副本集需要直接连接
  12. 保持地址不变
  13. 保护它
  14. 常见问题
  15. 相关页面

从另一个网络,用 mongosh、MongoDB Compass 或驱动程序连接你机器上的 MongoDB 服务器:TCP 隧道会为 27017 端口提供一个公网主机名和端口。

工作原理 #

Localtonet 客户端运行在承载 MongoDB 的机器上,或同一网络中的另一台设备上。TCP 隧道指向 MongoDB 端口 27017。Localtonet 会为隧道提供由主机名和端口组成的公网地址。连接到该地址的 MongoDB 客户端就能访问你的服务器。TCP 隧道的详细说明见 TCP 页面。

请先启用身份验证。自行管理的 MongoDB 服务器在你启用访问控制之前,不需要用户名或密码就会接受所有连接。已启动的隧道,任何知道其地址的人都能访问,因此指向这样一台服务器的隧道,会让陌生人完全访问你的数据。

开始之前 #

  • 一个 Localtonet 账户,以及用你的 AuthToken 连接的 Localtonet 客户端。请参阅快速开始。
  • 设备上运行的 MongoDB 已启用访问控制。请见下文的 MongoDB 设置。
  • 一个供远程使用的 MongoDB 用户,使用强密码,并且只拥有所需的角色。

创建隧道 #

  1. 打开 TCP - UDP 页面 #

    打开我的隧道 › TCP - UDP,展开创建 TCP - UDP 隧道。

  2. 填写表单 #

    字段填写内容
    协议TCP
    设备令牌设备上的 Localtonet 客户端所使用的令牌。
    服务器区域选择离你的设备较近的区域,延迟更低。
    本地 IP 地址如果 MongoDB 与客户端运行在同一台设备上,填 127.0.0.1。如果服务器在网络中的另一台机器上,请填那台机器的地址。
    本地端口27017,或 mongod.conf 中的 net.port 值。
    URL 类型随机子域名。自定义子域名可以让你选择名称,并且需要余额。

    选择创建隧道。

  3. 启动隧道并复制地址 #

    隧道会出现在你的隧道下。选择启动。URL 列以 host:port 的形式显示公网地址,服务器端口列则单独显示端口。

从外部连接 #

MongoDB 客户端使用连接字符串。请使用 mongodb:// 形式,并填入隧道的主机和端口。authSource 是创建该用户时所在的数据库,通常是 admin。

连接字符串
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=admin

使用 mongosh 时,不要把密码写进命令,这样它就不会保存到你的 shell 历史记录中。mongosh 会询问密码:

终端
mongosh "mongodb://<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>" --username <DB_USER> --authenticationDatabase admin

在 MongoDB Compass 中,把连接字符串粘贴到新连接的 URI 字段中。

请不要对隧道地址使用 mongodb+srv:// 形式。该形式会查询 DNS 记录,而隧道主机名没有这些记录。

隧道背后需要注意的 MongoDB 设置 #

启用访问控制 #

先创建一个管理员,然后在 mongod.conf 中开启 authorization 并重启 MongoDB:

mongod.conf
security:
  authorization: enabled

重启之后,没有凭据的连接就不能再读取或更改数据。MongoDB 手册在“Enable Access Control”下介绍了完整的步骤。

bindIp 可以保持为本地 #

Localtonet 客户端从你自己的设备连接到 MongoDB。MongoDB 不必监听公网接口:当客户端与它在同一台机器上运行时,默认的 net.bindIp: 127.0.0.1 就足够了。请保持这样,让隧道成为从外部访问的唯一途径。

副本集需要直接连接 #

当驱动程序连接到副本集时,服务器会返回其成员的主机名,驱动程序随后会尝试连接这些名称。它们是你网络内部的地址,因此从外部连接会挂起或失败。请在连接字符串中加上 directConnection=true,让连接保持在隧道的地址上:

连接字符串
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=admin&directConnection=true

保持地址不变 #

主机名始终属于这条隧道。端口则由服务器在隧道启动时分配。在隧道的设置中开启保留端口?后,隧道或 Localtonet 客户端重启时端口保持不变,这正是应用程序中的连接字符串所需要的。关闭时,重启后端口会改变。账户有余额期间创建的隧道,默认开启保留端口?。开启它需要余额,并且隧道必须已启动。

有余额时,你还可以在服务器端口 › 更换下选择端口,例如 27017(前提是该服务器上没有其他隧道在用它)。请参阅端口。

免费版。免费版中的 TCP 隧道会在 30 分钟后停止,之后可以再次启动。每次启动后端口都可能不同。请参阅套餐与余额。

保护它 #

  • MongoDB 中的访问控制,如上所述。这是唯一不能跳过的一步。
  • IP 限制。在隧道的设置中,选择 IP 限制 › 管理,选择仅允许这些,并添加需要连接的应用程序和人员的地址。使用我的 IP 会填入你当前的地址。更改会立即生效。IP 限制需要余额。请参阅访问控制。
  • 专用用户,只在它需要的那一个数据库上拥有角色,例如 readWrite,而不是使用管理员。
  • MongoDB 中的 TLS。隧道默认不是端到端加密的。请在服务器上配置 net.tls,并在连接字符串中加上 tls=true,让凭据和数据全程加密。
  • 限制。隧道设置中的到期日期、带宽限制和速度限制可以限定隧道能使用多久、能用多少。请参阅限制与到期。
  • 请求日志 › 显示会列出连接到该隧道的连接,以及访问者的 IP 地址。MongoDB 自身则会把 Localtonet 客户端记录为每个连接的来源。

常见问题 #

MongoServerSelectionError 或 MongoNetworkError: connection timed out

请检查:隧道是否已启动,且它的连接列显示开;使用的是服务器端口中的当前端口;MongoDB 是否在设备上的隧道本地 IP 地址和本地端口处应答。如果服务器是副本集,请加上 directConnection=true。如果你使用了 IP 限制,请检查你当前的地址是否在列表中。

MongoServerError: Authentication failed

隧道是正常的,MongoDB 也作出了响应。请检查密码和 authSource:它必须是创建该用户时所在的数据库。连接字符串中用户名或密码里的特殊字符必须做百分号编码。

我不用登录就能读取数据

访问控制没有开启。请停止隧道,启用 security.authorization,重启 MongoDB,然后再次启动隧道。

重启后应用程序断开了连接

端口没有被保留,所以在隧道或客户端重启时发生了变化。请开启保留端口?,或更新连接字符串中的端口。

隧道半小时后自行停止了

在免费版中,TCP 隧道会在 30 分钟后停止。选择启动可以开始新的会话,也可以充值余额以取消会话限制。

“你需要购买余额才能使用此功能。”

保留端口?、服务器端口、IP 限制和自定义子域名都需要余额。请在余额中充值。

支持