第04章 核心功能与配置管理

第04章 核心功能与配置管理

4.1 Web 管理界面概览

BillionMail 提供了一个现代化的 Web 管理界面，采用 Vue.js 构建，界面直观、响应迅速。本章将详细介绍管理界面的各个功能模块以及如何进行系统配置。

4.1.1 登录与仪表板

登录界面

首次访问 BillionMail 时，会看到登录界面。登录界面简洁明了，包含以下元素：

  • 用户名/邮箱输入框
  • 密码输入框
  • "记住我"选项（保持登录状态）
  • 登录按钮
  • 忘记密码链接

输入管理员凭据后，系统会验证身份并跳转到仪表板。

仪表板布局

登录后进入仪表板，这是系统的主界面。仪表板采用响应式设计，适配各种屏幕尺寸。主要区域包括：

顶部导航栏：

  • Logo 和站点名称
  • 快速操作按钮（发送邮件、创建活动等）
  • 通知中心（显示系统通知和警告）
  • 用户菜单（个人设置、退出登录等）

左侧菜单：

  • 仪表板（概览）
  • 邮件活动（创建和管理邮件活动）
  • 联系人管理（管理邮件列表和订阅者）
  • 邮件模板（创建和编辑邮件模板）
  • 统计报告（查看详细的分析数据）
  • 域名管理（管理邮件域名）
  • 用户管理（管理系统用户和权限）
  • 系统设置（配置系统参数）
  • API 管理（生成和管理 API 密钥）

主内容区域：
显示当前选中模块的内容。仪表板主内容区域包含：

关键指标卡片：

  • 今日发送邮件数
  • 本周发送邮件数
  • 打开率（百分比）
  • 点击率（百分比）
  • 退订率
  • 退信率

每个指标卡片还显示与上一时期相比的变化趋势（增加/减少的百分比）。

最近活动：
显示最近 5-10 个邮件活动的状态，包括：

  • 活动名称
  • 创建时间
  • 发送状态（草稿、计划中、发送中、已完成）
  • 已发送数量
  • 打开率
  • 快速操作按钮（查看详情、编辑、删除）

发送趋势图表：
折线图或柱状图显示过去 7 天或 30 天的邮件发送量趋势。可以切换时间范围和图表类型。

系统状态：
显示系统健康状况，包括：

  • 邮件队列状态（待发送、正在发送、已发送）
  • 服务器资源使用情况（CPU、内存、磁盘）
  • 数据库连接状态
  • Redis 状态
  • Postfix 状态
  • Dovecot 状态

4.1.2 导航和界面操作

响应式菜单

在移动设备或小屏幕上，左侧菜单会自动折叠为汉堡菜单图标，点击后展开。这确保了在各种设备上的良好用户体验。

面包屑导航

页面顶部显示面包屑导航，显示当前位置：

仪表板 > 邮件活动 > 创建新活动

点击面包屑中的任何一级可以快速返回。

快速搜索

顶部搜索框支持全局搜索，可以快速查找：

  • 邮件活动
  • 联系人
  • 邮件模板
  • 系统设置

输入关键词后，会实时显示匹配结果，点击即可跳转。

主题切换

支持浅色和深色主题，可以在用户菜单中切换。系统会记住用户的主题偏好。

语言切换

支持多语言界面，包括中文、英文等。可以在用户菜单中切换语言。

4.1.3 通知系统

通知类型

系统会显示各种类型的通知：

  • 成功通知（绿色）：操作成功完成
  • 警告通知（黄色）：需要注意的事项
  • 错误通知（红色）：操作失败或系统错误
  • 信息通知（蓝色）：一般信息

通知显示方式

  • 浮动通知：操作后在屏幕右上角显示 3-5 秒
  • 通知中心：点击顶部通知图标查看所有通知历史
  • 邮件通知：重要事件可以通过邮件通知管理员

通知配置

可以在个人设置中配置通知偏好：

  • 启用/禁用浮动通知
  • 选择接收邮件通知的事件类型
  • 设置通知声音

4.2 用户管理

4.2.1 用户角色和权限

BillionMail 实现了基于角色的访问控制（RBAC），支持多种用户角色：

