带有 Web GUI 的轻量级网络 IP 扫描器。特征:
找到新主机时发送通知
监控主机上下线历史记录
保留网络中所有主机的列表
将数据发送到InfluxDB2
制作Grafana
仪表板
将$YOURTIMEZONE
替换为正确的时区,将$YOURIFACE
替换为您要扫描的网络接口。网络模式必须是host
。设置$DOCKERDATAPATH
为容器保存数据:
docker run --name wyl -e "IFACES=$YOURIFACE" -e "TZ=$您的时区" --网络=“主机” -v $DOCKERDATAPATH/wyl:/data/WatchYourLAN aceberg/watchyourlan
Web GUI 应该位于 http://localhost:8840
WatchYourLAN没有内置的身份验证选项。但您可以将它与 SSO 工具(例如 Authelia)或我的简单身份验证应用程序 ForAuth 一起使用。
这是 docker-compose-auth.yml 的示例。
⚠️ 警告!
请不要忘记 WYL 需要host
网络模式才能工作。因此,WYL 端口将在此设置中公开。您需要使用防火墙或其他措施来限制对其的访问。
所有二进制包都可以在最新版本中找到。有.deb
、 .rpm
、 .apk
(Alpine Linux) 和.tar.gz
文件。
支持的架构: amd64
、 i386
、 arm_v5
、 arm_v6
、 arm_v7
、 arm64
。
依赖项: arp-scan
、 tzdata
。
对于amd64
有可用的deb
存储库
配置可以通过配置文件、GUI 或环境变量来完成。变量名称与config_v2.yaml
文件相同,但为小写。
多变的 | 描述 | 默认 |
---|---|---|
泰兹 | 将时区设置为正确时间 | |
主持人 | 收听地址 | 0.0.0.0 |
港口 | Web GUI 端口 | 8840 |
主题 | 来自 https://bootswatch.com 的任何主题名称(小写或附加) | 沙 |
颜色 | 背景颜色:浅色或深色 | 黑暗的 |
节点路径 | 本地节点模块的路径 | |
SHOUTRRR_URL | WatchYourLAN 使用 Shoutrrr 发送通知。它已经集成,只需要一个正确的 URL。 Discord、Email、Gotify、Matrix、Ntfy、Pushover、Slack、Telegram、Generic Webhook 等示例均位于此处 |
多变的 | 描述 | 默认 |
---|---|---|
IFCES | 要扫描的接口。可以是一个或多个,以空格分隔。请参阅文档/VLAN_ARP_SCAN.md。 | |
暂停 | 扫描之间的时间(秒) | 120 |
ARP_ARGS | arp-scan 的参数。启用debug 日志级别以查看生成的命令。 (示例: -r 1 )。请参阅文档/VLAN_ARP_SCAN.md。 | |
ARP_STRS ARP_STRS_JOINED | 请参阅文档/VLAN_ARP_SCAN.md。 | |
日志级别 | 日志级别: debug 、 info 、 warn 或error | 信息 |
TRIM_HIST | 在(小时)后删除历史记录 | 48 |
HIST_IN_DB | 将历史记录存储在数据库中 - 如果为false ,历史记录将仅存储在内存中,并且在应用程序重新启动时将丢失。不过,它将使应用程序数据库保持较小(建议使用 InfluxDB 进行长期历史存储) | 错误的 |
使用数据库 | sqlite 或postgres | sqlite |
PG_连接 | 连接到 PostgreSQL 的地址。 (例如: postgres://username:[email protected]:5432/dbname?sslmode=disable )。 URL 参数的完整列表请参见此处 |
此配置与 Grafana 的 InfluxDB 数据源配置匹配
多变的 | 描述 | 默认 | 例子 |
---|---|---|---|
流入_启用 | 启用导出到 InfluxDB2 | 错误的 | 真的 |
INFLUX_SKIP_TLS | 跳过 TLS 验证 | 错误的 | 真的 |
流入地址 | 地址:InfluxDB2服务器端口 | https://192.168.2.3:8086/ | |
流入桶 | InfluxDB2 存储桶 | 测试 | |
INFLUX_ORG | InfluxDB2 组织 | 家 | |
INFLUX_TOKEN | 秘密令牌,由 InfluxDB2 生成 |
配置文件名为config_v2.yaml
。例子:
arp_args: ""颜色: darkhist_in_db: falsehost: 0.0.0.0ifaces: enp4s0influx_addr: ""influx_bucket: ""influx_enable: falseinflux_org: ""influx_skip_tls: falseinflux_token: ""log_level: infonodepath: ""pg_connect: ""端口: "8840" shoutrrr_url:“gotify://192.168.0.1:8083/AwQqpAae.rrl5Ob/?title=检测到未知主机&DisableTLS=yes”主题:sandtimeout:60trim_hist:48use_db:sqlite
钥匙 | 描述 | 默认 |
---|---|---|
-d | 配置目录的路径 | /数据/WatchYourLAN |
-n | 节点模块的路径(见下文) |
默认情况下,此应用程序从互联网获取主题、图标和字体。但是,在某些情况下,独立于全球网络设置可能会很有用。我创建了一个包含所有必要模块和字体的单独图像。使用 Docker 运行:
docker run --name 节点引导 -p 8850:8850 aceberg/节点引导
docker run --name wyl -e "IFACES=$YOURIFACE" -e "TZ=$您的时区" --网络=“主机” -v $DOCKERDATAPATH/wyl:/data/WatchYourLAN aceberg/watchyourlan -n "http://$YOUR_IP:8850"
或者使用 docker-compose
移至 docs/API.md
Python API 客户端,作者:drwahl
依赖项中列出的所有 go 包
网站图标和徽标:由 Freepik - Flaticon 创建的接入点图标
引导程序
主题:Bootstrap 的免费主题