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
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Status    connected
Host      imap.example.test:993/ssl
User      user@example.test
Box       INBOX
Messages  12
Recent    1
Unread    3
通过隐藏密码输入进行连接
mail connect imap.example.test user@example.test
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Hidden password prompt opened
通过隐藏密码输入进行连接
mail connect imap.example.test user@example.test INBOX -ssl -p 993
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Hidden password prompt opened
通过隐藏密码输入进行连接
mail connect imap.example.test user@example.test INBOX -tls -p 143
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Hidden password prompt opened
通过隐藏密码输入进行连接
mail connect imap.example.test user@example.test INBOX -plain -p 143
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Hidden password prompt opened
通过隐藏密码输入进行连接
mail connect imap.example.test user@example.test INBOX -k
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Hidden password prompt opened
列出可用邮箱
mail boxes
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
INBOX
Archive
Sent
切换邮箱
mail box Archive
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Status    connected
Host      imap.example.test:993/ssl
User      user@example.test
Box       Archive
Messages  7
Recent    0
Unread    1
列出最新邮件；-u 仅显示未读邮件
mail ls
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
*3    2026-10-31 10:05    contact@example.test    Project update
 2    2026-10-30 09:20    alerts@example.test     Backup complete
列出最新邮件；-u 仅显示未读邮件
mail ls 10
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
*3    2026-10-31 10:05    contact@example.test    Project update
 2    2026-10-30 09:20    alerts@example.test     Backup complete
列出最新邮件；-u 仅显示未读邮件
mail ls 10 -u
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
*3    2026-10-31 10:05    contact@example.test    Project update
显示邮件或保存其文本正文
mail read 3
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
ID:      3
Date:    Sat, 31 Oct 2026 10:05:00 +0000
From:    contact@example.test
To:      user@example.test
Subject: Project update

The files are ready for review.
显示邮件或保存其文本正文
mail read 3 -o tmp/message.txt
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Saved  sandbox/tmp/message.txt

README.txt
message.txt
显示邮件或保存其文本正文
mail read 3 -o tmp/message.txt -f
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Saved  sandbox/tmp/message.txt

README.txt
message.txt
将邮件标记为待删除
mail del 3
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
+
拒绝无效收件人地址
mail undel 3
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
+
永久删除已标记的邮件
mail expunge
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
+
断开连接并清除连接数据
mail -e
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
+
通过 PHP mail 发送
mail send someone@example.test "Test" "Hello from lil"
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Mail accepted by local transport
(Note: this does not confirm delivery)
通过 PHP mail 发送
mail send someone@example.test "Test" "Hello" -from admin@example.test
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Mail accepted by local transport
(Note: this does not confirm delivery)
通过 PHP mail 发送
mail send someone@example.test "Test" "Hello" -cc team@example.test -bcc archive@example.test -reply admin@example.test
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Mail accepted by local transport
(Note: this does not confirm delivery)
通过 PHP mail 发送
mail send not-an-email "Test" "Hello"
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Invalid recipient address
通过 PHP mail 发送
mail send someone@example.test "A B" "Hello"
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Mail accepted by local transport
(Note: this does not confirm delivery)
显示邮件或保存其文本正文
mail read bad-id
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Valid message ID required
通过隐藏密码输入进行连接
mail connect imap.example.test user@example.test INBOX -p 70000
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Invalid IMAP port
通过隐藏密码输入进行连接
mail connect imap.example.test user@example.test INBOX -unknown
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Unknown option: -unknown
通过 PHP mail 发送
mail send someone@example.test
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
To, subject and text are required
Mail · box
mail box
离线教学示例 — 不执行真实的 HTTP、邮件或 TLS 请求
Mailbox name required

相关文档

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

当前公开版本

v1.1.52026-08-12

语言同步

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

# 版本历史