MongoDB Compass Web

镜像概述和主要用途

MongoDB Compass的Web移植版Docker镜像，前端基于原始@mongodb-js/compass-web重建和重新打包。提供从浏览器查看和交互数据库的便捷方式，同时保留MongoDB Compass的大部分功能。

!screenshot

核心功能和特性

• 浏览器访问：无需安装桌面客户端，直接通过浏览器管理MongoDB数据库
• 多连接支持：可配置多个MongoDB连接字符串
• 功能保留：继承MongoDB Compass的核心功能，如数据浏览、查询执行等
• 灵活配置：支持通过命令行参数或环境变量进行配置
• 安全选项：可选基本HTTP认证保护访问

使用场景和适用范围

• 开发环境：团队共享数据库访问入口，无需每个人安装客户端
• 远程服务器：通过Web界面管理服务器上的MongoDB实例
• 快速演示：临时搭建MongoDB可视化管理界面
• 多环境管理：集中配置和切换多个MongoDB连接

详细使用方法和配置说明

📦 安装

拉取Docker镜像：

bash
docker pull haohanyang/compass-web

🧭 使用

基本启动（Docker）

通过环境变量或命令行参数指定MongoDB连接字符串启动服务：

bash
# 使用环境变量配置连接字符串
docker run -it -p 8080:8080 -e CW_MONGO_URI="mongodb://localhost:27017" haohanyang/compass-web

# 配置多个连接字符串（空格分隔）
docker run -it -p 8080:8080 -e CW_MONGO_URI="mongodb://localhost:27017 mongodb+srv://myusername:***/?retryWrites=true&w=majority&appName=default-cluster" haohanyang/compass-web

# 自定义端口和主机
docker run -it -p 3000:3000 -e CW_MONGO_URI="mongodb://localhost:27017" -e CW_PORT=3000 haohanyang/compass-web

Docker Compose

查看示例docker-compose.yaml文件进行部署。

⚙️ 配置参数

可通过命令行参数或环境变量（前缀CW_）配置服务，参数说明如下：

启用基本认证示例

bash
docker run -it -p 8080:8080 \
  -e CW_MONGO_URI="mongodb://localhost:27017" \
  -e CW_BASIC_AUTH_USERNAME="admin" \
  -e CW_BASIC_AUTH_PASSWORD="securepassword" \
  haohanyang/compass-web

UI设置

在应用界面的设置中可配置用户偏好：

• 主题切换：支持深色/浅色模式
• 查询栏默认排序：设置查询结果的默认排序方式

从源码构建（可选）

克隆仓库并获取依赖

bash
git clone [***]
cd compass-web && git submodule update --init --recursive --single-branch --depth 1

构建依赖

bash
bash bootstrap.sh
pnpm i --frozen-lockfile

构建前端

bash
pnpm run build

启动应用

bash
node app.js --mongo-uri "mongodb://localhost:27017"

credits

MongoDB Compass

许可证

Server Side Public License