使用mongo-express/adminMongo通过WEB管

1.介绍

MongoDB已经是最常用的NoSQL数据库，不用多说。

mongo-express是一个MongoDB的Admin Web管理界面，使用NodeJS、Express、Bootstrap3编写而成。目前mongo-express应该是Github上Star最多的MongoDB admin管理界面。

adminMongo也是MongoDB的Admin Web管理界面，使用NodeJS编写。adminMongo同时可以通过Electron构建为Windows、macOS、Linux下的本地应用。

本文说明如何在Linux主机上安装NodeJS运行环境、简单配置并部署mongo-express、adminMongo应用。

注意

• 这两个admin工具都会把连接信息（用户名、密码）明文存储在配置文件中，谨慎用于生产环境。
• 实测mongo-express需要在数据库能正常连接的情况下才能启动，可能不适用于要经常关闭数据库的场景，例如开发过程。

2.安装运行环境

以Debian 9为例，Ubuntu应当通用，其他发行版根据情况参考。

2.1 安装Node运行环境及NPM包管理器

安装Node运行环境，可以从NodeJS的Download页面下载二进制包自行安装，或者通过包管理器按照官网说明安装。

为了易于管理，本文使用apt包管理器安装。

对于Debian系Linux发行版，安装6.X LTS版本执行如下

$ curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
$ sudo apt-get install -y nodejs

安装最新8.X版本执行如下

$ curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
$ sudo apt-get install -y nodejs

为了能编译安装本地npm插件，建议：

sudo apt-get install -y build-essential

至此，Node环境安装完毕，可以通过

$ node --version
$ npm --version

来验证安装的版本。

2.2 安装pm2

pm2是一个NodeJS模块，提供Node App的运行管理功能，最直观的好处是，我们一般在终端通过node app.js运行某个应用后，一旦关闭终端，应用也会被关闭，通过pm2可以让应用长期后台运行。

通过npm安装的命令如下，其中-g的含义为global，即将pm2安装到Node程序目录下的lib文件夹，对于使用apt安装的情况，会安装在usr/lib/node_modules下，同时在Node程序目录下的bin目录下建立软链接，使此机器上能够使用Node的用户都能够使用这个组件。

$ sudo npm install -g pm2

至此，pm2应当能够使用，同样可以通过如下方式检查版本号：

$ pm2 --version

3 部署mongo-express应用

使用npm安装mongo-express应用

$ sudo npm install -g mongo-express

同样，mongo-express会被安装到/usr/lib/node_modules/mongo-express下。

接下来我们要根据需求修改配置文件，首先进入到mongo-express目录下

$ cd /usr/lib/node_modules/mongo-express

此处已有文件config.default.js，此文件兼具配置模板文件，以及在没有config.js时起到默认配置文件的作用。
复制创建配置文件

$ cp config.default.js config.js

然后编辑config.js。
在20行附近的位置配置Mongo数据库的连接信息：

  mongo = {
    db:       'db',
    host:     'localhost',
    password: 'pass',
    port:     27017,
    ssl:      false,
    url:      'mongodb://localhost:27017/db',
    username: 'admin',
  };

这里如果host设置为'localhost'，那么代表的是运行mongo-express的主机。

在89行附近的位置配置Web服务的信息

  site: {
    // baseUrl: the URL that mongo express will be located at - Remember to add the forward slash at the start and end!
    baseUrl: process.env.ME_CONFIG_SITE_BASEURL || '/',
    cookieKeyName: 'mongo-express',
    cookieSecret:     process.env.ME_CONFIG_SITE_COOKIESECRET   || 'cookiesecret',
    host:             process.env.VCAP_APP_HOST                 || 'localhost',
    port:             process.env.VCAP_APP_PORT                 || 8081,
    requestSizeLimit: process.env.ME_CONFIG_REQUEST_SIZE        || '50mb',
    sessionSecret:    process.env.ME_CONFIG_SITE_SESSIONSECRET  || 'sessionsecret',
    sslCert:          process.env.ME_CONFIG_SITE_SSL_CRT_PATH   || '',
    sslEnabled:       process.env.ME_CONFIG_SITE_SSL_ENABLED    || false,
    sslKey:           process.env.ME_CONFIG_SITE_SSL_KEY_PATH   || '',
  },

其中根据场景需求，可能需要把

host:             process.env.VCAP_APP_HOST                 || 'localhost',

修改为

host:             process.env.VCAP_APP_HOST                 || '0.0.0.0',

使外部主机也能访问网页。（出于安全原因谨慎使用此设置）

在93行附近可以修改登录网页所需要的用户名、密码，默认为admin和pass：

  basicAuth: {
    username: process.env.ME_CONFIG_BASICAUTH_USERNAME || 'admin',
    password: process.env.ME_CONFIG_BASICAUTH_PASSWORD || 'pass',
  },

在55行附近有关于admin features的选项

    //set admin to true if you want to turn on admin features
    //if admin is true, the auth list below will be ignored
    //if admin is true, you will need to enter an admin username/password below (if it is needed)
    admin: process.env.ME_CONFIG_MONGODB_ENABLE_ADMIN ? process.env.ME_CONFIG_MONGODB_ENABLE_ADMIN.toLowerCase() === 'true' : false,

admin feature需要打开，才能够同时管理多个DB，可设置如下

    // admin: process.env.ME_CONFIG_MONGODB_ENABLE_ADMIN ? process.env.ME_CONFIG_MONGODB_ENABLE_ADMIN.toLowerCase() === 'true' : false,
    admin: true,

至此可以尝试使用pm2以守护进程方式运行、管理应用。

# cd /usr/lib/node_modules/mongo-express
# pm2 start app.js --name mongo-express  # 启动应用，并为之命名
# pm2 list                               # 查看pm2管理的应用运行状态
# pm2 stop mongo-express                 # 停止应用
# pm2 delete mongo-express               # 从pm2列表里删除应用

至此可以通过网页访问mongo-express管理数据库。
如果应用启动失败，确认Mongo数据库运行正常且可连接，配置文件的数据库连接配置正确。

4. 部署adminMongo应用

使用npm安装mongo-express应用

# npm install -g admin-mongo

同样，mongo-express会被安装到/usr/lib/node_modules/admin-mongo下。

项目主页中介绍说，默认应用会监听localhost的1234端口，但npm现有版本0.0.23实测外部机器也可以直接访问。

如果需要修改运行配置，可以编辑../config/app.json，例如：

// locale为语言设置，en为默认使用的英语，此处仅为示意说明
// adminMongo目前还没有中文翻译，热心者可以到项目Github主页贡献翻译
{
    "app": {
        "host": "10.0.0.1",
        "port": 4321,
        "password": "secureadminpassword",
        "locale": "en",
        "context": "dbApp",
        "monitoring": false
    }
}

至此可以使用pm2以守护进程方式运行、管理应用

# cd /usr/lib/node_modules/admin-mongo
# pm2 start app.js --name admin-mongo # 启动应用，并为之命名
# pm2 list                            # 查看pm2管理的应用运行状态
# pm2 stop admin-mongo                # 停止应用
# pm2 delete admin-mongo              # 从pm2列表里删除应用

至此可以通过浏览器访问adminMongo管理数据库。adminMongo不需要预先在配置文件里配置数据库连接信息，数据库连接信息可以在网页中设置，且会被保存到adminMongo目录下./config/config.json中。