EWS Exchange 邮件

通过 EWS（Exchange Web Services）读取、搜索和发送 Microsoft Exchange 本地部署（On-Premise）邮箱中的邮件。

使用 HTTPS（端口 443）+ NTLM 认证 —— 即使 IMAP/SMTP 端口被防火墙拦截，仍可正常工作。

配置

配置文件存储在 ~/.config/ews-exchange/.env。

安装依赖

pip install requests requests_ntlm

配置文件格式

# 必填项
EWS_URL=https://mail.your-company.com/EWS/Exchange.asmx
EWS_DOMAIN=YOUR_AD_DOMAIN
EWS_USER=you@your-company.com
EWS_PASS=your_password
EWS_FROM=you@your-company.com

# 可选项
EWS_VERIFY_SSL=false   # 自签名证书时设为 false（默认值：false）

Exchange 本地部署（On-Premise）注意事项：

• EWS_DOMAIN 是你的 Active Directory 域名（例如 UCH），而非邮箱域名
• 自签名证书较为常见 —— 请设置 EWS_VERIFY_SSL=false
• 可通过 Autodiscover 查找 EWS URL：https://autodiscover.your-company.com/Autodiscover/Autodiscover.xml

多账户支持

为额外账户添加带前缀的环境变量：

# 工作账户（使用 WORK_ 前缀）
WORK_EWS_URL=https://mail.company.com/EWS/Exchange.asmx
WORK_EWS_DOMAIN=COMPANY
WORK_EWS_USER=me@company.com
WORK_EWS_PASS=password
WORK_EWS_FROM=me@company.com

在任意命令前使用 --account 指定账户：

python scripts/ews.py --account work check

命令

test

测试 EWS 连接与认证是否成功。

python scripts/ews.py [--account ] test

check

检查最新收到的邮件。

python scripts/ews.py [--account ] check [--limit 10] [--folder inbox] [--recent 2h] [--unread]

选项说明：

• --limit ：最多返回结果数（默认：10）
• --folder ：邮箱文件夹名称（默认：inbox）
• --recent ：仅显示最近 X 时间内的邮件（例如：30m、2h、7d）
• --unread：仅显示未读邮件

fetch

根据索引号（来自 check 输出）或 UID 获取完整邮件内容。

python scripts/ews.py [--account ] fetch  [--folder inbox]

选项说明：

• --folder ：邮箱文件夹（默认：inbox）

send

通过 EWS 发送邮件。

python scripts/ews.py [--account ] send --to  --subject  [options]

必填参数：

• --to ：收件人地址（多个地址可用英文逗号分隔）
• --subject ：邮件主题

可选参数：

• --body ：纯文本正文内容
• --html：将正文作为 HTML 发送
• --body-file ：从指定文件读取正文内容
• --cc ：抄送收件人
• --bcc ：密送收件人
• --attach ：附件路径（多个附件可用英文逗号分隔）
• --from ：覆盖默认发件人地址

使用示例：

# 简单纯文本邮件
python scripts/ews.py send --to recipient@example.com --subject "Hello" --body "World"

# HTML 邮件
python scripts/ews.py send --to recipient@example.com --subject "Newsletter" --html --body "
Welcome
"

# 带附件的邮件
python scripts/ews.py send --to recipient@example.com --subject "Report" --body "Please find attached" --attach report.pdf

search

按条件搜索邮件。

python scripts/ews.py [--account ] search [options]

选项说明：

• --unseen：仅匹配未读邮件
• --from ：发件人地址包含指定字符串
• --subject ：主题包含指定字符串
• --recent ：仅搜索最近 X 时间内的邮件（例如：30m、2h、7d）
• --limit ：最多返回结果数（默认：20）
• --folder ：搜索的目标邮箱文件夹（默认：inbox）

folders

列出所有邮箱文件夹。

python scripts/ews.py [--account ] folders

list-accounts

列出所有已配置的邮箱账户。

python scripts/ews.py list-accounts

常用 Exchange 文件夹 ID

故障排查

认证失败（HTTP 401）：

• 确认 EWS_DOMAIN 是你的 AD 域名（如 UCH），而非邮箱域名
• 若不确定 AD 域名，可尝试不同名称
• 检查用户名格式：通常为 user@domain.com 或仅 username

HTTP 500 / 请求无效：

• EWS 接口地址可能有误 —— 请通过 Autodiscover 校验
• 部分 Exchange 版本需指定 RequestServerVersion

SSL/TLS 错误：

• 本地部署环境中常使用自签名证书，请设置 EWS_VERIFY_SSL=false

连接超时：

• 确认端口 443 是否开放：telnet mail.company.com 443
• 检查是否处于正确的网络或已接入所需 VPN