CentOS 下配置 Mantis Bug 跟踪系统使用 QQ 邮箱指南

在 CentOS 服务器上部署 Mantis Bug Tracker (MantisBT) 是管理软件缺陷的高效方式，要让团队成员及时收到问题更新通知，配置可靠的邮件发送功能至关重要，国内环境下，QQ 邮箱因其广泛使用成为常见选择，以下是如何在 CentOS 系统上为 MantisBT 配置 QQ 邮箱发送通知邮件的详细步骤：

核心准备：启用 QQ 邮箱 SMTP 服务

1. 登录 QQ 邮箱： 使用你的 QQ 邮箱账号登录 mail.qq.com。
2. 进入设置： 点击邮箱首页右上角的 设置 图标。
3. 开启服务： 找到 账户 选项卡，向下滚动至 POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务 区域。
4. 开启 SMTP： 确保 IMAP/SMTP 服务 和 POP3/SMTP 服务 至少有一项是 开启 状态，通常开启 IMAP/SMTP 即可。
5. 获取授权码： 点击对应服务右侧的 开启 按钮（若未开启），根据页面提示（可能需要验证密保手机），系统会生成一个 16 位授权码。务必妥善保管此授权码，它等同于邮箱密码用于 Mantis 连接 SMTP 服务器，后续配置中 $g_smtp_password 变量将使用此授权码，而非你的 QQ 邮箱登录密码。

CentOS 服务器端：配置 MantisBT

1. 定位配置文件： 使用 SSH 终端登录你的 Centos 服务器，找到 MantisBT 的安装目录，核心配置文件通常是 config/config_inc.php，如果该文件不存在，可将 config/config_defaults_inc.php 复制一份并重命名为 config_inc.php。

   cd /var/www/html/mantis/  # 假设 Mantis 根目录在此
   cp config/config_defaults_inc.php config/config_inc.php

2. 编辑配置文件： 使用文本编辑器（如 vim 或 nano) 打开 config/config_inc.php 文件：

   vim config/config_inc.php

3. 配置邮件发送方式： 在文件中找到或添加以下配置项，确保使用 SMTP 方式发送邮件：

   <?php
   # 邮件发送方式 - SMTP
   $g_phpMailer_method = PHPMAILER_METHOD_SMTP;

4. 配置 QQ 邮箱 SMTP 服务器信息：

   # SMTP 服务器主机地址 (QQ 邮箱)
   $g_smtp_host = 'smtp.qq.com';
   # SMTP 连接端口 (QQ 邮箱要求使用加密端口，587 配合 TLS)
   $g_smtp_port = 587;
   # 启用 SMTP 连接加密 (TLS)
   $g_smtp_connection_mode = 'tls';
   # 需要 SMTP 身份验证 (必须为 true)
   $g_smtp_username = 'your_qq_number@qq.com';  // 替换为你的完整QQ邮箱地址
   $g_smtp_password = 'your_authorization_code'; // 替换为你在第一步获取的16位授权码

5. 配置发件人信息：

   

   # 邮件发件人地址 (通常与 SMTP 用户名一致)
   $g_from_email = 'your_qq_number@qq.com'; // 替换为你的完整QQ邮箱地址
   # 邮件发件人名称 (显示给收件人的名字)
   $g_from_name = 'Mantis Bug Tracker'; // 可自定义，如 '项目组缺陷跟踪'
   # 邮件回复地址 (通常与发件人地址一致)
   $g_return_path_email = 'your_qq_number@qq.com'; // 替换为你的完整QQ邮箱地址

6. （可选但推荐）调整邮件格式与编码：

   # 邮件格式 (HTML 通常更友好)
   $g_email_receive_own = ON; // 用户操作是否接收自己触发的邮件通知
   $g_html_valid_tags = 'p, li, ul, ol, br, pre, a, b, i, em, strong, u, hr, blockquote, h1, h2, h3, h4, h5, h6'; // 允许的 HTML 标签
   $g_email_priority = 3; // 默认邮件优先级 (3=Normal)
   # 设置邮件字符集为 UTF-8，确保中文不乱码
   $g_meta_include_charset = ON;
   $g_default_language = 'chinese_simplified'; // 设置默认语言为简体中文

7. 保存并退出： 仔细检查配置项，特别是邮箱地址和授权码，确认无误后保存文件 (:wq in vim, Ctrl+O then Ctrl+X in nano)。

验证配置：发送测试邮件

1. 登录 MantisBT： 以管理员身份登录你的 MantisBT 网站。
2. 进入管理界面： 点击页面左上角或右上角的 管理 链接。
3. 发送测试邮件： 在管理面板中，找到 邮件 或 系统配置 相关的区域（路径可能类似 管理 -> 配置 -> 电子邮件配置），通常会有一个 发送测试邮件 或 测试邮件设置 的按钮或链接。
4. 填写收件人： 在弹出的测试邮件页面，输入一个有效的邮箱地址（可以是管理员邮箱或另一个用于测试的邮箱）。
5. 发送测试： 点击 发送测试邮件 按钮。
6. 检查结果：
   • 如果配置正确,测试邮箱应很快收到一封来自 Mantis Bug Tracker <your_qq_number@qq.com> 的测试邮件。
   • 如果未收到邮件,请返回 Mantis 管理界面查看是否有错误提示（常显示在页面顶部），同时检查 CentOS 服务器的 mail.log 或相关日志文件（如 /var/log/maillog），通常会有更详细的 SMTP 交互错误信息。常见问题：
     • 授权码错误： 最常见的问题，请核对 QQ 邮箱设置里生成的授权码是否与 config_inc.php 中 $g_smtp_password 的值完全一致（区分大小写）。
     • 端口或加密模式错误： 确认 $g_smtp_port = 587 和 $g_smtp_connection_mode = 'tls'。
     • 服务器防火墙/安全组限制： 确保 CentOS 服务器的出站规则允许连接到 smtp.qq.com 的 587 端口。
     • QQ 邮箱 SMTP 服务未开启： 再次检查 QQ 邮箱账户设置里 SMTP 服务是否已成功开启。

确保稳定运行

• 授权码有效期： QQ 邮箱授权码默认长期有效，但如果你在 QQ 邮箱设置中关闭了 SMTP 服务再重新开启，旧的授权码会立即失效，必须生成新授权码并更新到 config_inc.php 中。
• 监控日志： 定期检查 Mantis 的系统日志和服务器邮件日志 (/var/log/maillog)，及时发现并解决可能的发送失败问题。
• 备份配置： 修改 config_inc.php 前做好备份是良好习惯。

在 CentOS 上为 MantisBT 集成 QQ 邮箱，关键在于正确获取并使用 SMTP 授权码，并准确配置加密端口与模式，此配置显著提升了团队协作效率，确保缺陷状态更新能第一时间触达相关人员，开源工具的灵活性与主流邮箱服务的稳定性结合，为项目质量保障提供了可靠支持。