centos7下使用mongo-express/adminMongo通过WEB管理MongoDB（可视化）

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下的本地应用。

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

注意

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

2.安装运行环境

以Centos7为例

默认下载地址为Downloads，这里在/usr/local/中新建node目录，将其安装在这里，为避免用户权限问题，以下操作均为在root权限下执行，进入/usr/local/目录中

mkdir node
chmod 777 node

进入到node目录中,下载node源文件node-v6.11.2-linux-x64.tar.xz

wget https://nodejs.org/dist/v6.11.2/node-v6.11.2-linux-x64.tar.xz

  解压

因为文件是以tar.xz格式，这里首先使用xz，然后使用tar进行解压

xz -d node-v6.11.2-linux-x64.tar.xz
tar xvf node-v6.11.2-linux-x64.tar

解压后的文件名为node-v6.11.2-linux-x64

加入环境变量

为了在任何路径都可以使用node命令，这里加入环境变量

vim ~/.bashrc

在最后面加入

export NODE=/usr/local/node/node-v6.11.2-linux-x64
export PATH=${NODE}/bin:$PATH

保存后退出。
使配置生效

source ~/.bashrc

这时可以在任意路径执行node命令，此时参看node版本，因为安装node时，npm也同时安装了，所以可以执行

node -v
npm -v

来验证安装的版本。

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。

配置Mongo数据库的连接信息：

if (process.env.VCAP_SERVICES) {
  var dbLabel = 'mongodb-2.4';
  var env = JSON.parse(process.env.VCAP_SERVICES);
  if (env[dbLabel]) {
    mongo = env[dbLabel][0].credentials;
  }
} else {
  var mongo = {
    db:'bigdata_mongo',
    host:"localhost",
    port:27017,
    ssl:false,
    username:'admin',
    password:'pass',
    url:"mongodb://localhost:27017/bigdata_mongo",
    // setting the connection string will only give access to that database
    // to see more databases you need to set mongodb.admin to true or add databases to the mongodb.auth list
    connectionString: process.env.ME_CONFIG_MONGODB_SERVER ? '' : process.env.ME_CONFIG_MONGODB_URL,
  };

}


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

配置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',
  },

编辑关于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数据库运行正常且可连接，配置文件的数据库连接配置正确。

启动

首先要启动mongodb，进入目录/usr/mongodb/bin/执行

./mongod --bind_ip=0.0.0.0 &

然后进入 /usr/local/node/node-v6.11.2-linux-x64/lib/node_modules/mongo-express/目录执行

node app.js

然后在火狐浏览器中打开http://服务器地址:8081，
在弹出的对话框中输入默认的用户名和密码
User Name:admin,Password:pass

至此，mongo-express安装完成。

1. 部署adminMongo应用

使用npm安装adminMongos应用

npm install -g admin-mongo

同样，mongo-express会被安装到/usr/local/node/node-v6.11.2-linux-x64/lib/node_modules/admin-mongo/下。

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

如果需要修改运行配置，可以编辑/usr/local/node/node-v6.11.2-linux-x64/lib/node_modules/admin-mongo/config/app.json，例如：

// locale为语言设置，en为默认使用的英语，此处仅为示意说明
// adminMongo目前还没有中文翻译，热心者可以到项目Github主页贡献翻译
{
    "app": {
        "host": "localhost",
        "port": 1234,
        "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中。

启动

启动时要先启动mongodb，然后才能连接，进入到/usr/local/node/node-v6.11.2-linux-x64/lib/node_modules/admin-mongo，然后执行

npm start

在浏览器中输入 http://0.0.0.0:1234
或者 http://服务器地址:1234/
登录密码：secureadminpassword
在弹出的页面中Connection name输入bigdata_mongo，Connection string输入mongodb://127.0.0.1，然后点击Add connection

至此，adminmongo 安装完成。