wpywmail/server/README.md

wpyw.mail server

这是独立的邮箱服务端，不包含任何 Webmail 客户端代码。

当前服务端提供：

• SMTP 25：接收发往 @wpyw.site 的邮件
• SMTP Submission 587：登录认证后发信
• REST API：供未来独立客户端使用
• 本地 JSON 邮件存储和附件落盘
• 可选外部 SMTP 中继

启动

在 server/ 目录执行：

npm install
Copy-Item .env.example .env
notepad .env
npm start

必须设置 MAIL_PASSWORD，服务端不会使用默认密码启动。

默认监听：

REST API       8787
SMTP           25
SMTP Submission 587

测试时可以临时改成非特权端口：

$env:WEB_PORT='8787'
$env:SMTP_PORT='2525'
$env:SUBMISSION_PORT='2587'
npm start

API

登录：

POST /api/login
Content-Type: application/json

{"email":"[email protected]","password":"你的密码"}

之后把返回的 token 放入请求头：

Authorization: Bearer <token>

主要接口：

GET  /api/health
GET  /api/config
GET  /api/me
GET  /api/messages?folder=inbox
GET  /api/messages/:id
POST /api/send
POST /api/logout

发信请求示例：

{
  "to": "[email protected]",
  "subject": "测试邮件",
  "text": "邮件正文"
}

Cloudflare 和端口

mail.wpyw.site 应保持 DNS only，MX 指向 mail.wpyw.site。网站或未来的 Webmail 客户端可以继续通过 Cloudflare Tunnel，但 SMTP 25/587 直接连接服务器公网 IP。

当前边界

这是第一版服务端：已经具备收信、发信和客户端 API，但还没有实现 IMAP/POP3、多用户、DKIM 签名、DMARC 报告、反垃圾、配额和管理后台。未来客户端应通过 REST API 或后续增加的 IMAP 服务访问邮箱。

不要把它配置成 Open Relay。正式公网使用前，应配置 mail.wpyw.site 的 TLS 证书、PTR 反向解析、SPF、DKIM、DMARC，并优先考虑 SMTP 中继以提高投递率。

当前没有监听 993/995，因此暂时不要把它当作 Outlook/手机的 IMAP/POP3 服务器使用；第一版客户端应通过 REST API 连接。