jokobsk/netalertx Docker Image Overview

jokobsk/netalertx

NetAlertX 是一款监控WIFI/LAN网络并对新设备进行警报的网络扫描与通知框架，可通过插件扩展功能，支持网络设备发现、状态监控及实时通知。

28 收藏0 次下载activejokobsk

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

![Docker Size]([] ![Docker Pulls]([] ![GitHub Release]([] ![]([] ![Home Assistant]([]

NetAlertX - 网络扫描与通知框架

📑 Docker指南	🚀 发布版本	📚 文档	🔌 插件	🤖 询问AI

访问 [***] 查看更多动图和截图 📷。

[!NOTE] 还提供实验性 🧪 裸机安装方法。

📕 基本用法

[!WARNING] 除非使用其他插件扫描器，否则必须在 host 网络上运行容器并指定 SCAN_SUBNETS。初始扫描可能需要几分钟，请等待 5-10 分钟完成初始设备发现。

bash
docker 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

查看其他 docker-compose 示例。

默认端口

默认值	描述	如何覆盖
`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`	要加载的默认插件。无法通过 `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` 文件夹内容。用于测试目的。可与 watchtower 配合使用，以始终使用全新安装的 `netalertx`/`netalertx-dev` 镜像。	`true`

可通过 APP_CONF_OVERRIDE 环境变量覆盖默认 GraphQL 端口设置 GRAPHQL_PORT（默认为 20212）。LOADED_PLUGINS 和 APP_CONF_OVERRIDE 中的设置也可通过 UI 指定。

Docker 路径

[!NOTE] 另见备份策略。

必需	路径	描述
✅	`:/data`	包含 `/db/app.db`、`/config/app.conf` 和 `/config/devices.csv`（了解 devices.csv）文件的文件夹
✅	`/etc/localtime:/etc/localtime:ro`	确保时区与服务器相同。
	`:/tmp/log`	日志文件夹，若设置容器时遇到问题，此文件夹有助于调试
	`:/tmp/api`	API 端点，包含静态（但定期更新）JSON 和其他文件。路径可通过 `NETALERTX_API` 环境变量配置。
	`:/app/front/plugins/<plugin>/ignore_plugin`	映射 `ignore_plugin` 文件以忽略插件。可通过设置软禁用插件。更多信息见插件文档。
	`:/etc/resolv.conf`	使用自定义 `resolv.conf` 文件以实现更好的名称解析。