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

本文说明如何在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行附近可以修改登录网页所需要的用户名、密码,默认为adminpass

  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下。

项目主页中介绍说,默认应用会监听localhost1234端口,但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中。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,835评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,598评论 1 295
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,569评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,159评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,533评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,710评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,923评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,674评论 0 203
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,421评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,622评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,115评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,428评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,114评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,097评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,875评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,753评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,649评论 2 271

推荐阅读更多精彩内容