# iobroker\.admin 中文文档

规范地址：https://npmcn.com/package/iobroker.admin/

版本：8\.3\.7
npm 元数据更新时间：2026-11-03T20:23:59.835Z
中文译文更新时间：2026-11-03T22:59:46.223Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/iobroker.admin
原文对照：https://npmcn.com/package/iobroker.admin/?lang=original
项目主页：https://github.com/ioBroker/ioBroker.admin
源码仓库：https://github.com/ioBroker/ioBroker.admin

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

- 包体积（解压后）：56 MB，540 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19\.0
- 运行依赖：20 个
- 首次发布：2014-12-04T18:45:44.907Z
- 最新版本发布：2026-11-03T20:23:59.530Z
- 已发布版本数：575（近 12 个月 70 个）

## 中文简介

适配器为iobbroker管理UI打开一个web服务器。

## 安装

```sh
npm install iobroker.admin
```

也可以使用：`pnpm add iobroker.admin`、`yarn add iobroker.admin`、`bun add iobroker.admin`

## README

![](https://npmcn.com/package/iobroker.admin/admin/admin.svg)

# ioBroker.admin

![Number of Installations](http://iobroker.live/badges/admin-installed.svg) ![Number of Installations](http://iobroker.live/badges/admin-stable.svg) [![NPM version](http://img.shields.io/npm/v/iobroker.admin.svg)](https://www.npmjs.com/package/iobroker.admin)

![Test and Release](https://github.com/ioBroker/ioBroker.admin/workflows/Test%20and%20Release/badge.svg) [![Translation status](https://weblate.iobroker.net/widgets/adapters/-/admin/svg-badge.svg)](https://weblate.iobroker.net/engage/adapters/?utm_source=widget) [![Downloads](https://img.shields.io/npm/dm/iobroker.admin.svg)](https://www.npmjs.com/package/iobroker.admin)

用于配置和管理iobbroker的用户界面。

**该适配器使用Sentry库自动向开发人员报告异常和代码错误。** 有关详细信息以及如何禁用错误报告的信息，请参见 [Sentry-Plugin文档](https://github.com/ioBroker/plugin-sentry#plugin-sentry)！ 哨兵报告从js-controller 3.0开始使用。

## JSON配置模式

JSON配置模式描述可以在 [JSON配置模式](https://npmcn.com/packages/jsonConfig/README.md)。

## 使用common.localLink

-   `%ip%` - iobbroker的ip地址（管理员的地址）
-   `%secure%` 或 `%protocol%` ——读自 `native.secure` 取值，请使用HTTP或HTTPS
-   `%web_protocol%` -查找web的第一个实例(例如： `web.0`)，得到 `native.secure` 从 `system.adapter.web.0`
-   `%instance%` -适配器的实例
-   `%someField%` -从 `native` 这个适配器实例的
-   `%web.0_bind%` ——得到 `native.bind` 从 `system.adapter.web.0`
-   `%native_someField%` -从 `native` 这个适配器实例的

## 计划重启

有些适配器不稳定，或者一两天后连接消失。 要解决这个问题，有一个计划重启设置。 要激活计划重启，只需在重启适配器时定义CRON条件。

建议在夜间，当没有人使用适配器时重新启动。 `0 3 * * *` -每天3点。

## 让我们加密证书

为了管理和更新，让我们加密您需要使用的证书 [`iobroker.acme`](https://github.com/iobroker-community-adapters/ioBroker.acme) 适配器。

您将拥有所谓的证书“集合”。每个集合都有自己的域。 您可以在管理适配器的配置中选择要使用哪个集合。

## 简单实例的设置页面

用户可以限制对实例配置对话框的访问。 为此，必须激活“仅允许访问特定实例”选项。 它可以在“访问实例”选项卡上找到。 此外，应该在出现的配置表中选择允许的实例。

如果禁用此选项，则可以在下面访问简单配置页面 `http://IP:8081/configs.html`

## 人工智能助理

管理界面包括一个AI助手（右下角的浮动按钮）。它可以回答 有关您的iobbroker系统的问题，为设备或服务推荐适配器，并在“操作”模式下进行 您明确确认后的更改。必须首先在管理实例设置中启用助手 （`native.disableMcp` 必须关闭)；然后在助手设置对话框中选择AI提供商、凭证和模型。

### 使用没有API密钥的助手（外部MCP客户端）

如果你不想在ioBroker中配置AI提供者/API密钥，你可以从 外部AI客户端（Claude Desktop、Codex、Gemini CLI等）。客户端直接连接到iobbroker MCP（模型上下文协议）服务器。

打开助手并单击 **“无需API密钥即可使用”** 按钮（标题中的电缆图标）。的对话框 引导你完成三个步骤：

1.  **安装MCP服务器** -安装 `iobroker.mcp` 适配器，理想情况下作为您的web扩展 `web` (或 `admin`)实例。它将ibroker的工具暴露给任何兼容mcp的AI客户端。对话框显示是否 适配器已经安装。
2.  **在AI客户端中添加MCP服务器** -在客户端注册一个新的MCP服务器，使用中显示的URL 对话框中,如。 `http(s)://<host>:<port>/mcp`． 对话框列出了您的安装的实际端点 嵌入式管理端点和任何 `web`/`mcp` 实例)以及复制按钮。
3.  **系统提示** -同一对话框还显示内置助手使用的确切系统提示，带有 只读/动作切换和复制按钮。有意不在这里转载；从对话中抄一遍 将其粘贴为AI客户端的系统/指令提示，以获得相同的行为。

## 反向代理

反向代理文档可以在 [反向代理](https://npmcn.com/package/iobroker.admin/REVERSE_PROXY.md)。

## 使用图标

这个项目使用的图标来自 [Flaticon](https://www.flaticon.com/)。

iobbroker GmbH拥有所有使用图标的有效许可证。 没有适当的平面化许可或平面化订阅，这些图标不得在其他项目中重复使用。

[旧的更新日志](https://npmcn.com/package/iobroker.admin/CHANGELOG_OLD.md)

## 更新日志

### 8.3.7 (2026-11-03)

-   (@GermanBluefox) `checkDocker` 控件显示了该主机上实例的管理主机的Docker，如果该实例使用了另一个Docker——例如，适配器名称所在的NAS上的Docker `iobDockerApi` 的插件配置，或者在实例设置中选择。现在，admin也询问其主机的js-controller，如果它可以检查Docker (`CONTROLLER_CHECK_DOCKER`)：它检查实例的Docker连接，使用 `@iobroker/plugin-docker` 适配器的。如果它不能——一个旧的js控制器，一个没有插件的适配器——admin会像以前一样检查它的主机本身的Docker
-   (@GermanBluefox)更新 `@iobroker/json-config` 10.1.11: `validatorErrorText` 显示在元素的下面，而不是帮助文本，同样在表格的单元格中（#1911）
-   （@GermanBluefox）历史数据：活值每10秒被标记并替换为存储值；添加了一个重载按钮（ibroker .sql#600）
-   （@GermanBluefox）更新也可以忽略，如果它的依赖关系不满足（#3713）
-   （@GermanBluefox）增加：启动/停止，状态，通知，菜单，重新加载，删除，连接和命令结果的动画图标
-   （@GermanBluefox）增加：实例的开始/停止按钮显示一个环，直到实例真正运行或停止
-   （@GermanBluefox）更改：新的专家模式符号（迫击炮）
-   （@GermanBluefox）添加：对象浏览器中的动画文件夹；实例的重启按钮会一直转动，直到实例再次激活
-   （@GermanBluefox）更改：日志的暂停按钮显示新行作为徽章的数量
-   （@GermanBluefox）固定：访问控制对话框崩溃与“错误在GUI”和所有者或组不能改变，如果孩子有不同的所有者或组（#3711）

### 求值(2026-10-29)

-   （@GermanBluefox）固定： `checkDocker` 配置对话框的控件显示了管理员运行的主机的Docker，也用于另一个主机上的实例。管理员现在询问实例的主机；主机需要一个js-controller `CONTROLLER_CHECK_DOCKER`． 使用旧的js-controller时，对话框显示无法检查Docker，而不是显示错误的主机
-   (@GermanBluefox)更新 `@iobroker/json-config` 到10.1.9： `checkDocker` 控件命名实例的主机
-   (@GermanBluefox)更新 `@iobroker/json-config` 到10.1.10：新选项 `allowReorder` 的 `table` 让行重新排序 `noDelete: true` (# 3707);实例设置的导出/导入按钮不再覆盖最后的选项卡（#3613,#3657）
-   （@GermanBluefox）增加：OpenRouter在系统设置的AI设置中作为提供商(`@iobroker/ai-core` 0.0.6, `@iobroker/ai-gui` 0.0.5)
-   （@GermanBluefox）增加：概览的“资源使用”图表可以显示任何记录的数据点，不仅仅是CPU和RAM -有自己的名称，颜色和历史实例每个数据点都是从记录它的历史实例中读取的，因此也显示了InfluxDB或SQL记录的值，如果默认的历史实例没有记录它们，也会显示CPU和RAM （#3705）

### 8.3.5 (2026-10-26)

-   （@GermanBluefox）固定：单点登录后，访问和刷新令牌被放入地址(`?ssoLoginResponse=`)，因此它们最终出现在浏览器历史记录和反向代理的日志中。现在只有一个一次性代码，管理员用它获取令牌。连接身份后返回的ID令牌(`?id_token=`（包括姓名和电子邮件）不再保存，也没有人使用它
-   （@GermanBluefox）固定：一个单点登录的会话cookie是可读的脚本，并沿着跨站点请求发送，不像一个密码登录
-   （@GermanBluefox）固定：背后的反向代理与https的单点登录发送 `http://.../sso-callback` 到与注册的重定向URI不匹配的标识提供程序。现在的协议来自 `X-Forwarded-Proto`，可以在SSO设置中设置admin的外部地址
-   （@GermanBluefox）对于在8.3.4之前使用管理员开启单点登录的每个人来说都很重要：更新后与其他人连接的用户的身份保持连接。在“用户”页面上检查每个单点登录的用户是否与正确的帐户连接，并断开其他用户的连接
-   （@GermanBluefox）固定：设备管理器崩溃，如果一个设备的滑块得到的值不是一个数字（#3699）
-   （@GermanBluefox）增加：系统设置有一个“AI”选项卡来设置AI提供商，它的API密钥和模型一次为整个系统；只有一个提供者可以是活动的
-   （@GermanBluefox）更改：系统设置的选项卡在左边，上面有图标，手机在上面
-   （@GermanBluefox）更改：AI助手从系统设置的“AI”选项卡中获取提供商，密钥和模型

### 8.3.4 (2026-10-25)

-   固定：付费适配器的许可对话框一直为空，无法接受，因此适配器无法安装。对话框加载 `licenseInformation.link` 作为许可文本，但该链接命名了包含价格和购买地点的页面，浏览器可能无法读取这些页面。许可证文本同样来自适配器的存储库，并且在它旁边显示了链接。不能加载的许可文本不再阻塞对话框，不需要滚动的短Markdown文本可以被接受（#3311,ioBroker/ioBroker.vis-2#707）
-   （@agross）改进了活动存储库警告的英文措辞。
-   （@GermanBluefox）固定：“添加单点登录”在用户对话框发送用户的显示名称，而不是用户ID，所以连接失败的每个用户的名字不同于ID

### 8.3.3 (2026-10-23)

-   （@GermanBluefox）固定：对象浏览器显示一个对象两次，并复制其行，而滚动，如果兄弟ID以相同的文本开头，后跟一个空格（#3693）

## 许可证

麻省理工学院许可证（MIT）

蓝狐版权所有 [dogafox@gmail.com](mailto:dogafox@gmail.com)

[完整的许可文本](https://npmcn.com/package/iobroker.admin/LICENSE)

## 常见问题

### iobroker\.admin 是什么？

适配器为iobbroker管理UI打开一个web服务器。

### 如何安装 iobroker\.admin？

在项目目录运行 npm install iobroker\.admin，或使用 pnpm add / yarn add / bun add。

### iobroker\.admin 支持 TypeScript 吗？

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

### iobroker\.admin 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### iobroker\.admin 需要什么版本的 Node\.js？

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

### iobroker\.admin 可以商用吗？

iobroker\.admin 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### iobroker\.admin 还在维护吗？

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