超级管理员（Super Admin）

拥有所有权限，包括：

  • 系统配置管理
  • 用户和角色管理
  • 域名管理
  • 邮件活动管理
  • 联系人管理
  • 查看所有统计数据
  • API 管理
  • 数据库管理

管理员（Admin）

拥有大部分管理权限，除了：

  • 无法修改系统核心配置
  • 无法删除超级管理员
  • 无法访问某些敏感设置

营销人员（Marketer）

专注于邮件营销功能：

  • 创建和管理邮件活动
  • 管理联系人和列表
  • 创建邮件模板
  • 查看活动统计数据
  • 无法修改系统设置
  • 无法管理用户

只读用户（Viewer）

只能查看数据，不能修改：

  • 查看邮件活动
  • 查看统计报告
  • 无法创建或修改任何内容

自定义角色

可以创建自定义角色，精细控制权限。权限包括：

  • 邮件活动：创建、编辑、删除、发送
  • 联系人：添加、编辑、删除、导入、导出
  • 模板：创建、编辑、删除
  • 统计：查看自己的、查看所有
  • 域名：添加、编辑、删除
  • 用户：添加、编辑、删除
  • 系统设置：查看、修改
  • API：生成、查看、删除

4.2.2 添加和管理用户

添加新用户

  1. 导航到"用户管理"
  2. 点击"添加用户"按钮
  3. 填写用户信息：
    • 用户名（用于登录）
    • 邮箱地址
    • 显示名称
    • 密码（至少 8 位，包含字母和数字）
    • 确认密码
    • 选择角色
    • 状态（启用/禁用）
  4. 点击"保存"

系统会向用户邮箱发送欢迎邮件，包含登录信息。

编辑用户

  1. 在用户列表中找到要编辑的用户
  2. 点击"编辑"按钮
  3. 修改用户信息
  4. 点击"保存"

可以修改的信息包括：

  • 显示名称
  • 邮箱地址
  • 角色
  • 状态
  • 重置密码（管理员可以为用户重置密码）

禁用和删除用户

禁用用户：

  • 禁用后用户无法登录，但数据保留
  • 适合暂时停用账户的情况
  • 可以随时重新启用

删除用户：

  • 永久删除用户账户
  • 用户创建的内容（邮件活动、模板等）可以选择：
    • 保留并转移给其他用户
    • 一起删除
  • 操作不可逆，需要确认

批量管理

支持批量操作：

  • 选择多个用户
  • 批量禁用/启用
  • 批量修改角色
  • 批量删除

4.2.3 密码策略和安全

密码要求

系统强制执行密码策略：

  • 最小长度：8 位
  • 必须包含：大写字母、小写字母、数字
  • 可选：特殊字符
  • 不能是常见密码（如 "password", "12345678"）
  • 不能与用户名相同

密码有效期

可以配置密码有效期：

  • 密码过期后强制用户更改
  • 默认：不过期
  • 可设置：30、60、90、180 天

登录安全

多次失败锁定：

  • 连续 5 次登录失败后锁定账户 15 分钟
  • 防止暴力破解攻击

双因素认证（2FA）：

  • 支持 TOTP（Google Authenticator、Authy 等）
  • 用户可以在个人设置中启用
  • 增强账户安全性

会话管理：

  • 会话超时：30 分钟无操作自动退出
  • 可以在多个设备登录
  • 可以查看和终止其他会话

4.2.4 用户活动日志

系统记录所有用户的重要操作：

  • 登录/退出
  • 创建/编辑/删除邮件活动
  • 修改系统设置
  • 用户管理操作
  • API 调用

日志包含以下信息：

  • 操作时间
  • 用户名
  • 操作类型
  • 操作详情
  • IP 地址
  • 浏览器/设备信息

可以按时间范围、用户、操作类型筛选日志。

4.3 域名管理

4.3.1 添加域名

BillionMail 支持管理多个域名，每个域名可以有独立的配置。

添加新域名

  1. 导航到"域名管理"
  2. 点击"添加域名"
  3. 输入域名（例如：example.com）
  4. 选择域名类型：
    • 发送和接收：完整的邮件服务器功能
    • 仅发送：只用于发送邮件，不接收
  5. 系统自动生成 DKIM 密钥对
  6. 点击"保存"

