matijag/fortag-home-assistant

# Home Assistant 的 Fortag Network Scanner  Fortag 可发现私有本地网络上的设备和开放端口，并将结果显示在 Home Assistant 的侧边栏面板中。此仓库仅包含 Home Assistant 集成及其已编译的面板。 必须运行独立的 Fortag scanner，且需与 Home Assistant 连接到同一个 MQTT broker。 ## 环境要求 - 已配置 MQTT 集成的 Home Assistant - 正在运行的 Fortag scanner - HACS，作为推荐的安装方式 该 scanner 以多架构 Docker 镜像 [`matijag/fortag`](https://hub.docker.com/r/matijag/fortag) 的形式提供。它需要 host networking 来发现本地设备，并需要一个持久化卷来存储其 SQLite 数据库。 ## 通过 HACS 安装 在 Fortag 被纳入 HACS 默认仓库之前，请将其添加为自定义仓库： 1. 在 Home Assistant 中打开 **HACS**。 2. 打开右上角的三点菜单，选择 **Custom repositories**。 3. 输入 `https://github.com/matijag/fortag-home-assistant`。 4. 选择 **Integration** 作为类别，然后添加该仓库。 5. 在 HACS 中找到 **Fortag Network Scanner** 并下载。 6. 重启 Home Assistant。 7. 将以下内容添加到 `configuration.yaml` 中，然后再次重启 Home Assistant： fortag_scanner: 管理员的侧边栏中将会出现 **Network Scanner** 面板。 ## 升级 从 HACS 安装可用的更新，并在出现提示时重启 Home Assistant。 scanner 容器单独进行版本控制，发布兼容版本时也应一并更新。 ## Beta 测试 Fortag 的 beta 版本需要主动选择启用。在 HACS 中，打开 Fortag 集成的预发布开关即可接收诸如 `1.0.1b1` 的版本；关闭开关即可保持在稳定版本。 为了进行协调测试，请使用不可变的候选发布标签（例如 `matijag/fortag:1.0.17-rc.1`）来运行 scanner。不断移动的 `matijag/fortag:beta` 标签指向最新的 scanner beta 版本。Beta 构建永远不会替换 `matijag/fortag:latest`。 ## 卸载 1. 从 `configuration.yaml` 中移除 `fortag_scanner:`。 2. 通过 HACS 移除该集成。 3. 重启 Home Assistant。 移除此集成不会删除 scanner 的 SQLite 数据库。 ## MQTT 接口 该集成会监听 `fortag/scanner` 下的 scanner 状态、进度和安全警报，并通过 MQTT 将扫描、重命名、确认和范围更改等面板命令转发回去。Scanner 状态会报告 MQTT API 版本 `1` 以及 scanner 的构建版本，以便在面板中直观查看兼容性。 ## 支持 请通过 [GitHub issue 跟踪器](https://github.com/matijag/fortag-home-assistant/issues) 报告集成和面板问题。 请勿在 issue 报告中包含 MQTT 密码、私有网络清单或未经脱敏处理的扫描结果。 ## 许可协议 Fortag 的 Home Assistant 集成基于 [MIT License](LICENSE) 发布。 编译后的面板包含 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) 中所述的第三方开源软件。

标签：Home Assistant, 云存储安全, 智能家居, 物联网, 网络扫描, 自定义脚本, 设备发现, 请求拦截, 逆向工具