让开源，少一点语言距离。
npm包中文文档

iobroker.admin

中文文档
8.3.7发布于 2026/11/04MITCommonJS构建来源已验证

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

中文使用文档
中文原文
文档目录16 节
  1. JSON配置模式
  2. 使用common.localLink
  3. 计划重启
  4. 让我们加密证书
  5. 简单实例的设置页面
  6. 人工智能助理
  7. 使用没有API密钥的助手（外部MCP客户端）
  8. 反向代理
  9. 使用图标
  10. 更新日志
  11. 8.3.7 (2026-11-03)
  12. 求值(2026-10-29)
  13. 8.3.5 (2026-10-26)
  14. 8.3.4 (2026-10-25)
  15. 8.3.3 (2026-10-23)
  16. 许可证

ioBroker.admin

Number of Installations Number of Installations NPM version

Test and Release Translation status Downloads

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

该适配器使用Sentry库自动向开发人员报告异常和代码错误。 有关详细信息以及如何禁用错误报告的信息，请参见 Sentry-Plugin文档！ 哨兵报告从js-controller 3.0开始使用。

JSON配置模式

JSON配置模式描述可以在 JSON配置模式。

  • %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 适配器。

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

简单实例的设置页面

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

如果禁用此选项，则可以在下面访问简单配置页面 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客户端的系统/指令提示，以获得相同的行为。

反向代理

反向代理文档可以在 反向代理。

使用图标

这个项目使用的图标来自 Flaticon。

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

旧的更新日志

更新日志

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）

蓝狐版权所有 [email protected]

完整的许可文本

版本与发布记录

iobroker.admin 共发布 575 个版本，首次发布于 2014/12/05；过去 12 个月发布了 70 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本发布日期距今
8.3.7latest2026/11/041 天前
8.3.62026/10/296 天前
8.3.5stable2026/10/279 天前
8.3.42026/10/2510 天前
8.3.32026/10/2412 天前
8.3.22026/10/2312 天前

其他发布通道：next → 8.0.1-alpha.2，stable → 8.3.5。

关于 iobroker.admin 的常见问题

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 和提交记录判断。