wpywmail/README.md

wpyw.mail

服务端和客户端分离。当前优先维护独立服务端，服务端代码和启动说明位于 server/。

服务端提供 SMTP 收信、SMTP Submission 发信、本地邮件存储和 REST API；客户端后续单独开发，不参与服务端启动。

启动

npm install
Copy-Item .env.example .env
notepad .env
npm run dev

开发时访问 http://localhost:5173，生产构建后运行：

npm run build
npm start

默认 Web API 监听 8787，SMTP 监听 25，Submission 监听 587。

重要配置

至少修改 .env 中的：

[email protected]
MAIL_PASSWORD=一个足够长的密码
MAIL_DATA_DIR=H:\\MailData

如果服务器不能直接连接外部 MX 的 25 端口，可以配置 SMTP 中继：

SMTP_RELAY_HOST=smtp.example.com
SMTP_RELAY_PORT=587
SMTP_RELAY_USER=your-user
SMTP_RELAY_PASSWORD=your-password
SMTP_RELAY_SECURE=false

Cloudflare Tunnel

不要把 SMTP 或 IMAP 通过现有 Web Tunnel 暴露给普通客户端。建议增加单独的 Webmail hostname：

ingress:
  - hostname: webmail.wpyw.site
    service: http://127.0.0.1:5173
  - service: http_status:404

mail.wpyw.site 保持 DNS only，继续直接指向邮件服务器公网 IP。MX 记录继续指向 mail.wpyw.site。

当前版本边界

这是一个可运行的单账户基础服务，不等同于成熟商业邮件系统。正式长期运行前，还应增加 DKIM 签名、DMARC 报告、反垃圾策略、速率限制、持久化会话、多账户管理、附件下载鉴权、备份和监控。不要把它配置成 Open Relay。