通过 Localtonet 访问 MongoDB 服务器
本页内容 9 个章节
从另一个网络,用 mongosh、MongoDB Compass 或驱动程序连接你机器上的 MongoDB 服务器:TCP 隧道会为 27017 端口提供一个公网主机名和端口。
工作原理 #
Localtonet 客户端运行在承载 MongoDB 的机器上,或同一网络中的另一台设备上。TCP 隧道指向 MongoDB 端口 27017。Localtonet 会为隧道提供由主机名和端口组成的公网地址。连接到该地址的 MongoDB 客户端就能访问你的服务器。TCP 隧道的详细说明见 TCP 页面。
请先启用身份验证。自行管理的 MongoDB 服务器在你启用访问控制之前,不需要用户名或密码就会接受所有连接。已启动的隧道,任何知道其地址的人都能访问,因此指向这样一台服务器的隧道,会让陌生人完全访问你的数据。
开始之前 #
- 一个 Localtonet 账户,以及用你的 AuthToken 连接的 Localtonet 客户端。请参阅快速开始。
- 设备上运行的 MongoDB 已启用访问控制。请见下文的 MongoDB 设置。
- 一个供远程使用的 MongoDB 用户,使用强密码,并且只拥有所需的角色。
创建隧道 #
-
打开 TCP - UDP 页面 #
打开我的隧道 › TCP - UDP,展开创建 TCP - UDP 隧道。
-
填写表单 #
字段 填写内容 协议 TCP 设备令牌 设备上的 Localtonet 客户端所使用的令牌。 服务器区域 选择离你的设备较近的区域,延迟更低。 本地 IP 地址 如果 MongoDB 与客户端运行在同一台设备上,填 127.0.0.1。如果服务器在网络中的另一台机器上,请填那台机器的地址。本地端口 27017,或mongod.conf中的net.port值。URL 类型 随机子域名。自定义子域名可以让你选择名称,并且需要余额。 选择创建隧道。
-
启动隧道并复制地址 #
隧道会出现在你的隧道下。选择启动。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:
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 限制和自定义子域名都需要余额。请在余额中充值。