leiweibau/Pi.Alert

# 目录 * [介绍](#pialert) * [扫描方式](#scan-methods) * [后端](#backend-back) * [前端](#frontend-front) * [安装说明](#installation) * [更新](#update) * 附加信息 * [首次启动指南](docs/FIRST_START_GUIDE.md) * [常见问题](docs/HELP_FAQ.md), [故障排除](docs/TROUBLESHOOTING.md) * [截图](docs/SCREENSHOTS.md), [Favicons/Homescreen icons](docs/ICONS.md) * [设备管理](docs/DEVICE_MANAGEMENT.md) * [批量编辑器](docs/BULKEDITOR.md) * [pialert-cli](docs/PIALERTCLI.md), [pialert.conf](docs/PIALERT_CONF.md) * [网络关系](docs/NETWORK_RELATIONSHIP.md) * [Web service 监控](docs/WEBSERVICES.md) * [Satellite 配置](docs/SATELLITES.md) * [卸载 Pi.Alert](docs/UNINSTALL.md) * [结束语](#closing-words) # Pi.Alert 带有 Web service 监控功能的 WIFI / LAN 入侵检测器。主要功能如下： - 扫描连接到 WIFI/LAN 的设备，并在发现未知设备连接时接收警报。 - 根据您的通知设置，当网络中出现新设备或已知设备失去连接时接收通知。 - 通过评估 HTTP 状态码、SSL 证书和服务响应时间来检查 Web service 的可用性。 - 如果 SSL 证书发生更改、HTTP 状态码发生改变，或者服务变得不可访问，则接收通知。 - 检测不需要的/外来的 DHCP 服务器 - 对于您自身子网之外的设备，使用 ping 命令进行设备监控 此外还有一个配套脚本 [Pi.Alert-Satellite](https://github.com/leiweibau/Pi.Alert-Satellite)， 它可以自行执行扫描，并将结果发送到现有的 Pi.Alert 实例。  [将此 fork 与主项目进行对比](docs/VERSIONCOMPARE.md) ### 扫描方式与导入 **arp-scan**（使用 arp 帧搜索设备的系统实用工具）， **Pi-hole DNS**（v5 或 v6），**Pi-hole DHCP**。（v5 或 v6）， **Fritzbox**（活动主机），**Mikrotik**（DHCP 分配），**UniFi**（客户端设备），**OpenWRT**（活动主机）， **AsusWRT**（活动主机），**pfSense**（活动主机、DHCP 分配、ARP 表），**OPNSense**（活动主机、DHCP 分配、ARP 表）， **Adguard Home**（DHCP 分配，“活动主机” - 使用最新的 DNS 查询进行检测）， **Satellite 扫描**（arp-scan、Pi-hole v6 DNS、Pi-hole v6 DHCP、Mikrotik、UniFi、OpenWRT、AsusWRT、pfSense、OPNSense、Adguard Home） ### 后端 (back) 后端由操作系统自带的 cron 服务控制，并以 5 分钟为间隔执行。后端的任务是执行各种扫描和导入， 将结果保存在数据库中，并根据设置发送通知。除了主机检测之外，还可以手动输入主机或网站来检查其可达性，并在状态发生变化时接收通知。 通知支持多种服务（前端、邮件（[指南](docs/NOTIFICATION_MAIL.md)）、[Pushsafer](https://www.pushsafer.com/)、 [Pushover](https://pushover.net/)、ntfy 以及通过 shoutrrrr 发送的 Telegram（[指南](docs/NOTIFICATION_SHOUTRRR.md)））。 ### 前端 前端用于管理已确定的主机信息并进行常规管理。您可以为每台设备存储附加信息、查看历史记录、执行手动的 nmap 扫描或发送 Wake-on-LAN 命令。 您还可以选择将各个设备分配给其他网络设备（例如路由器和交换机），以便清晰掌握设备之间的关系。设置页面允许您配置前端的各个部分， 而配置文件编辑器则允许您配置后端。用户界面支持英语、德语、西班牙语、法语、意大利语、波兰语、丹麦语、荷兰语、捷克语、 芬兰语、瑞典语、挪威语、立陶宛语、乌克兰语和俄语，并受登录保护；密码在安装过程中随机生成，并显示在安装过程结束时。 您可以使用 CLI 工具 [pialert-cli](docs/PIALERTCLI.md) 进行更改。 基于原始设计创建了新的 [Favicons/Homescreen icons](docs/ICONS.md)，并针对不同的皮肤进行了定制。为了确保与 iOS 设备兼容，图标可以直接从代码库中链接，因为 iOS 设备可能不会从不安全的来源（没有 SSL 或自签名 SSL）加载主屏幕图标。 您可以借助 [API](docs/API-USAGE.md) 向后端发送各种请求。该 API 还可用于在 Home Assistant 或 [Homepage](https://github.com/gethomepage/homepage) 中创建集成。 # 安装说明 最初设计为在 Raspberry Pi 上运行，它可能也可以在其它使用 "apt" 包管理器的 Linux 发行版上运行。在其他基于 Debian 的发行版（如 DietPi 或 Ubuntu Server）上使用 Pi.Alert 之前，请查看“[使用不同 Linux 发行版时的注意事项](docs/LINUX-DISTRIBUTIONS.md)”，以了解是否有需要遵循的特殊说明。

