仪表盘

● 在线
🌐
-
域名数量
👤
-
邮箱账户
📧
-
邮件总数
🔐
-
SSL状态

快速操作

📊 主题统计

请先选择邮箱

域名列表

# 域名 管理邮箱 状态 操作
加载中...

邮箱账户列表

# 邮箱地址 域名 邮件数 状态 操作
加载中...
1 / 1

🔐 SSL 证书管理

未启用
-
-
-
未检测
-

申请免费SSL证书

请确保域名已解析到此服务器IP

申请前请确认:

  • 域名 A 记录已指向此服务器
  • 端口 80 和 443 已开放
  • 已安装 win-acme (路径: C:\win-acme\)

📁 修复IMAP文件夹

重新创建所有邮箱账户的IMAP文件夹结构

🗑️ 清理历史记录

清理邮件数据库中的历史记录

📂 清理Data文件夹

清理CorePost的Data文件夹

🔀 反向代理配置

直接访问
-
-
-

⚠️ 阻止的子域名

以下子域名前缀将被阻止访问(返回503):

mail. imap. smtp. pop. pop3. webmail.

💡 配置说明:

  • 在后台程序中勾选"启用反向代理模式"来切换访问模式
  • 直接访问模式: 使用 域名:端口 访问
  • 反代模式: 通过 Nginx/Caddy 代理到 127.0.0.1:端口

📚 获取邮件 API 文档

接口地址

GET /get_inbox_cached

推荐使用,返回已解析的完整内容,支持分页。

📋 请求参数

参数名 必填 类型 说明 示例值
email 必填 String 邮箱地址 admin@example.com
key 必填 String API 密钥 123456
page_size 可选 Number 返回邮件数量,默认 20 50
page 可选 Number 页码,从 1 开始 1

📤 返回字段

字段名 类型 说明
id Number 邮件 ID
sender String 发件人
to String 收件人
subject String 邮件主题
body String 纯文本正文
html_body String HTML 正文
receive_time String 接收时间(格式:YYYY-MM-DD HH:MM:SS)
size Number 邮件大小(字节)
filename String 邮件文件名

🔗 示例 URL

/get_inbox_cached?email=admin@example.com&page_size=50&key=123456

🐍 Python 示例代码

import requests
import re

# 获取最新 50 封邮件
resp = requests.get("https://example.com/get_inbox_cached", params={
    "email": "admin@example.com",
    "page_size": 50,
    "key": "123456"
})

emails = resp.json()["data"]

# 从邮件中提取验证码
for email in emails:
    subject = email.get("subject", "")
    body = email.get("html_body", "") or email.get("body", "")
    
    # 匹配 4-6 位数字验证码
    code = re.search(r'\b(\d{4,6})\b', body)
    if code:
        print(f"验证码:{code.group(1)}")
        break

⚠️ 注意事项

  • API Key 请妥善保管,不要泄露
  • html_body 包含 HTML 标签,需要自行解析提取文本
  • 邮件内容按接收时间倒序排列(最新的在前)
  • 建议使用 limit 参数限制返回数量以提高速度

2. 获取收件箱 (分页/极速) - 推荐

接口地址

GET /get_inbox_cached

适用于需要导出大量邮件或分页显示的场景。返回已解析的完整内容。

📋 请求参数

参数名 必填 类型 说明
email 必填 String 邮箱地址
key 必填 String API 密钥
page 可选 Number 页码,从 1 开始 (默认 1)
page_size 可选 Number 每页数量 (默认 100)

3. 搜索邮件

接口地址

GET /search_inbox

📋 请求参数

参数名 必填 类型 说明
email 必填 String 邮箱地址
key 必填 String API 密钥
recipient 可选 String 精确匹配收件人 (性能最佳,推荐使用)
keyword 可选 String 模糊搜索关键词 (如果未指定 recipient 则必填)
GET /export_inbox 自动化推荐

极速导出接口。一次性下载所有匹配的邮件 (CSV 格式),适合脚本批量备份。

参数 说明
email 邮箱地址 (必须)
key API Key (必须)
keyword 可选搜索关键词

🐍 Python 自动化脚本示例

复制以下代码,修改配置即可直接运行:


import requests
import time

# 配置信息
API_BASE = "http://localhost:8080"
EMAIL = "admin@example.com"
API_KEY = "123456"

def download_all_csv():
    """全量极速导出 (推荐)"""
    print(f"正在下载 {EMAIL} 的所有邮件...")
    url = f"{API_BASE}/export_inbox"
    params = {"email": EMAIL, "key": API_KEY}
    
    #流式下载防止内存溢出
    with requests.get(url, params=params, stream=True) as r:
        r.raise_for_status()
        filename = f"emails_{int(time.time())}.csv"
        with open(filename, 'wb') as f:
            for chunk in r.iter_content(chunk_size=8192):
                f.write(chunk)
    print(f"下载完成: {filename}")

def search_recipient(recipient):
    """按收件人秒级搜索"""
    print(f"正在搜索收件人: {recipient}...")
    url = f"{API_BASE}/search_inbox"
    params = {
        "email": EMAIL, "key": API_KEY, 
        "recipient": recipient  # 使用 recipient 参数触发极速索引搜索
    }
    resp = requests.get(url, params=params).json()
    print(f"找到 {len(resp.get('data', []))} 封邮件")
    for mail in resp.get('data', []):
        print(f"- [{mail['receive_time']}] {mail['subject']}")

if __name__ == "__main__":
    download_all_csv()
    # search_recipient("bob@example.com")