MailForwarder

此README由 ChatGPT-4o 生成

这个项目是一个邮件自动转发器,能够从指定的邮箱中读取未读邮件,并将其自动转发到配置文件中指定的收件人邮箱中。该项目支持使用代理服务器进行连接,并且可以处理包含附件的邮件。

功能特性

  • 自动转发未读邮件
  • 支持 HTML 和纯文本格式的邮件内容
  • 支持邮件附件的转发
  • 支持通过 SOCKS5 代理进行连接
  • 支持多账户配置
  • 可配置的检查间隔

安装与配置

环境要求

  • Python 3.6+
  • 需要安装以下 Python 库:
    • json
    • imaplib
    • smtplib
    • email
    • socks
    • logging

安装依赖

pip install pysocks

配置文件

请在项目根目录下创建一个名为 config.json 的配置文件,并根据以下格式进行配置(见config-example.json

{
  "log": "output.log",
  "check_interval": 60,
  "accounts": [
    {
      "email": "your_email@example.com",
      "password": "your_password",
      "enabled": true,
      "imap": {
        "server": "imap.example.com",
        "port": 993,
        "use_ssl": true
      },
      "smtp": {
        "server": "smtp.example.com",
        "port": 587,
        "use_ssl": false,
        "use_starttls": true
      },
      "forward": {
        "to": ["forward_to@example.com"]
      },
      "proxy": {
        "enabled": false,
        "server": "proxy.example.com",
        "port": 1080
      }
    }
  ]
}

配置项说明

  • log: 日志文件路径。
  • check_interval: 检查邮件的时间间隔,单位为秒。
  • accounts: 配置多个邮箱账户。
    • email: 邮箱地址。
    • password: 邮箱密码。
    • enabled: 是否启用该账户。
    • imap: IMAP 服务器配置。
      • server: IMAP 服务器地址。
      • port: IMAP 服务器端口。
      • use_ssl: 是否使用 SSL 连接。
    • smtp: SMTP 服务器配置。
      • server: SMTP 服务器地址。
      • port: SMTP 服务器端口。
      • use_ssl: 是否使用 SSL 连接。
      • use_starttls: 是否使用 STARTTLS 加密。
    • forward: 转发配置。
      • to: 转发邮件的收件人地址列表。
    • proxy: 代理服务器配置。
      • enabled: 是否启用代理。
      • server: 代理服务器地址。
      • port: 代理服务器端口。

使用说明

  1. 确保已经安装了所有依赖项,并正确配置了 config.json 文件。
  2. 运行脚本:
    python main.py
    

日志

该脚本会在控制台输出日志信息,记录程序的运行状态、邮件处理情况以及错误信息。

注意事项

  • 请确保配置文件中的邮箱账号和密码正确无误,并且邮箱服务支持 IMAP 和 SMTP 协议。
  • 转发的邮件会包含一个自定义的头部和尾部,以提示收件人该邮件是自动转发的邮件。

许可证

本项目遵循 MIT 许可证。详细信息请参见 LICENSE 文件。

Description
Forward your emails to other addresses
Readme
Languages
Python 74.3%
HTML 25.7%