邮箱别名插件 (Email Alias)

让用户在 Roundcube 网页端自助添加邮箱别名，实现一个账户接收多个邮箱地址的邮件。

什么是邮箱别名？

邮箱别名是指向你主邮箱的"快捷方式"。例如：

• 你的主邮箱是 lele@leleweb.cn
• 你添加了别名 test@leleweb.cn
• 当有人发邮件到 test@leleweb.cn 时，邮件会自动出现在 lele@leleweb.cn 的收件箱中

注意：别名只能接收邮件，不能用于登录或发送邮件。

功能特点

• ✅ 用户可自助添加/删除邮箱别名
• ✅ 发送到别名的邮件自动转发到主邮箱
• ✅ 每个用户最多添加 5 个别名
• ✅ 简洁弹窗界面，操作方便
• ✅ 支持宝塔全域邮局

使用方法

1. 添加邮箱别名

1. 登录你的邮箱（如 lele@leleweb.cn）
2. 在左侧邮箱列表上方，点击蓝色的 "+ 添加邮箱" 按钮

3. 在弹出的对话框中：

   • 输入你想要的别名（如 test）
   • 系统会自动添加 @leleweb.cn 后缀
4. 点击 添加 按钮
5. 提示"邮箱添加成功"即完成

2. 查看已添加的别名

1. 点击 "+ 添加邮箱" 按钮
2. 弹窗下方会显示你已添加的所有别名
3. 显示格式：已添加 2/5 个邮箱，还可添加 3 个

3. 删除邮箱别名

1. 点击 "+ 添加邮箱" 按钮
2. 在别名列表中找到要删除的别名
3. 点击右侧红色的 删除 按钮
4. 确认删除即可

使用示例

假设你的主邮箱是 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 postfix

Q: 为什么提示"该别名已存在"？

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

管理员配置

安装方法

1. 将 email_alias 文件夹复制到 Roundcube 的 plugins/ 目录

2. 编辑 config/config.inc.php，在 plugins 数组中添加：

   $config['plugins'] = [
    // ... 其他插件
    'email_alias',
   ];

3. 确保宝塔邮局数据库权限正确：

   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 表：

文件结构

plugins/email_alias/
├── email_alias.php          # 主插件文件
├── email_alias.js           # 前端交互脚本
├── README.md                # 本说明文档
└── skins/elastic/           # 皮肤文件
    └── style.css

版本历史

• v1.0 (2026-01-02) - 初始版本

  • 支持添加/删除邮箱别名
  • 弹窗式操作界面
  • 每用户最多 5 个别名