mail

mail 维护 IMAP 会话以诊断邮箱，可读取和保存邮件、管理删除标记，并通过主机本地 PHP mail 发送测试邮件。

网络版本 1.1.5稳定
lil-terminal

概览

使用 mail 分开检查收信与发信路径。IMAP 负责连接、邮箱和读取；mail send 则独立测试主机上的 PHP mail 发送能力。

收信与发信是两条独立路径

IMAP 密码通过隐藏输入框输入，连接状态保存在会话中。mail del 只做删除标记，mail expunge 才永久删除。IMAP 可用并不能证明 PHP mail 能发送，反之亦然。

语法

lil-terminal
mail [subcommand] [arguments] [options]

参考

mail

显示 IMAP 连接和邮箱状态

mail connect <host> <user> [box]

通过隐藏密码输入进行连接

mail boxes

列出可用邮箱

mail box <name>

切换邮箱

mail ls [n] [-u]

列出最新邮件；-u 仅显示未读邮件

mail read <id> [-o <file>]

显示邮件或保存其文本正文

mail send <to> <subject> <text>

通过 PHP mail 发送

-p <port>

设置 IMAP 端口

-ssl | -tls | -plain

选择 IMAP 传输方式

-k

仅为诊断允许未验证的 TLS 证书

-f

替换已有的邮件输出文件

-from <addr> | -cc <addr> | -bcc <addr> | -reply <addr>

设置可选的邮件头

mail del <id> | mail undel <id>

将邮件标记为待删除

mail expunge

永久删除已标记的邮件

mail -e

断开连接并清除连接数据

交互式 sandbox 预览

可直接在页面中运行预先准备的示例。结果已预先生成并在浏览器中显示；服务器不会执行任何终端命令。

显示 IMAP 连接和邮箱状态

安装与管理

安装当前兼容版本。完整功能请选择 Base，精简包请选择 Minimum；已安装模块的更新请使用 upgrade。

Base 与 Minimum 是同一当前模块版本的两个包。

Base 包

安装包含本地参考和全部已发布模式的完整包。

install mail
Minimum 包

安装精简包。该包不包含本地参考；help <cmd> -i 会打开当前服务器参考。

install mail -m
精确公开版本

安装这个确切的已发布版本。

install mail -v 1.1.5
检查或升级

让 upgrade 检查兼容性，仅在需要时替换已安装块。

upgrade mail
删除模块

删除扩展块，不影响核心和其他模块。

install mail -u

示例

示例可复制，但网站不会执行。请先检查路径、权限和破坏性选项。

显示 IMAP 连接和邮箱状态
mail
邮件尚未连接
通过隐藏密码输入进行连接
mail connect imap.example.com user@example.com
Status    connected
Host      imap.example.com:993/ssl
User      user@example.com
Box       INBOX
Messages  128
Recent    2
Unread    4
通过隐藏密码输入进行连接
mail connect imap.example.com user@example.com INBOX -tls -p 143
Status    connected
Host      imap.example.com:993/ssl
User      user@example.com
Box       INBOX
Messages  128
Recent    2
Unread    4
列出可用邮箱
mail boxes
INBOX
Archive
Sent
Trash
切换邮箱
mail box Archive
Mailbox  Archive
Messages 128
列出最新邮件；-u 仅显示未读邮件
mail ls 20
42  2026-08-08  noreply@example.com  Deployment report
41  2026-08-07  admin@example.com    Backup complete
40  2026-08-07  alerts@example.com   TLS renewal
列出最新邮件；-u 仅显示未读邮件
mail ls 20 -u
42  2026-08-08  noreply@example.com  Deployment report
显示邮件或保存其文本正文
mail read 42
From     noreply@example.com
To       user@example.com
Subject  Deployment report
Date     2026-08-08 09:15:00 UTC

Deployment completed successfully.
显示邮件或保存其文本正文
mail read 42 -o sandbox/tmp/message-42.txt
sandbox/tmp/
  message-42.txt
通过 PHP mail 发送
mail send admin@example.com "lil diagnostic" "Mail transport test"
本地邮件传输已接受该邮件
设置可选的邮件头
mail send admin@example.com "lil diagnostic" "Mail transport test" -from lil@example.com -reply support@example.com
本地邮件传输已接受该邮件
将邮件标记为待删除
mail del 42
Message  42
Deleted  marked
将邮件标记为待删除
mail undel 42
Message  42
Deleted  cleared
永久删除已标记的邮件
mail expunge
Expunged  1
断开连接并清除连接数据
mail -e
Connection  closed
拒绝无效收件人地址
mail send not-an-email "test" "hello"
收件人地址无效

相关文档

提供哪些网络诊断功能？ →如果 repo.lil.dog 暂时不可用会怎样？ →

当前公开版本

v1.1.52026-08-12

语言同步

完成 mail 的本地帮助与服务器帮助同步，并加强本地化安全性。

# 版本历史