安装
``` sudo bash -c "$(wget -qLO - https://github.com/leiweibau/Pi.Alert/raw/main/install/pialert_install.sh)" ```

- [首次启动指南](docs/FIRST_START_GUIDE.md) - 如果您想**将 Pi.Alert 作为 LXC container 使用**，请随时查看 [Proxmox VE Helper-Scripts](https://github.com/community-scripts/ProxmoxVE)（最初源自 [tteck/Proxmox (已归档)](https://github.com/tteck/Proxmox)）。我也支持这个版本，因为除了初始 container 创建之外，使用的就是这个 Pi.Alert 版本。LXC 版本的更新也是从此代码库安装的。为此目的使用了单独的更新命令。 :bulb: 附加组件和信息 - [使用不同 Linux 发行版时的注意事项](docs/LINUX-DISTRIBUTIONS.md)（如有必要将会更新） - 可以在这里找到一个基于 Docker 的 Pi.Alert 初始 fork 但现已独立的版本，名为 NetAlertX：[jokob-sk/NetAlertX](https://github.com/jokob-sk/NetAlertX) - 最初发布但目前已停止维护的 Pi.Alert 可以在这里找到 [pucherot/Pi.Alert](https://github.com/pucherot/Pi.Alert/) # 更新 您随时可以使用侧边栏中的“Update Check”按钮来检查新版本。此检查将向您显示是否已安装或是否需要更新 GeoLite2 DB，以及如果您尚未使用最新版本，新的 Pi.Alert 发行版中提供了哪些新功能、修复或更改。

更新程序
``` sudo bash -c "$(wget -qLO - https://github.com/leiweibau/Pi.Alert/raw/main/install/pialert_update.sh)" ```

🟢 迁移到新安装路径的帮助 [在这里](docs/MIGRATION_HOME_TO_OPT.md) 旧版本的存档可以在 [https://leiweibau.net/archive/pialert](https://leiweibau.net/archive/pialert/) 找到。此存档包含了我的 fork 的所有发行说明。 # 结束语 ### 额外使用的组件和服务 [动态 GIF（加载动画）](https://commons.wikimedia.org/wiki/File:Loading_Animation.gif)， [自托管字体](https://github.com/adobe-fonts/source-sans)， [Bootstrap Icons](https://github.com/twbs/icons)， [Material Design Icons](https://github.com/Pictogrammers)， [用于背景图像的最终处理](https://www.imgonline.com.ua/eng/make-seamless-texture.php)， [DeepL](https://www.deepl.com)， [ChatGPT](https://chat.openai.com) ### 许可证 GPL 3.0 [在此阅读更多内容](LICENSE.txt) ### 联系方式 leiweibau@gmail.com

标签：ffuf, Web服务监控, 局域网, 应用安全, 插件系统, 数据可视化, 网络安全, 设备发现, 运维工具, 逆向工具, 隐私保护