作品

Knock 访问日志监控

轻量访问日志、事件记录和安全边界验证服务

状态
MVP
类型
基础设施
更新

一个服务端日志监控模块,用于记录访问事件、解析日志并验证公网入口的基础鉴权边界。

可验证入口

体验与源码

不提供公开 Demo

监控页面依赖真实访问日志并可能暴露 IP、请求路径和运行时间线,因此不提供公开 Demo。

源码证据

查看日志解析、增量 ingest、SQLite schema、聚合 API、鉴权和静态 dashboard。

证据

MVP 形态

已覆盖访问事件记录、日志解析和基础鉴权入口

测试边界

Node 22 和原生模块 ABI 是当前本地验证前提

运营价值

可作为 Dashboard Console 的运行摘要来源

资产状态

只展示仓库中可验证的 product mock、公开文档或明确的暂无公开图说明。

资产类型: 架构图

Knock 当前架构:Nginx 日志经增量读取和解析后写入 SQLite WAL,再由 Express API 提供给受保护界面
仅展示当前已实现的单机数据流与 Basic Auth,不含真实日志;Dashboard 摘要和告警标为 roadmap。

资产类型: 文档链接

查看 Knock 运行说明

公开文档记录日志输入、配置、鉴权要求、构建测试和 Windows 部署入口。

查看 Knock 运行说明

问题

个人项目上线后容易缺少最小可用的访问观察能力,出现异常访问、配置错误或公开入口风险时不易定位。

方案

用 Node 服务收集、解析和展示关键访问事件,并通过可选 Basic Auth 控制监控入口访问。

我的工作

  • Node 服务实现
  • 日志解析
  • Basic Auth 接入
  • 运行文档维护

技术栈

  • Node.js
  • TypeScript
  • better-sqlite3
  • node:test

亮点

  • 部署成本低
  • 鉴权配置清晰
  • 适合接入 Dashboard 汇总

架构与实现

Knock 增量读取 Nginx access log,解析后写入本机 SQLite;Express API 聚合时间窗口、状态码和可疑请求,并由 Basic Auth 保护监控界面。

  1. 步骤 01

    Nginx access log

    服务按已保存的文件 offset 增量读取日志,并识别截断或轮转。

  2. 步骤 02

    解析与标记

    解析请求字段并标记可疑访问,批量写入同一事务。

  3. 步骤 03

    SQLite WAL

    本机数据库保存请求记录、索引和可配置保留周期的数据。

  4. 步骤 04

    Express API

    按 1h、24h 或 7d 窗口输出概览、时间序列、Top IP、Top Path 和可疑请求。

  5. 步骤 05

    受保护的监控界面

    静态 dashboard 调用同源 API;对外暴露时要求 Basic Auth 或等效访问控制。

关键决策与影响

  1. 决策 01

    增量读取日志而不是重复扫描完整文件

    为什么这样做
    offset state 可以在轮询时只处理新增字节,并对截断或轮转做 best-effort 恢复。
    带来的影响
    单机持续采集开销更低,但 state 文件和日志路径必须保持一致。
  2. 决策 02

    使用 SQLite WAL 保存监控数据

    为什么这样做
    个人服务器需要低维护、可查询且无需独立数据库服务的存储。
    带来的影响
    部署简单并支持聚合查询,但仍是单机、单写入形态。
  3. 决策 03

    监控入口使用 Basic Auth 边界

    为什么这样做
    访问日志包含 IP、路径和 user-agent,不能作为无保护的公开页面。
    带来的影响
    可覆盖个人运维入口,但不能替代完整的多用户权限与审计系统。

取舍

  • SQLite 降低部署和维护成本,但不适合高并发或多实例写入。
  • Basic Auth 足够覆盖个人项目监控入口,但不是完整权限系统。
  • 保留周期清理随 ingest 执行,配置简单,但停用 ingest 时不会独立运行清理任务。

Roadmap

  • 接入 Dashboard 摘要卡片
  • 补日志轮转与保留周期运行观测
  • 完善部署健康检查和告警信号

当前限制

  • 完整测试依赖 Node 22 ABI
  • 当前仍是单机 SQLite 形态

下一步

  • 接入 Dashboard 摘要
  • 验证日志轮转恢复
  • 完善部署健康检查

继续浏览

相关入口