# adminmongo

**Repository Path**: ezerg/adminmongo

## Basic Information

- **Project Name**: adminmongo
- **Description**: Mongodb数据库图形工具
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2022-05-31
- **Last Updated**: 2022-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# adminMongo


adminMongo是一个跨平台用户界面(GUI)来处理所有的MongoDB连接/数据库需求。adminMongo是完全响应的，应该在一系列设备上工作。
adminMongo连接信息(包括用户名/密码)未加密存储在配置文件中，如果没有适当的安全考虑，不建议在生产或面向公众的服务器上运行此应用程序。


## 安装

1. 安装 adminMongo: `gitee 克隆 https://gitee.com/a-luminous-lamp/adminmongo.git && cd adminMongo`
2. 安装 依赖相关文件: `npm install`
3. 启动应用程序: `npm start` or `node app`
4. 在浏览器访问 [http://127.0.0.1:1234](http://127.0.0.1:1234) 

> 注意:节点。js版本4.x或以上

## 打包 Electron App

adminMongo也可以作为一个跨平台的电子应用程序。由于Electron的大小，它将需要人工构建。

为Mac构建:

`$ npm run-script packageOsx`

为Windows构建:

`$ npm run-script packageWin64`

为Linux构建:

`$ npm run-script packageLinux`

一旦构建完成，可执行文件将位于/releases文件夹中。

### 预先构建的安装文件

预编译的安装文件可以在这里下载:

[Mac 64bit](https://)

[Windows 64bit](https://)

电子版本已经在Mac和Windows 10上测试过了。Linux还没有经过测试。有任何问题请报告。

## 特性

* 从连接级别管理，方便访问多个数据库
* 创建/删除数据库
* 备份/恢复数据库
* 创建/删除/编辑集合
* 创建/删除/编辑文档
* 创建/删除索引* 查询文件
* 收集统计信息
* 以JSON格式导出集合
* 服务器监控

### 当前的限制

* 文档需要有一个“_id”值，它是一个字符串，整数，或MongoDB ObjectId。目前不支持使用复合ID索引的文档。
* 目前不支持多主机复制集连接字符串。

## *配置

adminMongo 主机: `localhost` 和端口: `1234` 默认。可以自行修改 config 文件  `/config/app.json`. 


例如:

```
{
    "app": {
        "host": "10.0.0.1",
        "port": 4321,
        "password": "secureadminpassword",
        "locale": "de",
        "context": "dbApp",
        "monitoring": false
    }
}
```

> 注意:对配置文件的任何更改都需要重新启动应用程序

以上所有参数都可以通过环境使用，这使得adminMongo作为docker容器非常方便!
just run `docker run -e HOST=yourchoice -e PORT=1234 ...`

配置文件(可选)选项包括:

|选项Env-variable |定义
|--- |--- |--- |
| ' host ' | ' host ' | IP地址' adminMongo '将监听|
这个端口“adminMongo”将在|上监听
| ' password ' | ' password ' |应用程序级密码，用于添加简单的身份验证|
| ' locale ' | ' locale ' |区域设置会自动设置为检测到的Nodejs区域设置。如果没有翻译，' adminMongo '将默认为英语。此设置覆盖缺省/检测到的值|
设置一个“dbApp”的“context”就像改变应用程序的基础URL，将意味着应用程序将监听“http://10.0.0.1:4321/dbApp”。省略上下文意味着应用程序将监听根目录。例如:“http://10.0.0.1:4321”。当在Nginx等后台运行' adminMongo '时，这个设置会很有用
| ' monitoring ' | ' monitoring ' |是否定期监控。默认为true或|

### 设置上下文路径

设置“dbApp”的“上下文”就像改变应用程序的基础URL，将意味着应用程序将监听' http://10.0.0.1:4321/dbApp '。省略上下文意味着应用程序将监听
根。例如:“http://10.0.0.1:4321”。当在Nginx等后台运行' adminMongo '时，这个设置会很有用。

Nginx服务器块的示例。注意' location /dbApp{'和' proxy_pass http://10.0.0.1:4321/dbApp; '行是匹配的
' context '设置在' /config/app。json的文件

```
server {
    listen 80;

    server_name xxxx.com;

    location /dbApp {
        proxy_pass http://10.0.0.1:4321/dbApp;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}
```


### 身份验证

默认情况下，“adminMongo”不受密码保护。你可以通过添加' password '值到' /config/app。json的文件
(请参见配置部分)。一旦添加，您将需要重新启动' adminMongo '，所有的路由将受到保护，直到添加正确的密码。你
然后将在会话的生命周期(默认为60分钟)或如果单击“注销”链接进行身份验证。






| Env-variable |描述
|--- |--- |
| ' CONN_NAME ' |启动时要创建的连接的名称|
| ' DB_USERNAME ' |数据库连接的用户名|
| ' DB_PASSWORD ' |数据库用户|的密码
| ' DB_HOST ' |主机IP地址或不带端口的DNS名称
| ' DB_PORT ' | mongoDB数据库的端口，如果没有提供，使用默认的27017 |
| ' DB_NAME ' |数据库名称|


### 连接/数据库管理

在打开新创建的连接后，您可以看到与连接相关联的所有数据库对象。在这里，您可以创建/删除集合，创建/删除用户，并查看数据库的各种统计信息。

复杂的文档查询是通过“查询官方文档”按钮完成的。这允许将查询对象传递给MongoDB以返回结果查询可以用完整的BSON格式或EJSON格式编写。例如，这些查询应该返回相同的结果:

```
{
    ObjectId("56a97ed3f718fe9a4f599489")
}
```

等价于:

```
{
    "$oid": "56a97ed3f718fe9a4f599489"
}
```

## 测试

adminMongo API测试包括:添加和删除连接添加和删除数据库添加、
删除和重命名集合创建和删除用户添加、
查询和删除文档要运行测试，只需运行:

```
npm test
```

[QQ交流群](https://jq.qq.com/?_wv=1027&k=pa6nlMFp)