# lan-toolbox **Repository Path**: q411729088/lan-toolbox ## Basic Information - **Project Name**: lan-toolbox - **Description**: 局域网工具箱:设备扫描/端口探测/路由追踪/DNS查询(冰哥爱折腾自研) - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-09-22 - **Last Updated**: 2026-09-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # lan-toolbox 内网工具箱 局域网设备扫描 + 基础网络诊断工具。纯浏览器操作,Docker 一键部署,**仅限内网自查使用**。 「冰哥爱折腾」自研开源工具系列。深色主题(#10141c + 冰蓝主色),支持浅色模式。 ## 功能特性 | 模块 | 说明 | |---|---| | 设备扫描 | 输入网段(如 `192.168.1.0/24`)一键扫描,输出 IP / MAC / 设备厂商(OUI 解析)/ 在线状态 / 主机名(反向 DNS) | | Ping | 输入内网 IP 或域名,实时输出延迟与丢包,支持停止 | | ARP 查询 | 输入 IP 查对应 MAC 与厂商 | | 端口探测 | 轻量 TCP connect 探测,自定义端口范围,支持 risk/common 端口模板(合规核查),仅限内网自查 | | 路由追踪 | 内网目标逐跳输出延迟(SSE 实时流,单实例互斥限流) | | DNS 查询 | A / AAAA / MX / NS / TXT / CNAME / SOA / PTR 八类记录 | | 子网计算 | CIDR 网段数学计算:网络 / 广播 / 掩码 / 通配符 / 可用主机范围 | | ARP 检查 | 网关 MAC 基线比对(防欺骗)、多 IP 同 MAC、本地管理 MAC、OUI 未知检测 | | 网卡总览 | 本机网卡、IP、MAC、MTU、默认网关(跨平台) | ## 界面预览 > 部署后访问 `http://<内网IP>:8891` 截图,替换本段为实际截图。 ## 快速开始 ### Docker 部署(推荐) ```bash docker compose up -d --build # 访问 http://<内网IP>:8891 ``` > 镜像拉不到时,将 `docker-compose.yml` 中 build 基础镜像替换为国内加速源,如 `docker.1ms.run/library/python:3.12-slim`。 ### 本地开发运行 ```bash python3 -m venv .venv && source .venv/bin/activate pip install -r requirements.txt python server.py # 默认 8891,http://localhost:8891 ``` ## API 概览 | 接口 | 方法 | 说明 | |---|---|---| | `/api/health` | GET | 服务健康检查 | | `/api/local-ip` | GET | 本机 IP 与默认网段 | | `/api/scan` | POST | 发起设备扫描,入参 `{"network":"192.168.0.0/24"}` | | `/api/scan/` | GET | 查询扫描任务进度 | | `/api/ping` | GET | Ping 实时结果(SSE),入参 `target`、`count` | | `/api/arp` | GET | ARP 查询,入参 `ip` | | `/api/portscan` | POST | 端口探测(SSE),入参 `target`、`template` 或 `ports`、`timeout` | | `/api/traceroute` | POST | 路由追踪(SSE),入参 `target` | | `/api/dns` | POST | DNS 查询,入参 `host`、`type` | | `/api/subnetcalc` | POST | 子网计算,入参 `cidr` | | `/api/arpcheck` | GET | ARP 安全检查分析 | | `/api/arpcheck/baseline` | POST | 设置网关 MAC 基线 | | `/api/interfaces` | GET | 本机网卡总览 | ## 安全设计(硬约束) - **仅内网**:所有目标(网段 / IP / 域名)强制校验 RFC1918(10/8、172.16/12、192.168/16)或回环、链路本地;解析到公网地址一律 400 拒绝。 - **限流**:扫描全局互斥(同时一个任务)、ping 并发 ≤ 64、单次扫描 ≤ 1024 地址、端口探测 ≤ 500 端口且两次间隔 ≥ 2s。 - **不持久化**:扫描结果只存内存,刷新页面即清空;不写数据库、不写文件、不留扫描历史。 - **禁止公网暴露**:部署走 host 网络或仅绑定内网,勿做端口映射到公网。 ## 环境变量 | 变量 | 默认 | 说明 | |---|---|---| | PORT | 8891 | 监听端口 | | SCAN_CONCURRENCY | 64 | 扫描 ping 并发上限 | | MAX_SCAN_HOSTS | 1024 | 单次扫描地址数上限 | | PING_COUNT | 4 | Ping 默认发包数 | | HOSTNAME_LOOKUP | 1 | 是否解析主机名(0 关闭) | | HOSTNAME_BUDGET_S | 10 | 主机名解析总预算秒数 | | PORTSCAN_MAX_PORTS | 500 | 单次端口扫描数量上限 | | PORTSCAN_CONCURRENCY | 64 | 端口探测并发上限 | | PORTSCAN_TIMEOUT_S | 0.4 | 单端口连接超时(秒) | | PORTSCAN_MIN_INTERVAL | 2 | 两次端口扫描最小间隔(秒) | | TRACEROUTE_MAX_HOPS | 24 | 路由追踪最大跳数 | | FLASK_DEBUG | - | 置 1 启用 Flask 调试模式 | ## 已知限制 - 设备识别依赖 ICMP 回显 + ARP 表;关闭 ICMP 但有 ARP 记录的设备仍会列出(MAC/厂商可得),完全无响应设备不会出现。 - 主机名为反向 DNS 解析结果,内网无 DNS 时多为空。 - ARP 表读取需要 Linux 容器 + host 网络;非该环境 MAC/厂商列不可用(前端会提示)。 - 扫描结果不保存,刷新即清空(预设网段保存在浏览器 localStorage)。 ## 项目结构 ``` lan-toolbox/ ├── server.py Flask 入口 ├── net_tools.py 网络工具核心(校验/扫描/ping/arp/端口/路由追踪/DNS/子网/ARP检查/网卡) ├── oui_db.py MAC 厂商查询 ├── data/oui.txt 厂商库(只读,38k+ 条) ├── static/ WebUI(index.html / style.css / app.js) ├── requirements.txt ├── Dockerfile ├── docker-compose.yml └── README.md ``` ## 开源协议 本项目采用 [MIT License](LICENSE)。 ## 使用说明与免责 - 本工具**仅限个人学习、内网自查、合规测试**用途。 - 请勿对未经授权的网络、设备、系统进行扫描或探测;使用者须自行承担使用本工具产生的全部责任与法律后果。 - 作者不对使用本工具导致的任何直接或间接损失负责。