rmdir.cn
← 返回MongoDB 命令

MongoDB 连接字符串

连接字符串格式及选项

语法

mongodb://[username:password@]host[:port][/database][?options]

说明

MongoDB 连接字符串 (Connection URI) 是客户端连接服务器的标准方式，包含主机地址、认证凭据、复制集选项、读写策略等所有连接参数。

参数

  • username:password@

    认证凭据（建议用环境变量）

  • host[:port]必填

    服务器地址，多个用逗号分隔

  • /database

    默认认证数据库（通常为 admin）

  • replicaSet

    副本集名称

  • readPreference

    primary|primaryPreferred|secondary|secondaryPreferred|nearest

  • w

    写关注级别: 1(主), majority(多数), 数字=节点数

  • wtimeoutMS

    写操作超时（毫秒）

  • maxPoolSize

    连接池最大连接数

  • tls

    true 启用 TLS 加密连接

  • authSource

    认证源数据库，默认 admin

  • retryWrites

    true(默认) 可重试写入

示例

本地开发连接

连接本地默认端口

mongodb://localhost:27017/mydb

认证连接

带用户名密码连接管理库

mongodb://admin:password@localhost:27017/admin

副本集连接

连接到副本集并指定读写策略

mongodb://host1:27017,host2:27017,host3:27017/mydb?replicaSet=rs0&readPreference=secondaryPreferred

生产环境推荐配置

安全连接+连接池+多数写入

mongodb://appuser:pass@host1:27017,host2:27017/mydb?replicaSet=rs0&w=majority&maxPoolSize=50&retryWrites=true&wtimeoutMS=5000