DHCP Service Bot
21e3d61871
New /scan page lists all active devices on the subnet (ARP scan): - 静态绑定: matches a host declaration - 动态分配: matches a dhcpd.leases entry - 未知 / 外部: nothing matches (manually configured or from other DHCP server) Click '转为静态绑定' to convert a discovered device to a static host binding. Also includes: - arp-scan wrapper in dhcp_ops.py (get_local_network, arp_scan, classify_devices) - /scan route with optional auto-refresh every 30s - README updated with arp-scan install step + new feature bullet
DHCP Web Manager
一个用 Flask 写的轻量级 ISC DHCP (dhcpd) Web 管理界面，底层直接复用系统自带的 isc-dhcp-server， 不引入额外 daemon。提供 Web 界面来管理 subnet / 静态 host 绑定 / 监听接口 / 查看租约 / 操作日志。
功能
- 🟢 子网（subnet）增删改：网段、掩码、网关、DNS、地址池、租期
- 🟢 静态绑定（host）：MAC + 固定 IP + 主机名
- 🟢 监听接口配置（INTERFACESv4）
- 🟢 租约查询（按 IP/MAC/主机名搜索）+ 地址池使用率
- 🟢 网络扫描（arp-scan）：列出网段内活跃设备，标记 静态绑定 / 动态分配 / 未知
- 🟢 服务状态 + reload / restart + 语法检查
- 🟢 操作日志（谁在什么时间做了什么）
- 🟢 用户名密码登录 + 改密
- 🟢 所有变更自动：写文件 → 备份 →
dhcpd -t语法检查 →systemctl restart isc-dhcp-server（带 is-active 验证）
文件结构
dhcp-service/
├── app.py # Flask 主程序
├── dhcp_ops.py # dhcpd.conf 读写 + leases 解析 + 服务控制
├── requirements.txt
├── instance/dhcp.db # SQLite（用户、日志）
├── backups/ # dhcpd.conf 自动备份（最多保留 20 份）
├── templates/ # Jinja2 模板
└── static/style.css
安装
apt-get install -y isc-dhcp-server arp-scan dhcping # 后端 DHCP 服务 + 扫描工具
pip3 install -r requirements.txt --break-system-packages
启动
开发模式：
python3 app.py # 监听 0.0.0.0:5100
生产模式（推荐用 gunicorn）：
gunicorn --workers 2 --bind 0.0.0.0:5100 'app:app'
默认账号：admin / admin（首次登录后请到「改密」修改）。
关键设计
配置文件组织
我们改写 /etc/dhcp/dhcpd.conf，但只动我们管理的区段——通过标记：
# 原有的通用配置（option domain-name 等）保持不变
option domain-name "example.org";
default-lease-time 600;
...
# >>> DHCP-WEB-MANAGER BEGIN >>>
authoritative;
subnet 192.168.1.0 netmask 255.255.255.0 {
option routers 192.168.1.1;
...
}
host printer {
hardware ethernet aa:bb:cc:dd:ee:01;
fixed-address 192.168.1.50;
}
# <<< DHCP-WEB-MANAGER END <<<
系统原有的 option / 注释 / 不认识的配置都不丢。备份在 backups/dhcpd.conf.<timestamp>.bak（最多 20 份）。
变更流程
所有写操作都走同一个流程（在 app.py: apply_and_reload）：
- 读现有 subnets/hosts → 追加/替换 → 生成新的 conf 文本
- 先备份到 backups/
- 写到
/etc/dhcp/dhcpd.conf - 跑
dhcpd -t语法检查 — 失败则回滚到备份（不修改数据库） - 通过则
systemctl reload isc-dhcp-server（不丢连接）
接口绑定
/etc/default/isc-dhcp-server 中的 INTERFACESv4="enp0s31f6"。
保存接口配置会重启（而非 reload）服务，因为接口绑定变更不支持热加载。
租约解析
直接读 /var/lib/dhcp/dhcpd.leases 并 regex 解析 lease 块。注意 dhcpd 每次写入 leases 文件时
会以临时名写入后 rename 替换，所以解析时可能短暂读到空内容——前端解析失败的话就是 0 条，不报错。
部署到生产
按本机惯例，dev 仓库在 /root/dhcp-service/，生产部署在 /root/.openclaw/workspace/dhcp-service/：
# 1. 把代码复制到生产目录
mkdir -p /root/.openclaw/workspace/dhcp-service
cp -r /root/dhcp-service/{app.py,dhcp_ops.py,requirements.txt,templates,static} \
/root/.openclaw/workspace/dhcp-service/
# 2. systemd unit (示例)
cat > /etc/systemd/system/dhcp-web-manager.service <<EOF
[Unit]
Description=DHCP Web Manager (Flask)
After=network.target
[Service]
Type=simple
User=root
WorkingDirectory=/root/.openclaw/workspace/dhcp-service
ExecStart=/usr/bin/gunicorn --workers 2 --bind 0.0.0.0:5100 'app:app'
Restart=on-failure
RestartSec=5
Environment=PYTHONUNBUFFERED=1
[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable --now dhcp-web-manager
访问 http://<server-ip>:5100。
注意事项
- 本程序必须以 root 跑，因为需要写
/etc/dhcp/dhcpd.conf和控制 systemd 服务。 - 修改 subnet/host 走 reload（不丢现有租约），但改 INTERFACESv4 必须 restart。
dhcpd -t语法检查失败时不会回滚配置，但也不会 reload——服务继续按旧配置运行， 操作日志记录失败原因。修改者可以修正后重试。- 数据库
instance/dhcp.db不要 commit 到 git。
备份恢复
所有 conf 改动前会自动备份到 backups/，恢复：
ls backups/
cp backups/dhcpd.conf.20260709_120000.bak /etc/dhcp/dhcpd.conf
systemctl reload isc-dhcp-server