项目描述

基于 Shell、Python、Docker 与 Linux 运维工具链构建一套轻量级服务器巡检与日志分析工具，覆盖网站可用性检查、Nginx 服务状态检查、系统资源巡检、Nginx access.log 分析、异常请求识别、Markdown 巡检日报生成、容器化运行、结构化异常提取、AI 辅助日志分析、敏感信息脱敏、多 AI Provider 配置、风险通知、只读 Web Dashboard 和 Linux 定时部署。

主要工作

• 编写 Shell 健康检查脚本，检查网站 HTTP 状态码、Nginx 服务状态、磁盘使用率和内存使用率。
• 配置 crontab 定时任务，实现巡检脚本按固定周期自动执行，并将结果写入日志文件。
• 编写 Nginx access.log 分析脚本，统计访问总量、状态码分布、Top IP、404 高频路径和 Referer 来源。
• 识别 .php、wp-content、admin、.env、.git 等常见扫描特征，用于区分正常访问、失效链接和自动化扫描请求。
• 编写 Python 报告生成器，读取健康检查日志，统计 OK、WARNING、ERROR 数量，提取异常项并生成按日期命名的 Markdown 日报。
• 准备固定样本日志和自动测试脚本，验证日志分析结果和报告生成结果是否符合预期，避免后续修改破坏统计逻辑。
• 接入 GitHub Actions，在每次 push 或 Pull Request 时自动执行 Shell、Python、Docker 与 AI 流水线相关检查。
• 编写 Dockerfile 与 compose.yaml，将 Python 日报生成器和 AI 分析流水线封装为可复用的容器任务。
• 编写结构化异常提取脚本，从健康检查日志中提取 WARNING / ERROR，按磁盘、内存、服务状态、可用性和未知类型进行分类，并输出 provider-neutral JSON。
• 设计 AI 日志分析 Prompt 与响应 JSON Schema，限制输出结构、风险等级、异常类别、置信度和人工复核字段。
• 接入 DeepSeek API，并通过统一 Provider 配置支持 OpenAI 和自定义 OpenAI-compatible 服务。
• 编写敏感信息脱敏模块，在发送 AI 前对 URL、IP、主机名、邮箱和 Linux 路径进行占位符替换。
• 编写 AI Markdown 报告渲染脚本，将通过验证的 AI 分析结果转换为人工可读的排查报告。
• 编写一键 AI 巡检流水线，将普通日报、异常提取、AI 分析、Schema 校验、通知发送和 AI Markdown 报告串联为单次运行流程。
• 提供 cron 定时入口脚本，通过外部环境文件加载密钥，并使用 flock 防止定时任务重叠执行。
• 支持按风险阈值发送 generic、Slack 或 Discord Webhook 通知，通知内容只包含风险摘要、Finding 数量和本地报告路径。
• 编写 Nginx JSON 分析器和只读 Web Dashboard，用于展示巡检概览、异常列表、AI 风险、排查步骤、状态码分布和 Top IP。
• 补充 Linux 服务器部署文档和 Docker Compose profile，支持原生 Python 与容器化两种运行方式。

项目成果

完成一套轻量级服务器巡检、Nginx 日志分析、Markdown 日报生成、Docker 化运行、结构化异常提取、AI 辅助日志分析、敏感信息脱敏、风险通知、只读 Dashboard 与定时运行工具。当前项目已经具备 Shell 巡检、日志分析、Python 报告、容器化任务、固定样本测试、GitHub Actions 自动验证、DeepSeek / OpenAI-compatible Provider 调用、JSON Schema 响应校验、AI Markdown 报告生成、一键 AI 流水线、Webhook 通知、Web Dashboard 和 Linux cron 部署能力。