域名配置向导

添加域名后，系统会显示配置向导，指导完成 DNS 配置：

步骤 1：MX 记录

记录类型：MX
主机记录：@
记录值：mail.yourdomain.com
优先级：10

步骤 2：SPF 记录

记录类型：TXT
主机记录：@
记录值：v=spf1 mx ip4:YOUR_SERVER_IP ~all

步骤 3：DKIM 记录

记录类型：TXT
主机记录：default._domainkey
记录值：v=DKIM1; k=rsa; p=（系统生成的公钥）

步骤 4：DMARC 记录

记录类型：TXT
主机记录：_dmarc
记录值：v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com

向导会实时检测 DNS 记录是否正确配置，并显示状态（等待中、已配置、配置错误）。

4.3.2 DKIM 配置

DKIM 密钥管理

每个域名都有独立的 DKIM 密钥对：

  • 私钥：保存在服务器上，用于签名邮件
  • 公钥：发布到 DNS，供接收方验证

查看 DKIM 公钥

  1. 在域名列表中点击域名
  2. 查看"DKIM 配置"部分
  3. 复制公钥值
  4. 添加到域名的 DNS 记录

重新生成 DKIM 密钥

如果怀疑私钥泄露，可以重新生成：

  1. 点击"重新生成 DKIM"
  2. 确认操作
  3. 系统生成新的密钥对
  4. 更新 DNS 中的公钥
  5. 等待 DNS 传播（通常 10-30 分钟）

重新生成后，旧密钥仍会保留 48 小时，以确保正在传输中的邮件能够正常验证。

DKIM 选择器

支持多个 DKIM 选择器：

  • default：默认选择器
  • 可以添加自定义选择器（如 s202401、marketing 等）
  • 不同的邮件活动可以使用不同的选择器

4.3.3 域名验证

验证域名所有权

为了防止未授权使用他人域名，系统要求验证域名所有权：

方法 1：DNS TXT 记录

记录类型：TXT
主机记录：_billionmail-verification
记录值：billionmail-verification=（系统生成的随机字符串）

添加记录后点击"验证"，系统会查询 DNS 记录确认。

方法 2：上传验证文件

下载验证文件并上传到网站根目录：

http://example.com/.well-known/billionmail-verification.txt

文件内容包含验证码，系统会通过 HTTP 请求验证。

域名状态

域名可能处于以下状态：

  • 待验证：刚添加，等待验证
  • 已验证：所有权已确认，DNS 已配置
  • 配置中：所有权已确认，DNS 未完全配置
  • 错误：DNS 配置有误或验证失败
  • 已禁用：域名被禁用

4.3.4 域名设置

每个域名可以有独立的设置：

默认发件人

设置该域名的默认发件人信息：

  • 发件人名称（如 "张三 from 公司名"）
  • 发件人邮箱地址（如 noreply@example.com）
  • 回复地址（可以不同于发件人地址）

发送限制

为了防止滥用，可以设置发送限制：

  • 每小时最大发送数
  • 每天最大发送数
  • 单个收件人最大接收数

自动回复

配置自动回复邮件：

  • 启用/禁用自动回复
  • 回复内容
  • 回复条件（所有邮件、仅特定发件人等）

邮件归档

启用邮件归档功能：

  • 自动归档所有发送和接收的邮件
  • 归档保留时间（30/60/90/180/365 天或永久）
  • 归档存储位置

4.4 系统设置

4.4.1 基本设置

站点信息

配置系统的基本信息：

  • 站点名称：显示在页面标题和邮件中
  • 站点 URL：系统的访问地址
  • 管理员邮箱：接收系统通知的邮箱
  • 时区：影响日志时间戳和定时任务
  • 语言：系统默认语言
  • 日期格式：YYYY-MM-DD、DD/MM/YYYY 等

邮件设置

配置邮件相关的全局设置：

  • 默认发件人名称
  • 默认发件人邮箱
  • 默认回复地址
  • 退订链接文本
  • 邮件签名

发送限制

