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需要在数据库能正常连接的情况下才能启动,可能不适用于要经常关闭数据库的场景,例如开发过程。
默认下载地址为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
来验证安装的版本。
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
$ 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。
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的主机。
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',
},
//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安装完成。
使用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 安装完成。