lan-device-scanner hzjackboy/lan-device-scanner:latest https://hub.docker.com/r/hzjackboy/lan-device-scanner host sh false https://raw.githubusercontent.com/hzjackboy/lan-device-scanner/main/docs/icon.png http://[IP]:[PORT:8765]/ 零依赖的局域网设备扫描服务：认出设备、记住设备，不需要 root，也不装任何第三方包。 打开页面就能看到局域网里所有联网设备——IP、MAC、厂商、主机名、设备类型、开放端口、延迟，并且把它们长期记成一本可编辑的台账：掉线的设备不删除，谁来过、谁什么时候走的都查得到。 发现手段：ARP 缓存 → UDP 触发 ARP 解析（非 root 拿真实 MAC，能发现禁 ping 的设备）→ 并发 ICMP → mDNS/Bonjour → 反向 DNS → NetBIOS → TCP 端口指纹。 主要功能：设备台账（别名 / 分类 / 位置 / 标签 / 备注 / 图标，重扫不覆盖人工内容）、在线离线饼图、设备方块墙（列表 / 大 / 中 / 小四种展示密度）、扫描历史、网段热力图、CSV/JSON 导出、服务端定时重扫。 默认账号 admin / admin，首次登录强制改密。 ⚠️ 安装时网络类型必须是 Host，否则扫不到真实局域网。 局域网设备扫描服务 —— 零依赖 Python 扫描引擎 + 实时 Web 界面。 **安装后**：浏览器打开 `http://你的UnraidIP:8765`，用默认账号 `admin` / `admin` 登录。 **⚠️ 首次登录会强制要求修改密码**（服务端强制，改密前所有业务接口都会被拒绝），新密码至少 8 位。之后可在侧边栏「用户管理」里加账号：`admin` 可管理，`viewer` 只读。 用户与会话存在 `/app/data`（`users.json` / `sessions.json` / `local_token`），已随模板里的台账目录一起持久化。 **关于网络类型**：必须是 `Host`。这个工具靠 ARP（二层广播域）发现设备，bridge 网络下容器被 NAT，容器的 `/proc/net/arp` 里只有 docker 网段，扫不到真实局域网。host 网络下端口直接占用宿主机 8765，所以不要配端口映射。 **持久化**：台账、日志、定时重扫配置都在 `/app/data`，模板里已映射到 `/mnt/user/appdata/lan-device-scanner`。建议放在缓存池上，避免每次扫描唤醒机械盘阵列。 **可选：更全的厂商表**（内内置 2600+ 条常见厂商，全量表 4 万条需另外下载）： ``` docker exec lan-device-scanner python3 update_oui.py --out /app/data/oui.csv docker restart lan-device-scanner ``` **安全提示**：服务自带登录（默认 `admin`/`admin`，首次登录强制改密），但局域网内是**明文 HTTP**——密码和会话 Cookie 没有 TLS 保护。只在可信网络里运行；要跨不可信网络访问，请在前面套一层 HTTPS 反向代理，并确保该代理转发 SSE 且关闭响应缓冲（Nginx 里 `proxy_buffering off;`），否则页面不会实时刷新。 请只扫描自己有权管理的网络。 https://github.com/hzjackboy/lan-device-scanner/issues https://github.com/hzjackboy/lan-device-scanner https://raw.githubusercontent.com/hzjackboy/lan-device-scanner/main/templates/lan-device-scanner.xml https://raw.githubusercontent.com/hzjackboy/lan-device-scanner/main/README.md Network:Other Tools:Utilities lan scan arp mdns network devices inventory 局域网 扫描 设备 台账 安装时网络类型必须选 Host（bridge 下 ARP 扫不到局域网） v1.4.1：修复侧边栏收起后图标不对齐（间距与内边距残留把图标推离中轴，折叠按钮还被挤出轨道裁掉，收起后只能靠 Ctrl+B 展开）；顺带修掉窄屏抽屉里不显示用户名的问题。 v1.4.0：新增登录与访问控制——默认账号 admin / admin，首次登录强制修改密码；新增用户管理页与只读（viewer）角色，列表带最近登录 IP；上传前修复了 auth.py 未打进镜像、健康检查打到需登录接口两个问题。 v1.3.0：设备总览支持列表 / 大 / 中 / 小四种展示密度；按常见分辨率适配；设备图标可人工指定。 2026-10-01 6.1 7.3 MIT https://raw.githubusercontent.com/hzjackboy/lan-device-scanner/main/docs/screenshot-home.png /mnt/user/appdata/lan-device-scanner Asia/Shanghai 8765