大家好，我是杨成功。

月初出版了一本书《前端开发实战派》，书中全栈开发的部分，使用 Express + MongoDB 编写接口，完成后部署在 Serverless 上。

我想既然接口跑在 Serverless 上，索性数据库也买一个 MongoDB 云数据库吧，这样大家完全不需要买服务器自己部署，对前端来说门槛更低。

然后我找到了云数据库，看到价格傻眼了：

确实买不起啊，还是我自己搭建吧。还好我有好基友 Docker，搭建一个 MongoDB 不费事。

目前 MongoDB 最新版本是 7.x，我们用上一个版本 6.x。

运行容器启动 MongoDB

安装 Docker 大家直接从官网下载安装就可以了，测试的话在本地装一个 Docker Desktop 很方便。

（1）拉取 MongoDB 的官方镜像：

sh 复制代码

$ docker pull mongo:6

（2）在宿主环境中创建两个目录，作为容器数据卷：

sh 复制代码

/docker/mongodb/data/    #数据库数据目录
/docker/mongodb/dump/    #备份数据目录

（3）执行命令，把 MongoDB 容器运行起来：

sh 复制代码

$ docker run --name mongodb \
    --restart=always \
    -p 27017:27017 \
    -v /docker/mongodb/data:/data/db \
    -v /docker/mongodb/dump:/var/dump \
    -d mongo:6 --auth

上面的几个重要参数说明一下：

--restart=always：容器退出时自动重启，这个很有用。
27017：用于连接 MongoDB 的端口。
--auth：开启授权验证。
-d：后台运行，要加。

运行成功后，使用 docker ps 命令查看容器列表：

图中圈住的地方就是容器ID，接着进入这个容器，并连接数据库：

sh 复制代码

$ docker exec -it <container_id>  /bin/bash
$ mongosh  # 进入数据库，不需要用户名

mongosh 是从 MongoDB 4.2 开始推出的 shell 工具，取代了之前的 mongo 命令，用于执行数据库的操作，这里要留意一下。

上图可以看到，默认连接到了 test 数据库。

现在切换到 admin 数据库（身份验证数据库），创建一个超级用户：

sh 复制代码

$ use admin # 切换数据库
$ db.createUser({
  user:'root',
  pwd:'mongo_root_pass',
  roles:[{
    role:'root',
    db:'admin'
  }]
})

接下来使用这个用户登录 MongoDB，就可以执行"创建数据库、创建用户"等操作了。

启动容器并创建用户

上一步我们先启动容器，然后再创建超级用户，实际上这两个步骤可以一次完成。

在运行容器时，如果传入下面的两个环境变量：

MONGO_INITDB_ROOT_USERNAME：用户名
MONGO_INITDB_ROOT_PASSWORD：密码

MongoDB 会自动在 admin 数据库中创建该用户，指定角色为 root，并自动启用身份验证（--auth）。

所以上面的运行容器命令可以优化为这样：

sh 复制代码

$ docker run --name mongodb \
    --restart=always \
    -p 27017:27017 \
    -v /docker/mongodb/data:/data/db \
    -v /docker/mongodb/dump:/var/dump \
    -e MONGO_INITDB_ROOT_USERNAME=root \
    -e MONGO_INITDB_ROOT_PASSWORD=mongo_root_pass \
    -d mongo:6

这样 MongoDB 启动之后，便自动创建了超级用户。

启动时自动执行脚本

默认的 admin 数据库用于身份验证。当真正存储数据时，需要创建一个新的数据库。

创建数据库和用户需要权限，一般我们会用超级用户登录到 admin 数据库，然后再创建其他数据库和用户，如下：

sh 复制代码

$ docker exec -it <container_id>  /bin/bash # 进入容器
$ mongosh admin --username root --password mongo_root_pass # 登录 admin 数据库
$ use test_db  # 创建/切换数据库

然而如果是在 CI（自动化部署）环境中，我们希望 MongoDB 启动后自动创建需要的数据库和用户，而不是每次都要手动创建，这时应该怎么办呢？

这时候要借助一个 Docker 下的特殊目录：docker-entrypoint-init.d。

