Initial: DHCP 客户端监控双模式

- client 模式抓取水星 MW305R DHCP 列表,记录上下线,本地看板
- server 模式收上报,按站点分组持久化,多站点看板,7天滚动
- ESP8266 低功耗固件抓原始 HTML 上报 /api/raw,服务器端解析
- 部署脚本+systemd 单元+文档,交叉编译 Linux 二进制
This commit is contained in:
Sakurasan committed 2026-10-13 23:37:04 +08:00
commit 88a35ea427
20 files changed
+3007

No files matched your search

+114
View File
@@ -0,0 +1,114 @@
# VPS 部署 dhcp-mon server(收集 + 看板)
server 模式:公网监听 HTTP 端口,接收采集端(树莓派 client / ESP8266 raw)上报,按站点分组存储,提供多站点看板。
## 一、本机交叉编译(已产出)
```bash
# 在项目根目录
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o dhcp-mon-linux-amd64 .
GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -o dhcp-mon-linux-arm64 .
```
产物:
- `dhcp-mon-linux-amd64` —— x86_64 静态编译,绝大多数 VPS 用这个
- `dhcp-mon-linux-arm64` —— ARM64 静态编译(如 AWS Graviton / 树莓派 4)
> 静态编译(`CGO_ENABLED=0`),无需服务器装 Go,直接拷上去就能跑。
## 二、拷贝到 VPS
```bash
scp dhcp-mon-linux-amd64 deploy/dhcp-mon-server.service deploy/install-server.sh \
user@<VPS_IP>:/tmp/
```
## 三、服务器上执行部署
```bash
sudo bash /tmp/install-server.sh /tmp/dhcp-mon-linux-amd64 你的令牌 8080
```
脚本会:
1. 把二进制装到 `/opt/dhcp-mon/dhcp-mon`
2. 创建专用用户 `dhcpmon` + 数据目录 `/srv/dhcp-data`
3. 写配置 `/etc/dhcp-mon-server.env`(仅 root 可读,含令牌)
4. 安装并启动 systemd 服务,开机自启
部署完成会打印:
- **看板地址**:`http://<服务器IP>:8080/?token=你的令牌`
- **令牌**(上报与看板共用)
- 查看状态/日志的命令
### systemd 单元(/etc/systemd/system/dhcp-mon-server.service)
```ini
[Service]
User=dhcpmon
EnvironmentFile=/etc/dhcp-mon-server.env
ExecStart=/opt/dhcp-mon/dhcp-mon -mode server -web $WEB_ADDR -data $DATA_DIR -stoken $STOKEN -retain $RETAIN_DAYS
Restart=always
RestartSec=5
```
`/etc/dhcp-mon-server.env`:
```
WEB_ADDR=:8080
DATA_DIR=/srv/dhcp-data
STOKEN=你的令牌
RETAIN_DAYS=7
```
## 四、验证
```bash
systemctl status dhcp-mon-server # 应显示 active (running)
curl -s 'http://127.0.0.1:8080/?token=你的令牌' | head # 看到看板 HTML
curl -s 'http://127.0.0.1:8080/api/sites?token=你的令牌' # 站点列表(初始 {sites:[],...})
```
## 五、放行端口
```bash
# firewalld
sudo firewall-cmd --add-port=8080/tcp --permanent && sudo firewall-cmd --reload
# ufw
sudo ufw allow 8080/tcp
```
若走公网/有域名,建议在 Nginx/Caddy 反代并上 HTTPS(见下文)。
## 六、采集端配置(ESP8266 secrets.h)
`firmware/esp8266/src/secrets.h`:
```
SERVER_URL = "http://<服务器IP>:8080/api/raw"
X_TOKEN = 与 STOKEN 一致
X_SITE = 站点名(如 home)
```
树莓派 client 模式上报对应 `-report http://<IP>:8080/api/report -token STOKEN -site home`。
## 七、(可选)Nginx 反代 + HTTPS
```nginx
server {
listen 80;
server_name dhcp.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
server_name dhcp.example.com;
ssl_certificate /etc/letsencrypt/live/dhcp.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/dhcp.example.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
```
> 看板与上报用同一 token 保护;反代仅加密传输,不改变令牌机制。ESP8266 的 `SERVER_URL` 改用 `https://...` 即可(需固件支持 TLS,当前固件为 HTTP 直连,如走 HTTPS 需评估内存)。
+22
View File
@@ -0,0 +1,22 @@
[Unit]
Description=dhcp-mon server (DHCP client monitor dashboard)
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=dhcpmon
Group=dhcpmon
EnvironmentFile=/etc/dhcp-mon-server.env
ExecStart=/opt/dhcp-mon/dhcp-mon -mode server \
-web ${WEB_ADDR} \
-data ${DATA_DIR} \
-stoken ${STOKEN} \
-retain ${RETAIN_DAYS}
Restart=always
RestartSec=5
# 数据目录持久化
# 建议同时做数据目录备份(可 cron 定期 rsync)
[Install]
WantedBy=multi-user.target
+51
View File
@@ -0,0 +1,51 @@
#!/usr/bin/env bash
# dhcp-mon server 一键部署脚本(VPS)
# 用法:
# sudo ./install-server.sh <dhcp-mon-linux-amd64 路径> [stoken] [端口]
# 示例:
# sudo ./install-server.sh ./dhcp-mon-linux-amd64 MySecretToken 8080
# (stoken 缺省时自动生成并打印)
set -euo pipefail
BIN="${1:?用法: sudo ./install-server.sh <二进制路径> [stoken] [端口]}"
STOKEN="${2:-$(openssl rand -hex 16)}"
PORT="${3:-8080}"
APP=/opt/dhcp-mon
DATA=/srv/dhcp-data
USER=dhcpmon
echo "==> 安装二进制到 $APP"
install -d "$APP"
install -m 0755 "$BIN" "$APP/dhcp-mon"
"$APP/dhcp-mon" -h >/dev/null 2>&1 || true # 顺手验证可执行(server 模式参数见 README)
echo "==> 创建专用用户与数据目录"
id "$USER" >/dev/null 2>&1 || useradd -r -s /usr/sbin/nologin "$USER"
install -d -o "$USER" -g "$USER" -m 0755 "$DATA"
echo "==> 写入环境配置 /etc/dhcp-mon-server.env (权限 600)"
install -d /etc
umask 077
cat > /etc/dhcp-mon-server.env <<EOF
WEB_ADDR=:${PORT}
DATA_DIR=${DATA}
STOKEN=${STOKEN}
RETAIN_DAYS=7
EOF
chown root:"$USER" /etc/dhcp-mon-server.env
chmod 640 /etc/dhcp-mon-server.env
echo "==> 安装 systemd 单元"
SRC="$(cd "$(dirname "$0")" && pwd)/dhcp-mon-server.service"
install -m 0644 "$SRC" /etc/systemd/system/dhcp-mon-server.service
systemctl daemon-reload
systemctl enable --now dhcp-mon-server
echo
echo "✅ 部署完成"
echo " 令牌(上报与看板共用): $STOKEN"
echo " 看板: http://<服务器IP>:${PORT}/?token=${STOKEN}"
echo " 状态: systemctl status dhcp-mon-server"
echo " 日志: journalctl -u dhcp-mon-server -f"
echo
echo " ⚠️ 把令牌记好/改掉: 可随时编辑 /etc/dhcp-mon-server.env 后 systemctl restart dhcp-mon-server"