监控飞牛 NAS 事件日志（数据库 logger_data.db3 的 log 表），并推送多平台通知。
- 数据库轮询：定时轮询 eventlogger 的 SQLite 数据库，仅处理启动后的新记录
- 多平台通知：企业微信、钉钉、飞书、Bark、PushPlus
- Web 配置页：内置配置 UI（默认端口
18080），支持 Webhook、事件类型、勿扰、标题前缀、PushPlus 等；保存后热加载，一般无需重启 - Web 访问控制：可在页面中设置访问密码（
config.json内保存盐值与哈希）；支持关闭密码校验（web_password_enabled） - 智能去重：时间窗口去重（默认 300 秒）
- 磁盘事件合并：同类型磁盘唤醒/休眠在时间窗口内合并推送
- HTTP 连接池：统一 HTTP 管理与重试
- 勿扰模式：可设置时段内不推送，结束后汇总为一条消息
- 通知失败自愈：连续失败达到阈值时可触发进程内重启通知链路（可通过环境变量关闭或调参）
- Docker 部署：支持 Docker Compose 一键部署，带健康检查
- 配置热加载：通过 Web 保存
config.json后自动生效；环境变量仍优先生效且不会被文件覆盖
以下为 monitor_events 中允许配置的 eventId（与数据库一致；旧配置里已移除的类型会在启动时被过滤）：
- 登录：
LoginSucc,LoginSucc2FA1,LoginFail,Logout - 硬盘：
FoundDisk,DiskWakeup,DiskSpindown,DISK_IO_ERR - 应用：
APP_CRASH,APP_UPDATE_FAILED,APP_START_FAILED_LOCAL_APP_RUN_EXCEPTION,APP_AUTO_START_FAILED_DOCKER_NOT_AVAILABLE,APP_STARTED,APP_STOPPED,APP_UPDATED,APP_INSTALLED,APP_AUTO_STARTED,APP_UNINSTALLED - 系统：
CPU_USAGE_ALARM,CPU_USAGE_RESTORED,CPU_TEMPERATURE_ALARM - UPS：
UPS_ONBATT,UPS_ONBATT_LOWBATT,UPS_ONLINE,UPS_ENABLE,UPS_DISABLE - SSH：
SSH_INVALID_USER,SSH_AUTH_FAILED,SSH_LOGIN_SUCCESS,SSH_DISCONNECTED（优先从宿主机journalctl -u ssh/sshd采集；需挂载/var/log/journal与/etc/machine-id） - 文件与共享：
ARCHIVING_SUCCESS,DeleteFile,MovetoTrashbin,SHARE_EVENTID_DEL,SHARE_EVENTID_PUT - 服务开关：
WEBDAV_ENABLED/WEBDAV_DISABLED,SAMBA_ENABLED/SAMBA_DISABLED,DLNA_ENABLED/DLNA_DISABLED,FTP_ENABLED/FTP_DISABLED,NFS_ENABLED/NFS_DISABLED - 防火墙与安全：
FW_ENABLE,FW_DISABLE,SECURITY_PORTCHANGED - 虚拟机：
SHUTDOWN_VM,STATUS_RUNNING_VM,DESTROY_VM
- 触发推送的原始数据写入
./data/logs（可配置log_dir），按事件类型与日期分文件；保留天数由log_retention_days控制。 - 运行日志：
./data/logs/monitor_YYYYMMDD.log；应用运行日志保留天数由max_log_age控制。 - 游标：
./data/cursor/db_poller_cursor.txt，记录已处理到的log表 id。
# 需在项目根目录，或设置 PYTHONPATH
python tools/log_manager.py stats
python tools/log_manager.py recent --hours 24
python tools/log_manager.py type LoginSucc --limit 10
python tools/log_manager.py export ./logs.json --event-type APP_CRASH
python tools/log_manager.py cleanup 301. 配置通知渠道
至少配置一个推送渠道；环境变量与 Web 配置页二选一即可（亦可混用）。各平台图文说明见 配置通知渠道（内含企业微信、钉钉、飞书、Bark、魔法推送、SMTP 邮件、PushPlus 的独立文档入口）。
未配置任何 Webhook / PushPlus 时进程仍可启动，仅提供 Web 配置页；配置完成后自动开始监控与推送。
| 项 | 说明 |
|---|---|
wechat_webhook_url / dingtalk_webhook_url / feishu_webhook_url / bark_url |
各平台 Webhook 或 Bark URL |
pushplus_params |
PushPlus JSON（可多个，| 分隔） |
title_prefix |
推送标题前缀，留空则使用默认「飞牛NAS」 |
monitor_events |
要监控的事件 ID 列表 |
log_level |
日志级别 |
log_dir / cursor_dir |
日志与游标目录 |
logger_db_path |
SQLite 数据库路径 |
logger_poll_interval |
轮询间隔（秒） |
http_pool_size / http_retry_count / http_timeout |
HTTP 客户端参数 |
dedup_window |
去重时间窗口（秒） |
log_retention_days |
原始推送日志保留天数 |
max_log_age |
应用运行日志 monitor_*.log 保留天数 |
dnd_enabled / dnd_start_time / dnd_end_time |
勿扰开关与时段（HH:MM，可跨日） |
web_password_enabled |
是否要求密码才能访问配置页（默认 true） |
首次在 Web 中设置密码后，会在同文件写入 web_password_salt、web_password_hash（请勿手工泄露）。
除上述 Webhook 外，还可通过环境变量覆盖（已设置的环境变量不会被 config.json 覆盖）：
LOGGER_DB_PATH、LOGGER_POLL_INTERVALMONITOR_EVENTS（逗号分隔）LOG_LEVEL、HTTP_POOL_SIZE、HTTP_RETRY_COUNT、HTTP_TIMEOUT、DEDUP_WINDOWLOG_RETENTION_DAYS、MAX_LOG_AGEUI_PORT：Web 端口（默认18080）LOGTIME_DISPLAY_OFFSET_SECONDS：修正日志时间显示（默认28800，即 +8 小时；若显示不准可调整）NOTIFY_RESTART_ENABLED、NOTIFY_RESTART_CONSECUTIVE、NOTIFY_RESTART_WINDOW、NOTIFY_RESTART_COOLDOWN：通知链路失败重启策略APP_HOME：自定义应用根目录（影响config.json解析路径，一般 Docker 内为/app）
- 默认：
/usr/trim/var/eventlogger_service/logger_data.db3 - 覆盖：
LOGGER_DB_PATH=/path/to/logger_data.db3或在config.json中设置logger_db_path - Docker 需将该文件或所在目录以只读等方式挂载进容器（见下方 Compose 示例或仓库内
docker-compose.yml）。
在任意目录新建 docker-compose.yml，内容如下（或在克隆本仓库后对照修改）：
services:
fn-message-bot:
image: sunanang/fn-message-bots:latest
container_name: fn-message-bot
restart: unless-stopped
ports:
- 18080:18080
volumes:
- ./data/logs:/app/data/logs:rw # 数据目录，可修改
- ./data/cursor:/app/data/cursor:rw # 数据目录，可修改
- /usr/trim/var/eventlogger_service:/usr/trim/var/eventlogger_service:ro # 飞牛系统 eventlogger 目录，路径勿改
# - /var/run/docker.sock:/var/run/docker.sock # 可选：勾选 Docker 容器事件时启用，等同授予 Docker API 访问能力
- ./config:/app/config:rw # 配置目录，可修改
environment:
- TZ=Asia/Shanghai浏览器访问 http://<本机IP>:18080 打开 Web 配置页。./data/logs、./data/cursor、./config 为相对 compose 文件所在目录的路径，可按需调整左侧宿主机路径。
从源码构建：若使用仓库根目录自带的 docker-compose.yml（build: .、服务名可能为 fn-message-bots），同样在项目根执行 docker compose up -d 即可。
依赖：Python 3.9+（见 pyproject.toml）。先安装依赖：pip install -e . 或 pip install -r requirements.txt（与镜像一致）。
PYTHONPATH=. LOGGER_DB_PATH=./logger_data.db3 WECHAT_WEBHOOK_URL=xxx python3 src/main.py├── src/
│ ├── monitor/ # 数据库轮询、事件处理、模型
│ ├── notifier/ # 多平台通知、连接池
│ ├── utils/ # 日志、存储、健康检查、推送统计
│ ├── web/ # Web 配置 UI（Flask）
│ ├── config.py
│ └── main.py
├── config/config.json # 配置文件（可挂载，Web 可写）
├── data/logs # 运行日志与推送存储
├── data/cursor # 轮询游标等
├── tools/log_manager.py
├── docs/ # 文档（notification-channels 与各推送渠道子页）
├── scripts/ # 辅助脚本（如推送历史种子数据等）
├── .github/workflows/ # Docker 多架构 manifest 合并
│ ├── docker-manifest.yml
│ └── merge-manifest.yml
├── Dockerfile
├── docker-compose.yml
├── deploy.sh # 本地 compose 部署
├── healthcheck.sh # 容器健康检查
├── publish-amd64.sh # AMD64 镜像构建与推送
├── publish-arm64.sh # ARM64 镜像构建与推送
├── LICENSE # MIT 许可证全文
└── pyproject.toml
- 收不到通知：检查 Webhook / PushPlus、网络与
docker compose logs。 - 时间不对：调整
LOGTIME_DISPLAY_OFFSET_SECONDS（默认已为 +8 小时）。 - 重复通知：调大
dedup_window（秒）。 - Web 配置页打不开：确认端口映射与防火墙；容器内可设
UI_PORT并与ports一致。 - 忘记 Web 密码：在可信环境下编辑
config.json，删除web_password_salt与web_password_hash后重启，再在页面重新设置密码（或暂时将web_password_enabled设为false）。
创作不易，为了项目的稳定和可持续发展，欢迎大家捐赠支持
 |
 |
- 非官方项目：本仓库为独立开源作品，与飞牛 NAS、企业微信、钉钉、飞书、Bark、PushPlus 等主体无隶属、赞助或背书关系；各产品名称与商标归权利人所有。
- 按现状提供：除开源许可证另有约定外，作者不对本软件的正确性、完整性、安全性或持续可用性作任何明示或默示担保；详见
LICENSE中的免责声明条款。 - 使用风险自负：部署、配置 Webhook / 第三方推送、开放 Web 配置端口、挂载系统路径等行为均由使用者自行评估与承担；请妥善保管
config.json、访问密码与各类 Token，勿将密钥提交到公开仓库。 - 数据与业务影响：监控与推送依赖 NAS 日志库、网络与各通知渠道服务；不保证通知必达、实时或无遗漏，亦不对因依赖本软件而产生的业务中断、数据误解或决策损失承担责任。
- 合规：使用本软件及对接的第三方服务时，请遵守相应平台规则、隐私政策及所在地法律法规。
本项目采用 MIT License。与 README 全文一致的纯文本见仓库根目录 LICENSE。
MIT License
Copyright (c) 2024 Sunanang
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.