该目录下可以自定义脚本文件，在容器第一次启动时自动执行。mongo 镜像可以识别该目录下的 .sh 和 .js 文件，并按照顺序执行。

那么我们就在 /docker/mongodb 目录下创建一个 mongo-init.js 文件，并在运行容器时挂载：

sh 复制代码

-v /docker/mongodb/mongo-init.js:/docker-entrypoint-initdb.d/mongo-init.js

现在在该文件中编写初始化逻辑，比如创建一个用户：

js 复制代码

// mongo-init.js
db.createUser({
  user: 'test_user',
  pwd: 'test_pass',
  roles: [
    {
      role: 'dbOwner',
      db: 'test_db',
    },
  ],
});

提示：docker-entrypoint-init.d 目录下的脚本只会在第一次运行容器的时候执行。如果通过 -v 挂载过数据，那么就不是第一次。可以去掉 -v 模拟第一次运行。

上面的 JS 文件中可以访问 db 对象，因为它在 mongosh 环境下执行。默认情况下，db 代表 "test" 数据库。

如果我们要切换数据库，命令是 use <db_name>。然而在 JS 文件中，显然这种语法是不支持的。

关于如何在 JS 文件中切换数据库，我找了很多方法，翻了一整天的文档，终于找到了。

就是它：db.getSiblingDB()，等同于 use 命令。

因此，在 test_db 数据库中创建/切换用户，可以修改如下：

js 复制代码

db = db.getSiblingDB('test_db');

db.createUser({
  user: 'test_user',
  pwd: 'test_pass',
  roles: [
    {
      role: 'dbOwner',
      db: 'test_db',
    },
  ],
});

通过 db.getSiblingDB() 方法，我们可以在 JS 脚本中创建多个数据库和用户。

如果你不想在 JS 代码中创建/切换数据库，更简单的方法是，用环境变量 MONGO_INITDB_DATABASE 指定脚本在某个数据库下执行。

Docker Compose 运行

如果你觉得运行容器的命令太长，那么使用 Docker Compose 也是一个不错的选择。

首先创建 compose.yml 配置文件如下：

yml 复制代码

version: '3.1'

services:
  mongodb:
    image: mongo:6
    restart: always
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: mongo_root_pass
      MONGO_INITDB_DATABASE: test_db
    volumes:
      - '/docker/mongodb/data:/data/db'
      - '/docker/mongodb/dump:/var/dump'
      - '/docker/mongodb/mongo-init.js:/docker-entrypoint-initdb.d/mongo-init.js'

然后运行启动命令：

sh 复制代码

$ docker compose up -d

客户端连接到 MongoDB

在启动 MongoDB 时，传入 --auth 参数表示开启授权验证，不传则不开启。

如果未开启授权验证，连接 MongoDB 不需要账号密码，连接 URL 如下：

arduino 复制代码

mongodb://127.0.0.1:27017

如果开启授权验证，则连接 URL 中必须指定数据库、账号、密码，如下：

bash 复制代码

mongodb://user:pass@127.0.0.1:27017/dbname

在《前端开发实战派》的项目中使用 mongoose 连接数据库，有了上面的 url 和用户名密码，连接方法如下：

js 复制代码

const mongoose = require('mongoose')

mongoose.connect('mongodb://127.0.0.1:27017/dbname', {
   user: 'username',
   pass: 'password',
}).then(() => {
   console.log('数据库连接成功：')
}).catch(err => {
   console.log('数据库连接失败：', err)
})

现在，你可以在我的开源项目仿掘金博客系统中添加自己的数据库配置，项目就可以运行起来了。

总结

前面我们从 MongoDB 的安装、运行配置、授权验证等方面，全面介绍了如何用 Docker 将 MongoDB 运行起来，并在项目中连接使用。

更多系列文章，请查看我的公众号程序员成功。

MongoDB 云数据库真买不起，Docker 安装更有性价比

运行容器启动 MongoDB

启动容器并创建用户

启动时自动执行脚本

Docker Compose 运行

客户端连接到 MongoDB

总结