通知渠道
通知渠道
功能简介
通知渠道用于配置「消息往哪里发」。SamWaf 通过这里配置好的渠道，将系统告警和通知推送给你。
通知功能由三部分协同工作：
- 通知渠道：配置消息的发送方式（钉钉、飞书、邮件等具体怎么发）。
- 通知订阅：配置什么类型的事件发送到哪个渠道。
- 通知日志：记录每一条通知的发送结果。
本页负责第一部分。目前支持的渠道类型有：钉钉、飞书、企业微信、邮件、Server酱。
操作步骤
1. 新增渠道
- 点击页面左上角的 添加渠道 按钮。
- 填写 渠道名称，选择 渠道类型。
- 根据所选类型填写对应的配置参数（不同类型的配置项不同，见下方分类说明）。
- 选择 状态（开启 / 关闭）。
- 如有需要，填写 备注。
- 点击 确定 保存。
2. 不同渠道类型的配置
钉钉 / 飞书 / 企业微信
- Webhook地址：群机器人的 Webhook 地址（必填）。
- 密钥：用于加签验证（钉钉、飞书需要；企业微信无需配置密钥）。
企业微信机器人 Webhook 获取方式：在企业微信群聊中点击右上角「···」→「添加群机器人」→「新创建一个机器人」，复制生成的 Webhook 地址。
Server酱
- SendKey：从 Server酱 控制台获取的 SendKey，支持标准格式（SCT 开头）和 sctp 私有部署格式。
SendKey 获取方式：访问 Server酱 官网（https://sct.ftqq.com/）并用微信扫码登录，在控制台复制 SendKey，并在「消息通道」页面配置接收通知的平台（微信、企业微信、钉钉等）。
邮件
填写 SMTP 相关参数（详见下方字段说明）。页面内置「常见邮箱配置参考」折叠面板，提供 QQ、163、126、Gmail、Outlook、阿里云等邮箱的 SMTP 服务器、端口和加密方式参考。
重要提示：端口 465 请选择 SSL/TLS 加密，端口 587 请选择 STARTTLS 加密；端口 25 如需认证必须使用 STARTTLS，否则服务器会拒绝。多数邮箱需要先开启 SMTP 服务并生成授权码（不是登录密码）。
当加密方式选择 SSL/TLS 或 STARTTLS 后，会出现 证书校验 选项。若邮件服务器使用自签名证书（常见于内网自建邮件服务），可勾选 跳过证书校验（自签名证书），SamWaf 将不再校验服务器的 TLS 证书。
安全提示
勾选「跳过证书校验」会降低传输安全性，可能被中间人攻击，请仅在可信内网环境中使用。
3. 测试渠道
在列表中点击某条渠道的 测试 按钮，SamWaf 会尝试通过该渠道发送一条测试消息。提示「测试成功」后，请到对应平台确认是否收到通知。
4. 启用 / 禁用
列表中每条渠道带有状态开关，可直接点击切换启用或禁用。
5. 编辑 / 删除
- 点击 编辑 修改渠道配置。
- 点击 删除 移除渠道。删除后，与该渠道相关的订阅也将被删除。
字段说明
通用字段
| 字段 | 说明 |
|---|---|
| 渠道名称 | 渠道的标识名称，必填。 |
| 渠道类型 | 钉钉 / 飞书 / 企业微信 / 邮件 / Server酱，必填。 |
| 状态 | 开启 / 关闭，控制该渠道是否生效。 |
| 备注 | 自定义说明，可选。 |
钉钉 / 飞书 / 企业微信
| 字段 | 说明 |
|---|---|
| Webhook地址 | 群机器人 Webhook 地址，必填。 |
| 密钥 | 加签密钥，可选；企业微信无需配置。 |
Server酱
| 字段 | 说明 |
|---|---|
| SendKey | Server酱 控制台获取的 SendKey，支持 SCT 与 sctp 格式。 |
邮件
| 字段 | 说明 |
|---|---|
| SMTP服务器 | 邮件服务器地址，例如 smtp.qq.com。 |
| SMTP端口 | 服务器端口，默认 25；常用 465（SSL/TLS）或 587（STARTTLS）。 |
| 用户名 | 邮箱账号，通常与发件人邮箱一致。 |
| 密码 | 邮箱密码或授权码。 |
| 发件人邮箱 | 发件人邮箱地址。 |
| 发件人名称 | 发件人显示名称，可选。 |
| 收件人邮箱 | 默认收件人，多个用逗号分隔；订阅时可针对消息类型单独配置，未配置则使用此默认值。 |
| 加密方式 | 不加密 / SSL/TLS / STARTTLS。 |
| 证书校验 | 仅当加密方式为 SSL/TLS 或 STARTTLS 时显示。勾选「跳过证书校验（自签名证书）」后不校验邮件服务器的 TLS 证书，适用于自签名证书的内网邮件服务器；会降低安全性，请仅在可信网络中使用。 |
常见问题
配置后测试失败怎么办？
- 邮件渠道请确认端口与加密方式匹配（465 用 SSL/TLS，587 用 STARTTLS），密码使用的是邮箱授权码而非登录密码。
- 若报连接被拒绝（connection refused），说明 SMTP 服务器地址或端口不可达，请先确认服务器 IP、端口填写正确且网络可达。
- 若使用自签名证书的邮件服务器，报证书校验相关错误（如 certificate signed by unknown authority），可在渠道配置中勾选 跳过证书校验（自签名证书） 后重试。
- 钉钉 / 飞书请确认 Webhook 地址和密钥正确，且机器人加签设置一致。
- 可在 通知日志 中查看失败的具体错误信息。
配置好渠道后为什么收不到通知？
仅配置渠道还不够，还需在 通知订阅 中将对应的消息类型订阅到该渠道。