对外通道
把报告、故障和巡检结果推送到飞书、钉钉、企业微信、Teams、Slack 或邮件:投递目标、邮件服务器、私有化 IM 地址白名单、投递记录。失败自动重试,放弃的可以重投。所有版本可用。
对外通道是网关向外发送消息的出口,位于 平台体检 页的标签中,所有版本可用。修改配置需要管理员角色。
经这里发出的消息有:
发往外部的内容按当前的字段脱敏档位处理。

添加投递目标
前提条件
- 管理员角色。
- 发送邮件时,已配置邮件服务器,见下文。
- IM 部署在内网时,已把它的地址加入白名单,见下文。
步骤
- 在 投递目标 标签中选择 新增目标。
- 选择 渠道:飞书、钉钉、企业微信、Teams、Slack 或邮件,输入 名称。
- 输入群机器人或 Incoming Webhook 的 webhook URL。飞书和钉钉的机器人开启了签名校验时,输入 签名密钥(secret)。邮件渠道改为输入 收件人,以逗号、分号或换行分隔。
- 在 绑定周期 中选择接收哪几种报告:日报、周报、月报。
- 选择 告警阈值:提示、低、中、高或严重,默认为高。严重度不低于该阈值的新故障推送给这个目标。
- 确认 启用该目标 已选中,保存。
- 选择该目标的 测试发送,确认消息送达。
webhook URL 和签名密钥都加密保存在网关中,保存后不再显示。编辑目标时,webhook 一栏只显示主机名(「已设置(主机名),留空不改」),签名密钥一栏留空即保留原值;不再需要签名时,选中 清除已设置的密钥(改为无签名)。升级前以明文保存的旧记录,在下一次保存对外通道的任意设置时自动加密。
网关重装后旧密文无法解开,目标标记为 密钥失效,重新填写即可。
删除目标后,它立即停止接收报告和告警,历史投递记录保留。
设置推送排期
投递目标 标签顶部的 推送排期 决定定时报告何时生成并推送。
步骤
- 在 推送周期 中选择日报、周报、月报。
- 选择 发送时刻(小时),输入 时区,例如
Asia/Shanghai。 - 选择 保存排期。
保存后立即生效:日报每天、周报每周一、月报每月 1 日在该时刻生成,再推送给绑定了该周期的目标。没有选择任何周期时,按网关环境变量 RST_REPORT_SCHEDULE 执行,见运维报告。定时报告需要专业版或企业版许可。
配置邮件服务器
邮件服务器全局一份,所有邮件目标共用。
步骤
- 在 邮件服务器 标签中输入 服务器地址,选择 加密方式。端口随加密方式变化,手动改过的端口不变。
- 输入 用户名 和 密码(应用专用密码或授权码)。服务器不要求认证时,用户名留空。
- 输入 发件地址 和 发件人名称,保存。
- 在 投递目标 中建一个邮件目标,用它的 测试发送 验证。
保存时只校验格式,能否发出要以测试发送为准。没有配置邮件服务器时,邮件目标持续投递失败,原因只在投递记录中可见。
添加私有化 IM 地址
默认每个渠道只推送到它的官方域名:
| 渠道 | 官方域名 |
|---|---|
| 飞书 | open.feishu.cn、open.larksuite.com |
| 钉钉 | oapi.dingtalk.com |
| 企业微信 | qyapi.weixin.qq.com |
| Slack | hooks.slack.com |
| Teams | *.webhook.office.com、outlook.office.com、outlook.office365.com、*.logic.azure.com、*.logic.azure.us |
私有化部署的飞书、企业微信等需要把地址加入白名单。
步骤
- 在 私有化 IM 地址 标签中找到对应渠道。
- 每行输入一个主机名、IP 或网段,例如
im.corp.local或10.20.0.0/24。 - 选择 保存地址白名单。
发送时网关解析域名,逐个检查解析到的地址:内网地址只有其 IP 或网段写进了白名单才放行。云元数据地址(例如 169.254.0.0/16)无论如何配置都禁止访问。
重投失败的消息
投递记录 标签列出每条消息的类型、渠道、目标、状态、尝试次数和最后错误。
| 状态 | 含义 |
|---|---|
| 排队中 | 等待发送 |
| 发送中 | 正在投递 |
| 已送达 | 发送成功 |
| 待重试 | 发送失败,按退避间隔自动重试,间隔从 30 秒起逐次加倍 |
| 已放弃 | 尝试 6 次仍失败,或遇到不可重试的错误 |
步骤
- 在 投递记录 中按状态筛选 已放弃。
- 按 最后错误 修好配置后,选择 重投。
重投需要分析员或管理员角色。
审计转发
审计转发 标签设置调用审计的开关,以及向 syslog 或 webhook 的转发,和上面的投递目标无关。转发到外部 SIEM 是企业版功能。