timdoddcool/mailzort

MailZort

镜像概述

MailZort是一个运行在Docker容器中的.NET 7 Worker项目，作为定时任务自动连接配置的邮件文件夹，根据用户自定义规则对收到的邮件进行分类整理，可集成到Kubernetes等容器化环境中。

核心功能

• 基于灵活的配置规则自动分类邮件（支持包含、不包含、正则匹配等多种规则类型）
• 使用SQLite数据库缓存邮件，存储于执行目录下的data文件夹
• 支持通过配置文件或环境变量设置邮件服务器参数及分类规则
• 可作为定时任务运行（如Kubernetes CronJob），实现自动化邮件管理

使用场景

• 个人用户自动整理收件箱，分类账单、通知、垃圾邮件等
• 企业团队批量处理工作邮件，提高邮件管理效率
• 集成到容器化运维流程中，实现无人值守的邮件分类任务

配置说明

MailZort需要appSettings.json配置文件，示例如下：

json
{
    "EmailSettings": {
        "Server": "邮件服务器地址",
        "Port": 993,
        "UserName": "邮箱账号",
        "Password": "邮箱密码",
        "UseSsl": true,
        "PullMails": true,
        "Trash": "Deleted Messages",
        "TestMode": false,
        "SearchMode": "recent"
    },
    "rules": [
        {
            "Name": "账单分类",
            "Folder": "Inbox",
            "DaysOld": 1,
            "MoveTo": "Bills",
            "LookIn": 3, // 可选值：All, Subject, Body, Sender, Recipient, SenderEmail
            "ExpressionType": 0, // 可选值：Contains, DoesNotContain, Is, IsNot, StartsWith, EndsWith, MatchesRegex, DoesNotMatchRegex
            "Values": ["AT&T", "Amazon", "Steam"]
        }
    ]
}

注意：配置文件会被复制到执行目录下的data文件夹，邮件缓存也存储于此。

Docker部署示例

bash
docker run -d \
  --name mailzort \
  -v ./mailzort-data:/app/data \
  -e EmailSettings__Server="your-mail-server.com" \
  -e EmailSettings__Port="993" \
  -e EmailSettings__UserName="your-email@example.com" \
  -e EmailSettings__Password="your-email-password" \
  -e EmailSettings__UseSsl="true" \
  docker.xuanyuan.run/timdoddcool/mailzort:1.0

Kubernetes配置示例

yaml
apiVersion: batch/v1
kind: CronJob
metadata:
  name: mailzort
spec:
  schedule: "*/5 * * * *" # 每5分钟运行一次
  concurrencyPolicy: Forbid
  failedJobsHistoryLimit: 1
  successfulJobsHistoryLimit: 5
  jobTemplate:
    spec:
      template:
        spec:
          containers:
            - name: mailzort
              image: timdoddcool/mailzort:1.0
              imagePullPolicy: IfNotPresent
              volumeMounts:
                - name: mailzort-volume
                  mountPath: /app/data
              env:
                - name: EmailSettings__Server
                  value: "你的邮件服务器"
                - name: EmailSettings__Port
                  value: "993"
                - name: EmailSettings__UserName
                  value: "你的***账号"
                - name: EmailSettings__Password
                  valueFrom:
                    secretKeyRef:
                      name: 你的密钥名称
                      key: password
                - name: EmailSettings__UseSsl
                  value: "true"
          restartPolicy: Never
          imagePullSecrets:
            - name: mailbrute
          volumes:
            - name: mailzort-volume
              nfs:
                server: 192.168.1.51
                path: /volume1/docker/mailzort
                readOnly: no