热门搜索:
jokobsk/netalertx
jokobsk
NetAlertX 是一款监控WIFI/LAN网络并对新设备进行警报的网络扫描与通知框架，可通过插件扩展功能，支持网络设备发现、状态监控及实时通知。
34 次收藏下载次数: 0状态：社区镜像维护者：jokobsk仓库类型：镜像最近更新：15 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
![]([] ![Home Assistant]([***]
NetAlertX - 网络扫描与通知框架
| https://github.com/jokob-sk/NetAlertX/blob/main/docs/DOCKER_INSTALLATION.md | https://github.com/jokob-sk/NetAlertX/releases | https://jokob-sk.github.io/NetAlertX/ | https://github.com/jokob-sk/NetAlertX/blob/main/docs/PLUGINS.md | 🤖 询问AI |
|---|
访问 [***] 查看更多动图和截图 📷。
[!NOTE] 还提供实验性 🧪 https://github.com/jokob-sk/NetAlertX/blob/main/docs/HW_INSTALL.md 方法。
📕 基本用法
[!WARNING] 除非使用其他 https://github.com/jokob-sk/NetAlertX/blob/main/docs/PLUGINS.md%EF%BC%8C%E5%90%A6%E5%88%99%E5%BF%85%E9%A1%BB%E5%9C%A8
host网络上运行容器并指定SCAN_SUBNETS。初始扫描可能需要几分钟，请等待 5-10 分钟完成初始设备发现。
bashdocker run -d --rm --network=host \ -v /local_data_dir:/data \ -v /etc/localtime:/etc/localtime \ --tmpfs /tmp:uid=20211,gid=20211,mode=1700 \ -e PORT=20211 \ -e APP_CONF_OVERRIDE={"GRAPHQL_PORT":"20214"} \ ghcr.io/jokob-sk/netalertx:latest
查看其他 https://github.com/jokob-sk/NetAlertX/blob/main/docs/DOCKER_COMPOSE.md%E3%80%82
默认端口
| 默认值 | 描述 | 如何覆盖 |
|---|---|---|
20211 | Web 界面端口 | -e PORT=20222 |
20212 | 后端 API 服务器端口 | -e APP_CONF_OVERRIDE={"GRAPHQL_PORT":"20214"} 或通过 GRAPHQL_PORT 设置 |
Docker 环境变量
| 变量 | 描述 | 示例值 |
|---|---|---|
PORT | Web 界面端口 | 20211 |
LISTEN_ADDR | 为 nginx Web 服务器（Web 界面）的监听器地址设置特定 IP 地址。当使用多个子网时，这有助于将 Web 界面隐藏在所有不受信任的网络之外。 | 0.0.0.0 |
LOADED_PLUGINS | 要加载的默认 https://github.com/jokob-sk/NetAlertX/blob/main/docs/PLUGINS.md%E3%80%82%E6%97%A0%E6%B3%95%E9%80%9A%E8%BF%87 APP_CONF_OVERRIDE 加载插件，需使用此变量，然后通过 APP_CONF_OVERRIDE 指定插件设置。 | ["PIHOLE","ASUSWRT"] |
APP_CONF_OVERRIDE | 设置的 JSON 覆盖（LOADED_PLUGINS 除外）。 | {"SCAN_SUBNETS":"['192.168.1.0/24 --interface=eth1']","GRAPHQL_PORT":"20212"} |
ALWAYS_FRESH_INSTALL | ⚠ 若为 true，将删除 /db 和 /config 文件夹内容。用于测试目的。可与 https://github.com/containrrr/watchtower 配合使用，以始终使用全新安装的 netalertx/netalertx-dev 镜像。 | true |
可通过
APP_CONF_OVERRIDE环境变量覆盖默认 GraphQL 端口设置GRAPHQL_PORT（默认为20212）。LOADED_PLUGINS和APP_CONF_OVERRIDE中的设置也可通过 UI 指定。
Docker 路径
[!NOTE] 另见 https://github.com/jokob-sk/NetAlertX/blob/main/docs/BACKUPS.md%E3%80%82
| 必需 | 路径 | 描述 |
|---|---|---|
| ✅ | :/data | 包含 /db/app.db、/config/app.conf 和 /config/devices.csv（https://github.com/jokob-sk/NetAlertX/blob/main/docs/DEVICES_BULK_EDITING.md%EF%BC%89%E6%96%87%E4%BB%B6%E7%9A%84%E6%96%87%E4%BB%B6%E5%A4%B9 |
| ✅ | /etc/localtime:/etc/localtime:ro | 确保时区与服务器相同。 |
:/tmp/log | 日志文件夹，若设置容器时遇到问题，此文件夹有助于调试 | |
:/tmp/api | https://github.com/jokob-sk/NetAlertX/blob/main/docs/API.md%EF%BC%8C%E5%8C%85%E5%90%AB%E9%9D%99%E6%80%81%EF%BC%88%E4%BD%86%E5%AE%9A%E6%9C%9F%E6%9B%B4%E6%96%B0%EF%BC%89JSON 和其他文件。路径可通过 NETALERTX_API 环境变量配置。 | |
:/app/front/plugins/<plugin>/ignore_plugin | 映射 ignore_plugin 文件以忽略插件。可通过设置软禁用插件。更多信息见 https://github.com/jokob-sk/NetAlertX/blob/main/docs/PLUGINS.md%E3%80%82 | |
:/etc/resolv.conf | 使用自定义 resolv.conf 文件以实现 https://github.com/jokob-sk/NetAlertX/blob/main/docs/REVERSE_DNS.md%E3%80%82 |
请使用单独的
db和config目录，不要嵌套它们。
初始设置
- 若配置文件不存在，应用首次运行时会生成默认的
app.conf和app.db文件。 - 首选方式是通过 UI 中的“设置”部分管理配置，若无法访问 UI，可直接修改
/data/config/文件夹中的 https://github.com/jokob-sk/NetAlertX/tree/main/back%E3%80%82
设置扫描器
必须指定要扫描的网络。通过输入主机可访问的子网来完成。若使用默认 ARPSCAN 插件，必须在 SCAN_SUBNETS 设置中至少指定一个有效的子网和接口。有关故障排除和更高级场景，请参阅 https://github.com/jokob-sk/NetAlertX/blob/main/docs/SUBNETS.md 文档。
若运行 PiHole，可直接同步设备。详情请查看 https://github.com/jokob-sk/NetAlertX/blob/main/docs/PIHOLE_GUIDE.md%E3%80%82
[!NOTE] 可通过 https://github.com/jokob-sk/NetAlertX/blob/main/docs/DEVICES_BULK_EDITING.md 批量导入设备。
社区指南
您可以阅读或观看多种语言的 https://github.com/jokob-sk/NetAlertX/blob/main/docs/COMMUNITY_GUIDES.md%EF%BC%8C%E5%8C%85%E6%8B%AC%E4%B8%AD%E6%96%87%E3%80%81%E9%9F%A9%E6%96%87%E3%80%81%E5%BE%B7%E6%96%87%E5%92%8C%E6%B3%95%E6%96%87%E3%80%82
请注意这些指南可能已过时。请优先参考官方文档。
常见问题
- 创建新 issue 前，请检查是否存在 https://github.com/jokob-sk/NetAlertX/issues?q=is%3Aissue+is%3Aclosed%E3%80%82
- 另请查看常见问题和 https://github.com/jokob-sk/NetAlertX/blob/main/docs/DEBUG_TIPS.md%E3%80%82
💙 支持我
| 
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"