disposable-email-domains的扩展插件开发：入门指南与API参考

【免费下载链接】disposable-email-domains a list of disposable and temporary email address domains 项目地址: https://gitcode.com/GitHub_Trending/di/disposable-email-domains

disposable-email-domains是一个维护一次性和临时电子邮件域名列表的开源项目，它为开发者提供了可靠的垃圾邮件防护基础。本指南将帮助你快速上手扩展插件开发，轻松定制符合自身需求的域名过滤解决方案。

为什么开发扩展插件？

一次性邮箱（Disposable Email）已成为垃圾注册、恶意注册的主要工具。据统计，超过30%的网站注册使用临时邮箱，导致用户质量下降、营销资源浪费。通过开发扩展插件，你可以：

• 接入专属域名数据源（如企业内部黑名单）
• 实现自定义域名验证规则
• 集成到现有身份验证系统
• 提升反垃圾邮件效率

核心文件解析

项目核心由以下关键文件构成，理解这些文件是扩展开发的基础：

1. 域名列表文件

• disposable_email_blocklist.conf
  主黑名单文件，包含5000+条一次性邮箱域名记录，采用纯文本格式，每行一个域名：

  0-mail.com
  01022.hk
  01130.hk
  ...
  

• allowlist.conf
  白名单配置，用于排除误判的合法域名

2. 核心功能脚本

• fetch_domains.py
  域名抓取工具，从多个来源自动获取最新一次性邮箱域名。它实现了模块化的抓取器架构：

  class DomainFetcher:
      """Base class for domain fetchers"""
      def fetch(self) -> Set[str]:
          raise NotImplementedError("Subclasses must implement fetch()")
  

• verify.py
  域名验证工具，确保列表格式正确、无重复项、无公共后缀：

  def check_for_duplicates(filename):
      lines = files[filename]
      count = Counter(lines) - Counter(set(lines))
      if count:
          print("Duplicate domains found...")
  

扩展开发入门

开发环境准备

1. 克隆项目仓库：

   git clone https://gitcode.com/GitHub_Trending/di/disposable-email-domains
   

2. 安装依赖：

   pip install -r requirements.txt
   

开发自定义域名抓取器

扩展fetch_domains.py添加新的域名数据源，只需三步：

1. 创建新的Fetcher类，继承DomainFetcher基类：

   class MyCustomFetcher(DomainFetcher):
       def __init__(self):
           super().__init__("MyCustomSource")
           self.url = "https://api.example.com/disposable-domains"
   

2. 实现fetch()方法：

   def fetch(self) -> Set[str]:
       try:
           response = get(self.url, timeout=30)
           domains = response.json()  # 假设API返回JSON数组
           return set(domain.lower() for domain in domains)
       except Exception as e:
           print(f"Fetch error: {e}", file=sys.stderr)
           return set()
   

3. 在FETCHERS列表注册：

   FETCHERS = [
       YopmailFetcher(),
       TmailFetcher(),
       MyCustomFetcher(),  # 添加你的抓取器
   ]
   

实现自定义验证规则

修改verify.py添加自定义验证逻辑：

def check_for_custom_rules(filename):
    """检查域名是否符合自定义业务规则"""
    invalid = set()
    for line in files[filename]:
        if line.endswith(".yourcompany.com"):
            invalid.add(line)
    
    if invalid:
        print("自定义规则违规域名:")
        for line in sorted(invalid):
            print(f"* {line}")
        sys.exit(1)

然后在主函数中调用：

if __name__ == "__main__":
    # ... 现有代码 ...
    check_for_custom_rules(blocklist)

API参考与最佳实践

公共方法

方法	功能	参数	返回值
load_existing_domains()	加载现有域名列表	文件名	域名集合(Set)
add_domains_to_blocklist()	添加新域名到列表	新域名集合、文件名	添加数量(int)
is_valid_level_domain()	验证域名层级	域名、PSL对象	布尔值

扩展开发建议

1. 模块化设计：保持每个抓取器独立，便于维护
2. 错误处理：实现完善的异常处理，确保单个数据源故障不影响整体
3. 测试覆盖：为新功能编写单元测试，确保兼容性
4. 性能优化：对于大量域名处理，考虑分批操作

部署与集成

本地测试

# 运行域名抓取
python fetch_domains.py

# 验证列表完整性
python verify.py

集成到应用

在你的Python项目中使用该列表：

def is_disposable_email(email):
    domain = email.split('@')[-1].lower()
    with open('disposable_email_blocklist.conf') as f:
        blocklist = set(line.strip() for line in f)
    return domain in blocklist

常见问题解决

Q: 如何处理抓取器API变更？
A: 实现版本检查和回退机制，例如：

def fetch(self):
    try:
        # 尝试新版本API
        response = get(f"{self.url}/v2/domains")
        response.raise_for_status()
        return response.json()
    except:
        # 回退到旧版本
        response = get(f"{self.url}/v1/domains")
        return response.json()

Q: 如何处理大型域名列表？
A: 使用生成器模式逐行处理，避免内存占用过高：

def load_large_list(filename):
    with open(filename) as f:
        for line in f:
            yield line.strip().lower()

结语

通过扩展disposable-email-domains项目，你可以构建更强大、更个性化的垃圾邮件防护系统。无论是添加新的数据源，还是实现自定义验证规则，该项目的模块化架构都能让扩展开发变得简单高效。开始你的扩展开发之旅，为网络环境净化贡献一份力量！

【免费下载链接】disposable-email-domains a list of disposable and temporary email address domains 项目地址: https://gitcode.com/GitHub_Trending/di/disposable-email-domains