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