toolkitbox/mongo

MongoDB客户端（mongosh）

📢 发现问题或需要新工具？ https://github.com/pabpereza/toolkitbox/issues

现代MongoDB shell，用于与MongoDB数据库交互。

快速开始

Docker

bash
# 交互模式
docker run -it --rm \
  ***-ghcr.xuanyuan.run/pabpereza/toolkitbox/mongo:latest \
  mongosh "mongodb://my-server:27017"

# 带认证
docker run -it --rm \
  ***-ghcr.xuanyuan.run/pabpereza/toolkitbox/mongo:latest \
  mongosh "mongodb://user:password@my-server:27017/database"

# 执行单条命令
docker run --rm \
  ***-ghcr.xuanyuan.run/pabpereza/toolkitbox/mongo:latest \
  mongosh "mongodb://my-server:27017" --eval "db.getCollectionNames()"

Kubernetes

yaml
apiVersion: v1
kind: Pod
metadata:
  name: mongo-client
spec:
  containers:
  - name: mongo-client
    image: ***-ghcr.xuanyuan.run/pabpereza/toolkitbox/mongo:latest
    command: ["sleep", "infinity"]
    env:
    - name: MONGODB_URI
      valueFrom:
        secretKeyRef:
          name: mongo-credentials
          key: uri

镜像概述

mongosh是官方MongoDB shell，替代了传统的mongo shell。它提供丰富的命令行界面，支持自动补全、语法高亮和完整的JavaScript支持。

核心功能

• 与MongoDB数据库建立连接（本地、远程、MongoDB Atlas）
• 执行CRUD操作、查询数据、创建索引等
• 支持JavaScript脚本执行
• 提供交互式命令行体验，含自动补全和语法高亮

使用场景

• DevOps工程师日常管理MongoDB数据库
• 自动化脚本中执行数据库操作
• Kubernetes环境下临时连接数据库进行调试

配置说明

安装说明

该镜像直接从MongoDB官方二进制文件下载并安装mongosh，支持x64和arm64架构。

基本用法

连接本地MongoDB

bash
mongosh  

连接远程服务器

bash
mongosh "mongodb://hostname:27017"  

带认证连接

bash
mongosh "mongodb://user:password@hostname:27017/database"  

连接MongoDB Atlas

bash
mongosh "mongodb+srv://cluster.mongodb.net/mydb" --username user  

执行命令后退出

bash
mongosh --eval "db.getCollectionNames()"  

执行JavaScript脚本

bash
mongosh script.js  

常用Shell命令

javascript
// 显示数据库列表
show dbs  

// 切换数据库
use my_database  

// 显示集合列表
show collections  

// 查询文档
db.my_collection.find()  

// 插入文档
db.my_collection.insertOne({ name: "示例" })  

// 带过滤条件查询
db.my_collection.find({ field: "value" })  

// 统计文档数量
db.my_collection.countDocuments()  

// 创建索引
db.my_collection.createIndex({ field: 1 })  

连接选项

可用的传统版本

• v3.6 - MongoDB 3.6（使用经典mongo shell）
• v4.4 - MongoDB 4.4（使用经典mongo shell）

官方文档

• https://www.mongodb.com/docs/mongodb-shell/
• https://www.mongodb.com/docs/mongodb-shell/crud/