全局发送限制（对所有域名生效）：

  • 每小时最大发送数
  • 每天最大发送数
  • 并发发送连接数
  • 发送间隔（毫秒）

这些限制可以防止被 ISP 标记为垃圾邮件发送者。

4.4.2 SMTP 设置

SMTP 服务器配置

配置 Postfix SMTP 服务器：

  • 主机名：mail.yourdomain.com
  • 监听端口：25、465、587
  • 最大消息大小：10MB、25MB、50MB
  • 连接超时：30、60、120 秒
  • TLS 设置：必需、可选、禁用

中继设置

如果需要通过第三方 SMTP 服务器中继邮件（某些情况下可以提高送达率）：

  • 启用 SMTP 中继
  • 中继服务器地址
  • 中继端口
  • 中继认证用户名
  • 中继认证密码

常用的中继服务：

  • Amazon SES
  • SendGrid
  • Mailgun
  • SparkPost

发送队列配置

配置邮件队列的行为：

  • 队列处理间隔
  • 最大队列大小
  • 重试次数
  • 重试间隔
  • 失败后的操作（继续/停止）

4.4.3 存储设置

数据库配置

虽然一般不需要修改，但可以查看和调整：

  • PostgreSQL 连接信息
  • 连接池大小
  • 查询超时
  • 备份设置

Redis 配置

Redis 缓存和队列设置：

  • Redis 连接信息
  • 缓存过期时间
  • 队列名称
  • 最大队列长度

文件存储

配置文件存储设置：

  • 本地存储路径
  • 最大上传大小
  • 允许的文件类型
  • 自动清理策略

支持的存储后端：

  • 本地文件系统（默认）
  • Amazon S3
  • 阿里云 OSS
  • 腾讯云 COS
  • MinIO

4.4.4 安全设置

访问控制

配置访问限制：

  • IP 白名单：只允许特定 IP 访问
  • IP 黑名单：禁止特定 IP 访问
  • 地理位置限制：只允许特定国家/地区访问

API 安全

配置 API 安全设置：

  • 启用 API 访问
  • 需要 API 密钥
  • API 速率限制（每分钟请求数）
  • 允许的 IP 地址

SSL/TLS 设置

配置 SSL 证书：

  • 查看当前证书信息（颁发者、有效期）
  • 自动续期设置
  • 强制 HTTPS：自动将 HTTP 请求重定向到 HTTPS
  • HSTS：启用 HTTP 严格传输安全

备份和恢复

配置自动备份：

  • 备份频率（每天/每周）
  • 备份时间
  • 保留份数
  • 备份内容（数据库/文件/配置）
  • 备份存储位置（本地/远程）

手动备份和恢复：

  • 立即创建备份
  • 从备份恢复
  • 下载备份文件

4.4.5 通知设置

邮件通知

配置系统发送的邮件通知：

  • 新用户注册
  • 密码重置
  • 邮件活动完成
  • 系统错误和警告
  • 存储空间不足
  • 证书即将过期

可以为每种通知选择接收者和通知方式（邮件/界面）。

Webhook 通知

配置 Webhook，在特定事件发生时通知外部系统：

  • Webhook URL
  • 触发事件（邮件发送、邮件打开、链接点击等）
  • 请求方法（POST/GET）
  • 自定义请求头
  • 重试策略

4.5 邮件模板管理

4.5.1 模板类型

BillionMail 支持多种类型的邮件模板：

营销邮件模板

  • 促销活动
  • 新品发布
  • 季节性营销
  • 特别优惠

交易邮件模板

  • 订单确认
  • 发货通知
  • 账单通知
  • 密码重置

新闻通讯模板

  • 周刊/月刊
  • 行业动态
  • 公司新闻

系统通知模板

  • 欢迎邮件
  • 账户验证
  • 重要更新

4.5.2 创建邮件模板

使用可视化编辑器

  1. 导航到"邮件模板"
  2. 点击"创建模板"
  3. 选择"可视化编辑器"
  4. 输入模板名称和描述
  5. 使用拖拽式编辑器设计邮件：

可用元素：

  • 文本块
  • 图片
  • 按钮
  • 分割线
  • 社交媒体图标
  • 产品展示
  • 表格
  • 代码块

