邮箱别名插件 (Email Alias)让用户在 Roundcube 网页端自助添加邮箱别名，实现一个账户接收多个邮箱地址的邮件。什么是邮箱别名？邮箱别名是指向你主邮箱的"快捷方式"。例如：你的主邮箱是 lele@leleweb.cn你添加了别名 test@leleweb.cn当有人发邮件到 test@leleweb.cn 时，邮件会自动出现在 lele@leleweb.cn 的收件箱中注意：别名只能接收邮件，不能用于登录或发送邮件。功能特点✅ 用户可自助添加/删除邮箱别名✅ 发送到别名的邮件自动转发到主邮箱✅ 每个用户最多添加 5 个别名✅ 简洁弹窗界面，操作方便✅ 支持宝塔全域邮局使用方法1. 添加邮箱别名登录你的邮箱（如 lele@leleweb.cn）在左侧邮箱列表上方，点击蓝色的 "+ 添加邮箱" 按钮在弹出的对话框中：输入你想要的别名（如 test）系统会自动添加 @leleweb.cn 后缀点击 添加 按钮提示"邮箱添加成功"即完成2. 查看已添加的别名点击 "+ 添加邮箱" 按钮弹窗下方会显示你已添加的所有别名显示格式：已添加 2/5 个邮箱，还可添加 3 个3. 删除邮箱别名点击 "+ 添加邮箱" 按钮在别名列表中找到要删除的别名点击右侧红色的 删除 按钮确认删除即可使用示例假设你的主邮箱是 lele@leleweb.cn：添加的别名完整地址邮件去向testtest@leleweb.cn→ lele@leleweb.cnworkwork@leleweb.cn→ lele@leleweb.cnshopshop@leleweb.cn→ lele@leleweb.cn所有发送到这些别名的邮件，都会出现在 lele@leleweb.cn 的收件箱中。别名命名规则✅ 可以使用：字母(a-z)、数字(0-9)、点(.)、下划线(_)、横线(-)❌ 不能使用：中文、空格、特殊符号❌ 不能与已有邮箱地址重复有效示例：test、test123、test.work、test_2026无效示例：测试、test@、test work重要说明别名是绑定到登录账户的你用 lele@leleweb.cn 登录时添加的别名，只会转发到 lele@leleweb.cn如果你用 lele001@leleweb.cn 登录，看到的是 lele001@leleweb.cn 的别名列表每个账户的别名是独立的，互不影响别名只能接收，不能发送别名地址只能用于接收邮件你不能用别名地址登录邮箱你不能用别名地址发送邮件数量限制每个账户最多添加 5 个别名达到上限后需要删除旧的才能添加新的常见问题Q: 添加别名后为什么收不到邮件？A: 请等待 1-2 分钟让邮件服务器刷新配置。如果仍然收不到，可以让管理员重启 Postfix 服务：systemctl restart postfixQ: 为什么提示"该别名已存在"？A: 这个邮箱地址已经被使用了（可能是其他用户的别名或已有邮箱），请换一个名称。Q: 为什么提示"该地址已被使用"？A: 这个地址已经是一个真实的邮箱账户，不能作为别名使用。Q: 删除别名后会怎样？A: 删除后，发送到该别名的邮件将无法接收，会被退回给发件人。Q: 我能看到别人添加了哪些别名吗？A: 不能。每个用户只能看到和管理自己的别名。Q: 数据库被锁怎么办？A: 如果遇到操作失败，管理员可以执行：rm -f /www/vmail/postfixadmin.db-wal /www/vmail/postfixadmin.db-shm chmod 666 /www/vmail/postfixadmin.db systemctl restart dovecot管理员配置安装方法将 email_alias 文件夹复制到 Roundcube 的 plugins/ 目录编辑 config/config.inc.php，在 plugins 数组中添加：$config['plugins'] = [ // ... 其他插件 'email_alias', ];确保宝塔邮局数据库权限正确：chmod 666 /www/vmail/postfixadmin.db配置参数编辑 plugins/email_alias/email_alias.php：private $db_path = '/www/vmail/postfixadmin.db'; // 数据库路径 private $max_aliases = 5; // 每个用户最多别名数量防止数据库锁定建议添加定时任务，每 3 分钟清理锁文件：# 编辑 crontab crontab -e # 添加以下行 */3 * * * * rm -f /www/vmail/postfixadmin.db-wal /www/vmail/postfixadmin.db-shm 2>/dev/null技术说明插件直接操作宝塔邮局的 SQLite 数据库 alias 表：字段说明address别名地址（如 test@leleweb.cn）goto转发目标（主邮箱地址）domain域名created创建时间active是否启用（1=启用）文件结构plugins/email_alias/ ├── email_alias.php # 主插件文件 ├── email_alias.js # 前端交互脚本 ├── README.md # 本说明文档 └── skins/elastic/ # 皮肤文件 └── style.css版本历史v1.0 (2026-01-02) - 初始版本支持添加/删除邮箱别名弹窗式操作界面每用户最多 5 个别名