Halo 邮件通知配置说明

QQ 邮箱 SMTP 授权码 + Halo 后台填写对照

站点：https://halo.gwozai.com
整理日期：2026-09-14

一、适用场景

当 Halo 站点出现新评论、留言、回复等事件时，可通过邮件通知站长或相关用户。本说明以 QQ 邮箱作为发信账号，在 Halo 后台「设置 → 通知设置 → 邮件通知」中完成配置。

2026-09-14 已用同一套 QQ SMTP 账号完成本地发信测试，登录与投递均成功。按本文填写即可在 Halo 中复用。

二、先准备 QQ 邮箱授权码

1. 什么是授权码

授权码是 QQ 邮箱给第三方客户端 / 服务使用的专用密码，用于 POP3、IMAP、SMTP 等登录。Halo 的「密码」栏必须填授权码，不能填 QQ 登录密码。

修改 QQ 账号密码后，授权码会过期，需要重新生成。不要把授权码发给他人，也不要写入公开仓库。

2. 网页端获取授权码

1. 登录 QQ 邮箱网页版。
2. 进入「设置 → 账号与安全 → 安全设置」。
3. 开启 POP3/IMAP/SMTP 服务，按提示完成验证。
4. 生成授权码并自行保存。授权码通常只显示一次。

App 端路径：左上角头像 → 账号 → 安全管理 → 设备管理 → 授权码管理。

3. QQ 邮箱服务器参数

Halo 发信只需要 SMTP。IMAP / POP3 仅在用客户端收信时才需要。QQ 邮箱建议用 IMAP 收信，客户端操作会同步回服务器。

三、Halo 后台怎么填

1. 进入配置页

1. 登录 Halo 后台：https://halo.gwozai.com
2. 打开「设置 → 通知设置 → 邮件通知」。
3. 打开「启用邮件通知器」，按下面对照表填写后保存。

2. 字段对照表（直接照填）

如果 465 + SSL 失败，可改用端口 587，加密方式选 STARTTLS 或 TLS，其余字段不变。

3. 常见填错

四、怎么验证已经配好

1. 在 Halo 邮件通知页保存配置。
2. 使用页面上的测试邮件功能发一封（如有该按钮）。
3. 到管理员绑定邮箱的收件箱查看，同时检查垃圾箱。
4. 也可在前台留一条测试评论，确认评论通知邮件能送达。

通知会发到哪里：Halo 使用个人中心里绑定的电子邮箱作为接收地址。若希望收到 584257191@qq.com，请到管理员账号的个人中心把邮箱改成该地址。

五、IMAP 和 POP 的区别（收信时才需要）

POP3：客户端把服务器上的邮件下载下来。你在客户端里移动、标记已读等操作，一般不会同步回 QQ 邮箱网页。第三方通过 POP 收信时，也可能删除服务器上的邮件。若要保留服务器副本，请勾选客户端里的「保留邮件副本 / 备份」。

IMAP：客户端操作会同步回服务器，移动、已读、删除都会两边一致，属于双向同步。IMAP 还可以先只下载主题，需要时再下载全文。QQ 邮箱推荐使用 IMAP。

Halo 邮件通知只负责发信，走 SMTP，与 IMAP / POP 无关。

六、安全注意

• 授权码等同于邮箱发信权限，不要发到聊天、截图或 Git 仓库。
• 如果授权码已经泄露，到 QQ 邮箱「授权码管理」作废并重新生成。
• 更改 QQ 密码后，旧授权码会失效，Halo 里也要同步换成新授权码。
• 本文不保存授权码明文。需要时到 QQ 邮箱后台自行查看或重新生成。

七、填写模板（复制用）