eilandert/rspamd-dcc-razor-pyzor

rspamd-dcc-razor-pyzor镜像说明

镜像概述

本镜像提供轻量级独立Docker后端，为rspamd邮件过滤系统集成DCC、Razor、Pyzor三个经典协作过滤网络。镜像不运行自身的rspamd服务，需配合用户已有的rspamd容器或主机实例使用。后端基于静态Go二进制构建，采用distroless基础镜像，无多余依赖，运行高效且安全。

核心功能

1. 多网络集成：通过单一HTTP端点同时支持DCC、Razor、Pyzor三个协作过滤网络的并发查询。
2. 异步高效：采用Go编写的in-process客户端（gazor、gyzor、gdcc），避免进程fork，不阻塞rspamd事件循环。
3. 安全加固：支持token认证、非root用户运行、只读文件系统、capabilities剥离等安全措施。
4. 隐私保护：消息全程内存处理，仅发送内容指纹（而非原始消息）到协作网络，缓存仅存储哈希值。
5. 灵活配置：支持内存/Redis缓存、服务器地址覆盖、身份认证配置等。
6. 用户反馈：提供报告垃圾邮件（/report）和误判恢复（/revoke）API，可集成Dovecot sieve实现用户操作触发反馈。

使用场景

1. rspamd用户需要增强反垃圾邮件能力，利用协作过滤网络识别垃圾邮件。
2. 邮件系统需要低资源消耗、高效的反垃圾邮件后端服务。
3. 需要实现用户反馈机制（如邮件移入/移出垃圾文件夹时自动报告）的邮件环境。

配置说明

1. 部署后端

Docker Compose示例

bash
# 创建secrets目录并生成token
mkdir -p secrets && openssl rand -hex 32 > secrets/drp_token.txt

# docker-compose.yml内容
version: '3.8'
services:
  rspamd-drp:
    image: eilandert/rspamd-dcc-razor-pyzor:latest
    environment:
      GOZER_TOKEN_FILE: /run/secrets/drp_token
    secrets:
      - drp_token
    networks:
      - rspamd-net
    read_only: true
    cap_drop: [ALL]
    no_new_privileges: true
    healthcheck:
      test: ["CMD", "gozer", "health"]
      interval: 30s
      timeout: 5s
      retries: 3

secrets:
  drp_token:
    file: ./secrets/drp_token.txt

networks:
  rspamd-net:
    external: true # 需与rspamd所在网络一致

运行命令：docker compose up -d

2. 安装rspamd插件

复制插件文件到rspamd配置目录：

bash
# 从镜像或GitHub仓库获取插件文件
cp rspamd/plugins/dcc_razor_pyzor.lua /etc/rspamd/plugins/
cp rspamd/local.d/dcc_razor_pyzor.conf /etc/rspamd/local.d/
cp rspamd/local.d/groups.conf /etc/rspamd/local.d/
echo 'dofile("/etc/rspamd/plugins/dcc_razor_pyzor.lua")' >> /etc/rspamd/rspamd.local.lua

修改local.d/dcc_razor_pyzor.conf：

url = "http://rspamd-drp:8077/check"; # 后端服务地址
token = "your-shared-secret"; # 与GOZER_TOKEN一致

重启rspamd：systemctl restart rspamd

3. 关键环境变量

4. HTTP API示例

查询垃圾邮件

bash
TOKEN=$(cat secrets/drp_token.txt)
curl -s --data-binary @message.eml -H "Authorization: Bearer $TOKEN" http://rspamd-drp:8077/check

报告垃圾邮件

bash
curl -s --data-binary @spam.eml -H "X-DRP-Token: $TOKEN" http://rspamd-drp:8077/report

健康检查

bash
curl -s http://rspamd-drp:8077/health

注意事项

• 确保rspamd与后端服务在同一Docker网络，或配置正确IP地址。
• 若rspamd无法解析Docker服务名，使用后端容器IP替代。
• 用户反馈集成可参考镜像提供的Dovecot sieve配置脚本。