MongoDB在Ubuntu上的连接字符串怎么写

MongoDB 在 Ubuntu 的连接字符串写法

一 基本格式与参数

• 标准 URI 形式：mongodb://[username:password@]host[:port][/[defaultauthdb][?options]]
  • 协议头：固定为 mongodb://
  • 认证信息：可选，格式 username:password@
  • 主机与端口：可指定一个或多个 host:port，默认端口 27017
  • 默认认证库：可选，未指定且提供凭据时默认 admin
  • 查询参数：以 key=value 形式拼接，多个用 & 分隔，如 authSource=admin&ssl=true
• 常用选项
  • authSource：指定认证数据库（如用户存在 admin 库，常用 authSource=admin）
  • replicaSet：副本集名称（连接副本集必填）
  • ssl / tls：启用加密连接（如 ssl=true）
  • connectTimeoutMS / socketTimeoutMS：连接/套接字超时（毫秒）
  • w / wtimeoutMS：写关注级别与超时（如 w=majority）
  • readPreference：读偏好（如 secondary）
  • maxPoolSize：连接池最大连接数
• 特殊字符处理：用户名或密码包含 :, /, ?, #, [, ], @ 等需进行 URL 编码（如 @ → %40）

二 常见连接字符串示例

• 本地默认实例：mongodb://localhost
• 指定数据库：mongodb://localhost/mydatabase
• 用户名密码连接：mongodb://myuser:mypass@localhost:27017/mydatabase
• 指定认证库：mongodb://myuser:mypass@localhost:27017/mydatabase?authSource=admin
• 启用 SSL：mongodb://myuser:mypass@localhost:27017/mydatabase?ssl=true
• 副本集连接：mongodb://host1:27017,host2:27017,host3:27017/mydatabase?replicaSet=myReplSet
• 多选项组合：mongodb://myuser:mypass@localhost:27017/mydatabase?authSource=admin&ssl=true&connectTimeoutMS=30000
• 使用 SRV 记录（Atlas 或支持 SRV 的部署）：mongodb+srv://mycluster.abcd1.mongodb.net/myFirstDatabase（SRV 记录会自动解析主机与端口，通常无需显式写端口）

三 在 Ubuntu 上连接与排错要点

• 启动并检查服务：
  • 启动：sudo systemctl start mongod
  • 开机自启：sudo systemctl enable mongod
  • 状态：sudo systemctl status mongod
• 远程访问配置（如从外部连接 Ubuntu 上的 MongoDB）
  • 修改配置文件 /etc/mongod.conf：将 bindIp: 127.0.0.1 改为 bindIp: 0.0.0.0（或加入服务器内网/公网 IP）
  • 重启生效：sudo systemctl restart mongod
  • 防火墙放行端口（UFW）：sudo ufw allow 27017
• 连接工具
  • 命令行：mongosh “mongodb://username:password@host:27017/dbname?authSource=admin”
  • GUI：MongoDB Compass 直接粘贴上述 URI 连接
• 常见报错速查
  • 无法连接目标主机/端口：核对 host、port 与 防火墙/安全组 是否放行 27017
  • 认证失败：核对 username/password，并确认 authSource 是否为用户所在数据库（常见为 admin）
  • 副本集连不上：确认 replicaSet 名称与 各节点地址/端口 正确
  • 证书/加密问题：按需启用 ssl=true 并配置 CA/证书路径