# @mongo-manager/app 中文文档

规范地址：https://npmcn.com/package/%40mongo-manager/app/

版本：1\.0\.0
npm 元数据更新时间：2026-11-01T21:18:26.197Z
中文译文更新时间：2026-11-01T22:17:47.678Z
软件包许可：CC-BY-NC-SA-4\.0

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40mongo-manager/app
原文对照：https://npmcn.com/package/%40mongo-manager/app/?lang=original
项目主页：https://github.com/mongo-manager/mongo-manager#readme
源码仓库：https://github.com/mongo-manager/mongo-manager

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：45.6 MB，941 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：0 个
- 首次发布：2026-11-01T21:12:14.897Z
- 最新版本发布：2026-11-01T21:18:26.066Z
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

MongoDB管理器：一个安全的，离线的MongoDB管理器在您的浏览器。

## 安装

```sh
npm install @mongo-manager/app
```

也可以使用：`pnpm add @mongo-manager/app`、`yarn add @mongo-manager/app`、`bun add @mongo-manager/app`

## README

# 蒙戈经理

一个安全的，自托管的MongoDB管理器在您的浏览器中，与AI代理，询问之前，它的变化 任何东西。单独或与您的团队一起使用：角色和双因素登录，备份，实时同步，副本 集合和分片集群，支持十种语言。完全离线工作。

截图，每个功能和完整的文档： **[github.com/mongo-manager/mongo-manager](https://github.com/mongo-manager/mongo-manager)**

## 安装

```sh
npx @mongo-manager/app                 # try it
npm install --global @mongo-manager/app
```

离线或气隙：复制发布tarball并安装它。它没有依赖关系，也不运行安装脚本。

```sh
npm install --global ./mongo-manager-<version>.tgz
```

需要Node.js 24或更新版本。

## 使用

```sh
mongo-manager                     # local mode on http://127.0.0.1:4321, opens your browser
mongo-manager --auth              # team mode: users, roles, two-factor sign-in
mongo-manager --help              # all commands and options
```

| 命令 | 目的 |
| --- | --- |
| `start` | 启动web UI（默认命令） |
| `open [--no-open]` | 使用新的一次性链接打开正在运行的本地模式Mongo Manager |
| `forget-browsers` | 将每个浏览器退出本地模式（然后每个浏览器都需要一个新链接） |
| `user add <name> --role admin|editor|viewer` | 创建用户 |
| `user reset-password <name>` | 设置一个新密码，并在任何地方注销用户 |
| `user reset-2fa <name>` | 删除用户的双因素方法（管理员恢复） |
| `user list` | 用户列表 |
| `bans list` | 列出禁止团队模式登录的地址 |
| `bans lift <address>` / `bans lift --all` | 取消登录禁令（你自己的地址，没有会话），或者每个人 |
| `access list` | 列出团队模式面板回答的地址（空列表：每个地址） |
| `access clear` | 让每个地址再次到达面板（管理员被锁定） |
| `rotate-key` | 用新密钥重新加密所有存储的秘密。首先停止服务器。 |
| `doctor` | 检查安装和数据目录 |
| `service install` | 作为与机器一起启动的系统服务运行（root或Administrator） |
| `service uninstall` | 删除服务；保存数据、配置和密钥（root或Administrator） |
| `service status|logs [-f]` | 显示服务状态或其日志(`-f` 遵循;不支持Windows) |
| `service open` | 打印一个以本地模式（root或Admin）打开服务的一次性链接 |
| `backup inspect <file>` | 列出备份文件所包含的内容 |
| `backup decrypt <file.mmbak> -o <file>` | 将加密的备份解密为普通归档文件 `mongorestore` 可以阅读 |
| `backup decrypt … --key-file <kit.txt>` | 对于使用备份密钥及其恢复套件密封的计划备份也是如此 |
| `version` | 打印版本 |

每个服务器选项也有一个 `MM_*` 例如，环境变量 `MM_WEB_PORT`， `MM_AUTH=1` 或者 `MM_DATA_DIR`.

## 在服务器上

团队模式，背后的反向代理服务HTTPS (nginx, Caddy)：

```sh
mongo-manager --auth --host 127.0.0.1 --trusted-proxies 127.0.0.1 --allowed-hosts mongo.example.com
```

第一个start打印一次性设置令牌；打开地址并创建第一个管理员。 现成的nginx和Caddy配置，系统服务和Docker在 [部署/](https://github.com/mongo-manager/mongo-manager/tree/main/deploy)。使用 `--base-path /mongo/` 在子路径下提供。

## 安全笔记

-   **听地址。** Mongo Manager听着 `127.0.0.1` 默认情况下。它拒绝监听网络地址 `--auth`.
    
-   **数据目录。** 所有内容都位于数据目录（默认）中 `~/.mongo-manager`，模式0700)：
    
    -   数据库;
    -   加密密钥 `secret.key` (0600)模式。您可以通过 `MM_SECRET_KEY`；
    -   在本地模式下， `launch.key` （模式0600）：一次性发射链接的秘密来源。只有打开这种链接的浏览器才能使用本地模式；在Mongo Manager停止时删除该文件，以签署每个浏览器退出。
    
    将数据目录和密钥一起备份。如果没有密钥，保存的连接密码将无法解密。
    
-   **命令行上的密码。** 永远不要将密码作为命令行参数传递；其他用户可以在进程列表中看到它们。
    
    -   `user` 命令提示符输入密码，或使用 `--password-stdin`.
    -   使用 `MM_URI` 而不是 `--uri` 用于包含密码的连接字符串。

## 许可证

[知识共享署名-非商业用途-相同方式共享4.0国际（CC BY-NC-SA 4.0）](https://github.com/mongo-manager/mongo-manager/blob/main/LICENSE)： 免费使用，共享和改编，并注明出处，不用于商业目的，并在相同的情况下共享 许可证。捆绑的第三方组件保留自己的许可证(`dist/THIRD-PARTY-NOTICES.txt`）。

## 作者

**Gokhan OZGEZER** · [gokhanozgezer@gmail.com](mailto:gokhanozgezer@gmail.com) · [GitHub](https://github.com/gokhanozgezer) · [问题](https://github.com/mongo-manager/mongo-manager/issues)

## 常见问题

### @mongo-manager/app 是什么？

MongoDB管理器：一个安全的，离线的MongoDB管理器在您的浏览器。

### 如何安装 @mongo-manager/app？

在项目目录运行 npm install @mongo-manager/app，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mongo-manager，可以用 npx mongo-manager 直接运行。

### @mongo-manager/app 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/mongo-manager\_\_app 是否存在。

### @mongo-manager/app 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @mongo-manager/app 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @mongo-manager/app 可以商用吗？

@mongo-manager/app 使用 CC-BY-NC-SA-4\.0 许可。声明的许可为 CC-BY-NC-SA-4\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @mongo-manager/app 还在维护吗？

最新版本 1\.0\.0 发布于 2026/11/02（1 天前）；至今共发布 2 个版本，其中过去 12 个月发布了 2 个；首次发布于 2026/11/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。