编辑选项：

  • 字体：类型、大小、颜色、对齐
  • 背景：颜色、图片
  • 边距和填充
  • 边框
  • 响应式设置

预览功能：

  • 桌面预览
  • 移动设备预览
  • 不同邮件客户端预览
  1. 点击"保存"

使用 HTML 编辑器

对于有 HTML/CSS 经验的用户：

  1. 选择"HTML 编辑器"
  2. 直接编写 HTML 代码
  3. 使用内置的代码高亮和自动完成功能
  4. 可以导入现有的 HTML 模板
  5. 预览效果
  6. 保存

使用预设模板

系统提供了多个专业设计的模板：

  1. 选择"从模板库选择"
  2. 浏览模板分类（营销、交易、新闻通讯等）
  3. 预览模板
  4. 点击"使用此模板"
  5. 根据需要自定义内容
  6. 保存

4.5.3 模板变量

模板变量允许在邮件中插入动态内容：

基本变量：

{{name}}          # 收件人姓名
{{email}}         # 收件人邮箱
{{first_name}}    # 名
{{last_name}}     # 姓
{{company}}       # 公司名称
{{title}}         # 职位

自定义变量：
可以添加任意自定义变量，在发送时提供值：

{{order_id}}      # 订单号
{{order_total}}   # 订单金额
{{tracking_no}}   # 物流单号
{{expire_date}}   # 过期日期

系统变量：

{{unsubscribe_url}}    # 退订链接
{{view_online_url}}    # 在线查看链接
{{current_date}}       # 当前日期
{{current_year}}       # 当前年份
{{site_name}}          # 站点名称
{{sender_name}}        # 发件人名称

条件语句：

{% if premium %}
  尊敬的高级会员，您享有特殊折扣！
{% else %}
  注册成为高级会员，享受更多优惠！
{% endif %}

循环语句：

{% for product in products %}
  <div>
    <h3>{{product.name}}</h3>
    <p>价格：{{product.price}}</p>
  </div>
{% endfor %}

4.5.4 模板测试

在使用模板前，应该进行充分测试：

发送测试邮件

  1. 在模板编辑器中点击"发送测试"
  2. 输入测试邮箱地址
  3. 提供测试数据（变量值）
  4. 点击"发送"
  5. 检查收到的邮件

垃圾邮件测试

使用内置的垃圾邮件检查工具：

  1. 点击"垃圾邮件检查"
  2. 系统分析邮件内容
  3. 显示评分和问题列表
  4. 提供改进建议

常见问题包括：

  • 过多的图片
  • 缺少文本内容
  • 使用了垃圾邮件常用词汇
  • 缺少退订链接
  • 图片过大

响应式测试

测试邮件在不同设备上的显示效果：

  • 桌面（Outlook、Gmail、Apple Mail 等）
  • 移动设备（iOS、Android）
  • 不同屏幕尺寸

使用内置的设备预览功能或发送到真实设备测试。

4.5.5 模板版本管理

系统自动保存模板的每个版本：

  • 查看历史版本
  • 比较版本差异
  • 恢复到旧版本
  • 复制版本创建新模板

这确保了可以安全地修改模板，不用担心丢失之前的工作。

4.6 小结

在本章中，我们详细介绍了 BillionMail 的核心功能和配置管理。主要内容包括：

  1. Web 管理界面：了解了仪表板布局、导航方式和通知系统。

  2. 用户管理：学习了如何添加和管理用户、配置角色权限、实施安全策略。

  3. 域名管理：掌握了添加域名、配置 DKIM、验证域名所有权的方法。

  4. 系统设置：了解了各种系统配置选项，包括基本设置、SMTP 设置、存储设置和安全设置。

  5. 邮件模板管理：学习了如何创建和管理邮件模板、使用模板变量、进行模板测试。

正确的配置是高效使用 BillionMail 的基础。在下一章中，我们将深入探讨邮件服务器的详细配置，包括 DNS 记录优化、反垃圾邮件配置等，以确保邮件能够顺利送达。

posted @ 2025-12-17 07:35  我才是银古  阅读(2)  评论(0)    收藏  举报