mailuminati/guardian

Mailuminati Guardian

Guardian是一款高性能、可扩展的垃圾邮件与钓鱼检测及执行服务，旨在与邮件传输代理（MTA）和过滤引擎配合运行。

它能超快速分析 incoming 邮件（结构指纹识别 + 邻近检测），从操作员/用户报告中应用即时本地学习，仅在需要共享协作智能时才连接Mailuminati Oracle。

Guardian适用于任何运营邮件基础设施的用户，从大型提供商到小型社区服务器，帮助他们以最小开销做出快速决策。

→ https://github.com/Mailuminati/Guardian

---

核心功能

• 对 incoming 邮件进行本地垃圾邮件/钓鱼分析
• 使用TLSH进行结构指纹识别
• 通过局部敏感哈希（LSH）实现快速邻近检测
• 即时应用本地学习
• 通过Mailuminati Oracle进行远程确认
• 执行最终决策（允许、标记垃圾邮件、邻近匹配）

---

使用场景

适用于所有运营邮件基础设施的场景，包括：

• 大型邮件服务提供商
• 小型企业邮件服务器
• 社区运营的邮件服务器
• 需要增强邮件安全防护的组织

---

配置说明

Docker安装的配置主要通过docker-compose.yaml中的环境变量管理。可用变量如下：

最后几个变量允许操作员微调垃圾邮件和正常邮件报告对本地学习数据库的影响，可根据具体需求调整。

---

Docker部署示例

Docker Run命令

bash
docker run -d \
  --name guardian \
  -e REDIS_HOST=redis \
  -e REDIS_PORT=6379 \
  -e GUARDIAN_BIND_ADDR=0.0.0.0 \
  mailuminati/guardian

Docker Compose示例

yaml
version: '3'
services:
  guardian:
    image: mailuminati/guardian
    environment:
      - REDIS_HOST=redis
      - REDIS_PORT=6379
      - GUARDIAN_***D_ADDR=0.0.0.0
      - MI_ENABLE_IMAGE_ANALYSIS=1
    depends_on:
      - redis
  redis:
    image: redis:alpine