Docs 菜单
Docs 主页
/
MongoDB Compass
/
自定义

配置文件设置

在此页面上

  • 配置文件位置
  • 语法
  • 设置
  • 例子
  • 了解详情

您可以使用配置文件，在启动时自定义 MongoDB Compass 的设置。您不能覆盖已在 Compass 界面上通过配置文件设置的任何设置。

配置文件位置

  • 对于 macOS 和 Linux，配置文件位于 /etc/mongodb-compass.conf。

  • 对于 Windows，配置文件位于 <path\to\compass>\..\mongodb-compass.cfg。

语法

您可以用 EJSON 或 YAML 格式配置 Compass 配置文件设置。

EJSON

{
  "setting": value,
  "setting": value,
  ...
}

YAML

setting option: value
setting option: value
...

设置

设置
定义
autoUpdates
允许 Compass 定期检查新的更新。
enableGenAIFeatures
支持 Compass 使用生成式人工智能进行自然语言查询。此功能需要 Atlas 登录和已部署的 Atlas 集群。

在 Compass 中启用 Chrome DevTools。

要了解详情，请参阅切换 Chrome DevTools。

enableMaps
允许 Compass 向第三方地图服务发出请求。

启用或禁用 Compass 上的嵌入式 MongoDB Shell。

要了解更多信息，请参阅禁用嵌入式 MongoDB Shell。

当您通过 Compass 连接到 MongoDB 部署时，分配 连接选项值。这些连接选项不能被 Compass 界面的连接或命令行连接字符串覆盖。

忽略其他命令行标志
允许或禁止其他命令行选项标志。
installURLHandlers

将 Compass 注册为 mongodb:// 和 mongodb+srv:// URL 的处理程序。

如果启用了 Install Compass as URL Protocol Handler（安装 Compass 作为 URL 协议处理程序），则可以在您的互联网浏览器中导航到一个 mongodb:// 或 mongodb+srv:// URL，以打开 Compass。

适用于 macOS 和 Windows。

maxTimeMS
为所有 Compass 数据库操作指定时间上限。
禁止 MongoDB Compass 执行除数据库相关操作以外的传出网络操作。

将所有连接字符串设置为只读。连接字符串中的密码显示为 *****。

如果启用了 protectConnectionStrings，Compass 将禁用 Edit connection string（编辑连接字符串）选项并隐藏 Edit connection string（编辑连接字符串）开关。

protectConnectionStringsForNewConnections

默认情况下，将新连接的连接字符串设置为只读。新连接字符串中的密码显示为 *****。

如果启用了 protectConnctionStringsForNewConnections，Compass 将禁用 Edit connection string（编辑连接字符串）选项，但不会禁止用户使用 Edit connection string（编辑连接字符串）开关手动启用该选项。

防止用户通过 Compass 对 MongoDB 部署执行写入操作。

如需了解更多信息，请参阅“限制对 MongoDB 的写操作”。

在 Compass 连接表单上显示或隐藏 Kerberos 密码字段。

要了解详情，请参阅显示 Kerberos 密码字段。

主题
指定 MongoDB Compass 用户界面主题。支持的主题包括 DARK（深色）、LIGHT（浅色）和OS_THEME（操作系统主题）。
trackUsageStatistics
允许 Compass 发送匿名使用统计数据。

注意

要查看所有可用的 Compass 配置选项，请在包含 MongoDB Compass 可执行文件的文件夹中运行以下命令：

<path-to-Compass-executable> --help

例子

要查看 Compass 配置文件示例，请运行以下命令：

<path-to-Compass-executable> --show-example-config

如果您尚未拥有配置文件，请运行如下命令，以创建一个使用示例配置设置的配置文件：

<path-to-Compass-executable> --show-example-config > /etc/mongodb-compass.conf

了解详情

后退

命令行选项