# iobroker\.fb-guard 中文文档

规范地址：https://npmcn.com/package/iobroker.fb-guard/

版本：0\.1\.3
npm 元数据更新时间：2026-11-03T20:53:28.220Z
中文译文更新时间：2026-11-03T22:33:14.520Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1 MB，56 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>= 22
- 运行依赖：2 个
- 首次发布：2026-10-11T21:58:40.983Z
- 最新版本发布：2026-11-03T20:53:27.688Z
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

为您的FRITZ提供保安！盒式路由器：通过电报或电子邮件报告登录失败、端口打开、固件更新待定和弱设置

## 安装

```sh
npm install iobroker.fb-guard
```

也可以使用：`pnpm add iobroker.fb-guard`、`yarn add iobroker.fb-guard`、`bun add iobroker.fb-guard`

## README

![Logo](https://npmcn.com/package/iobroker.fb-guard/admin/fb-guard.png)

# ioBroker.fb-guard

[![NPM version](https://img.shields.io/npm/v/iobroker.fb-guard.svg)](https://www.npmjs.com/package/iobroker.fb-guard) [![Downloads](https://img.shields.io/npm/dm/iobroker.fb-guard.svg)](https://www.npmjs.com/package/iobroker.fb-guard) ![Number of Installations](https://iobroker.live/badges/fb-guard-installed.svg) ![Current version in stable repository](https://iobroker.live/badges/fb-guard-stable.svg)

**测试:** ![Test and Release](https://github.com/Flyor/ioBroker.fb-guard/workflows/Test%20and%20Release/badge.svg)

留意你的安全 [弗里茨!盒子](https://fritz.com/) 并在出现问题时通过电报或电子邮件告诉你。

[德国的文档](https://npmcn.com/package/iobroker.fb-guard/docs/de/README.md)

## 为什么

无论谁进入了你的盒子的用户界面，他就控制了你的整个家庭网络：端口转发、DNS、电话、VPN访问。这可以通过猜测或泄露的密码，固件中的安全漏洞，或者很久以前打开并被遗忘的转发来发生。盒子会将大部分内容写入其事件日志，但没有人会读它，也不会警告您。

Fb-guard帮你读。它会向盒子本身（用户界面、远程访问、应用程序、TR-064）报告失败和意外登录，另外，还会报告使用错误密钥无法连接Wi-Fi的设备。它还关注使攻击更容易的设置。

## 检查什么

-   **失败的登录** 从事件日志中，按地址分组，包括时间、用户名、访问类型以及它是来自Internet还是您的家庭网络
-   **Wi-Fi登录失败** （错误的键），按设备分组，并提示框是否已经知道该设备
-   **从互联网登录** 都不在你的已知地址列表上
-   **开放端口**：端口转发，MyFRITZ，远程访问，互联网上的FTP， TR-069和UPnP。每个端口都有一个简短的解释，说明它通常用于什么。你故意开的端口可以一次确认
-   **固件**：可用但未安装的更新，自动更新关闭，实验室（beta）固件和更新的实验室版本，以及您的模型是否仍然得到更新或该更换新盒子了
-   **设置**：出厂密码仍然有效，无密码登录，双因素认证关闭，新盒子用户，打开或弱Wi-Fi加密，WPS
-   **盒子重启** （重新启动时清除事件日志）
-   一个 **从0到100分** 你的仪表盘

适配器只能读取。它永远不会改变盒子上的任何东西，只和你自己的盒子说话。

## 设置

1.  安装适配器并打开设置。标签引导您浏览它。
2.  在适配器的盒子上创建一个单独的用户，只使用正确的“FRITZ!”框设置”，没有互联网接入。
3.  点击“测试连接”。
4.  选择电报和/或电子邮件并发送测试消息。

所有的发现都列在设置选项卡“发现”中，每个发现都有一个解释。预期的结果（例如您自己设置的端口转发）可以在那里打勾，并且不再报告。如果它们有任何变化，你会再次收到通知。你可以选择每天或每周通过电报或电子邮件查看所有打开的内容。

## 安全和隐私

-   密码以加密方式存储在ioBroker中，不会写入日志。
-   与盒子的连接使用TLS。盒子证书的密钥在第一次使用时被记住，如果发生更改，适配器将停止登录。“Test connection”显示证书指纹，您可以与方框进行比较。
-   在登录被拒绝后，适配器停止尝试，因此它不会将您锁定。
-   默认情况下，外部服务是关闭的。现在只有一个：固件比较。它从供应商下载服务器、fritz.com上的公共产品支持列表以及实验室固件的公共实验室页面读取版本文件。最多只发送模型名。
-   端口测试只检查您自己的WAN地址。
-   诊断掩码密码，密钥，用户名，地址和序列号。
-   提示：通过HTTPS使用iobbroker管理，这样您的条目也会在途中加密。

不保证：此适配器可以帮助您发现问题，但它本身并不能使您的网络安全。

## 免责声明

弗里茨!,弗里茨!盒子,弗里茨!OS和我的fritz ！是FRITZ的商标！GmbH是一家现代化的、可靠的。本项目不隶属于FRITZ或由FRITZ认可！GmbH（原AVM）。不保证安全，使用风险自负。

## 更新日志

### 0.1.3 (2026-11-03)

-   （Flyor）消息和状态在所有iobbroker语言中都可用
-   （Flyor）摘要和供应商检查在随机时间运行，因此并非所有系统都同时访问服务

### 0.1.2 (2026-10-12)

-   （Flyor）受信任的证书与邮箱地址及其密钥绑定，因此更新的证书或新的邮箱地址不再发出警报
-   （Flyor）“再次信任证书”完全接受来自警告的证书
-   （Flyor）测试连接显示证书指纹，更严格地检查权限
-   （Flyor）可读适配器标题
-   （Flyor）与供应商服务器的固件比较可以在当前文件格式下再次工作
-   （Flyor）实验室固件被报告，更新的实验室版本可以在供应商实验室页面上找到
-   （Flyor） README解释了适配器的用途
-   （Flyor）每台设备报告Wi-Fi登录失败（密钥错误）
-   （Flyor）报告模型何时不再更新，使用供应商支持列表

### 0.1.1 (2026-10-11)

-   （Flyor）更清晰的日志信息：网络问题和内部错误不再混淆
-   （Flyor）按几次“立即运行”不再排队相同的检查
-   （飞行员）包裹里的小清理

### 0.1.0 (2026-10-11)

-   （Flyor）第一次发布：登录失败，打开端口，固件和设置检查，设置中的发现和确认，设置向导，电报和电子邮件

旧的变化在 [CHANGELOG\_OLD.md](https://npmcn.com/package/iobroker.fb-guard/CHANGELOG_OLD.md)。

## 许可证

麻省理工学院的许可

版权所有2026 Flyor [AskMe@Stonehiller.de](mailto:AskMe@Stonehiller.de)

特此向任何获得副本的人免费授予许可 本软件及相关文档文件（“软件”），以处理 不受任何限制，包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或出售 本软件的副本，并允许使用本软件的人 提供这样做，但须符合以下条件：

上述版权声明和本许可声明应包括在所有 本软件的副本或实质性部分。

本软件是“按原样”提供的，没有任何形式的、明示的或明示的保证 默示，包括但不限于对适销性的保证； 适合某一特定目的和不侵权。在任何情况下都不得 作者或版权持有人应对任何索赔、损害赔偿或其他责任 在合同诉讼、侵权诉讼或其他诉讼中，因下列原因引起的责任： 不属于或与本软件或本软件的使用或其他交易有关 软件。

## 常见问题

### iobroker\.fb-guard 是什么？

为您的FRITZ提供保安！盒式路由器：通过电报或电子邮件报告登录失败、端口打开、固件更新待定和弱设置

### 如何安装 iobroker\.fb-guard？

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

### iobroker\.fb-guard 支持 TypeScript 吗？

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

### iobroker\.fb-guard 支持 ESM 还是 CommonJS？

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

### iobroker\.fb-guard 需要什么版本的 Node\.js？

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

### iobroker\.fb-guard 可以商用吗？

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

### iobroker\.fb-guard 还在维护吗？

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