MongoDB

配置 MongoDB 节点、认证数据库与 TLS，让 ZAI 用 mongosh 或 SDK 访问。

在连接器的 访问内容 → 添加访问 中，在 原生资源 里选择 MongoDB。它使用连接器的授权与网络隧道；保存后，ZAI 可以用 mongosh 或 MongoDB SDK 访问。

部署方式

部署方式 默认为 副本集：

单节点 / 固定成员：连接指定节点。也可以访问副本集中的固定成员，但不会自动切换到其他成员；该成员的角色仍决定哪些操作可执行。
副本集：填写副本集名称和全部成员地址。连接时会自动找到主节点，主节点切换后也会自动连到新的主节点。新增成员时应先更新本资源，未登记的成员不会自动获得访问权限。
分片集群（mongos）：填写 mongos 路由入口，业务读写由 mongos 转发到分片。不在这里填写各分片内部节点。

这里只接受显式节点列表，不接受 mongodb+srv 连接串或 loadBalanced 模式。使用 MongoDB Atlas 时，请先确认它支持按普通节点地址连接。

目标地址 和端口填写第一个节点，端口默认为 27017。其他节点 每行一个 <节点地址>:<端口>，最多 15 个，IPv6 使用 [<地址>]:<端口>。不填写账号、密码、URI 参数或 mongodb:// 前缀。

副本集填写服务器公布的完整成员地址，不能只填一个可连通的别名。服务器返回未登记地址时连接会失败；请核对成员配置并补齐本资源的地址列表。

每个节点都沿用连接器的网络隧道。连接器没有指定隧道时，每个节点都按沙箱配置的内网路由分别判断怎样访问；内网节点不能只为第一个节点配置路由。

使用数据库管理员为该用途分配的用户名和密码。认证方式 默认为 SCRAM-SHA-256，也支持 SCRAM-SHA-1，选择账号实际支持的方式。数据库密码只由平台使用，不会交给 ZAI。

只读用途应在 MongoDB 中授予相应数据库的 read 角色。连接器不会把高权限账号变成只读账号，数据库名也不代替 MongoDB 对数据库、集合和操作的权限检查。

填写创建该账号的数据库，即 MongoDB 的 authSource，默认为 admin。它可以与业务数据库不同；认证失败时，请同时核对用户名、密码、认证数据库和认证方式。

填写默认操作的业务数据库，例如 <业务数据库>。它与副本集名称、集群显示名称和集合名称是不同概念。

数据库名不超过 63 字节；数据库名和认证数据库都不能包含空格或 / \ . " $ * < > : | ?。不符合时，表单会在对应字段下直接提示。

默认 验证服务器证书，地址必须与目标证书匹配。只有目标明确不支持 TLS 且网络条件允许时，才选择 不使用 TLS；此时平台到目标的连接不加密，CA 证书字段会隐藏，填过的 CA 也不会提交。

目标使用公有受信任 CA 时可以留空。自建 CA 或云服务专用 CA，请向数据库管理员获取完整 PEM 证书链，不在这里填写客户端私钥。证书链只保留 BEGIN CERTIFICATE / END CERTIFICATE 证书块，证书之间只留换行，块外的说明文字会导致保存失败。

保存后，请 ZAI 先执行 db.runCommand({ping: 1})，再带 limit 查询一个已授权的集合。其余排查见验证与排错。

替换凭证 更新平台保存的密码，不修改 MongoDB 里的账号。修改配置、替换凭证、撤销凭证，或连接到了时长上限（见常用限制），都会关闭已有连接，ZAI 需要重新建立连接。连接断开不会撤销已经提交的操作；出错后是否重试，按 MongoDB 驱动和业务自身的重试规则处理。