消息渠道配置

Forge Admin 通过 forge-plugin-message 模块提供多渠道消息推送能力。

支持的消息渠道

渠道	说明	适用场景
站内信	系统内消息通知	系统内交互通知
邮件	SMTP 邮件推送	正式通知、报表
短信	阿里云/腾讯云短信	验证码、紧急通知
企业微信	企业微信消息推送	企业内部通知

站内信

站内信为默认启用的消息渠道，无需额外配置。

使用方式

// 后端发送站内信
messageService.sendSiteMessage(userId, "标题", "内容");

用户在前端顶部铃铛图标中查看站内信。

邮件（SMTP）

配置

forge:
  message:
    mail:
      host: smtp.example.com
      port: 465
      username: noreply@example.com
      password: your-mail-password
      from: noreply@example.com
      ssl: true

配置项	说明
host	SMTP 服务器地址
port	SMTP 端口（SSL 通常为 465）
username	发件邮箱账号
password	邮箱密码或授权码
from	发件人地址
ssl	是否启用 SSL

测试

1. 进入「消息中心」→「消息渠道」
2. 选择「邮件」渠道，点击「测试」
3. 输入收件邮箱
4. 查看是否收到测试邮件

短信

阿里云短信

forge:
  message:
    sms:
      provider: aliyun
      aliyun:
        access-key-id: your-access-key-id
        access-key-secret: your-access-key-secret
        sign-name: Forge科技
        endpoint: dysmsapi.aliyuncs.com

配置项	说明
access-key-id	阿里云 AccessKey ID
access-key-secret	阿里云 AccessKey Secret
sign-name	短信签名名称
endpoint	阿里云短信 API 地址

腾讯云短信

forge:
  message:
    sms:
      provider: tencent
      tencent:
        secret-id: your-secret-id
        secret-key: your-secret-key
        sign-name: Forge科技
        sdk-app-id: your-sdk-app-id
        region: ap-guangzhou

短信模板

短信发送需要配置短信模板，不同供应商的模板格式不同：

供应商	模板格式	示例
阿里云	SMS_123456789	您的验证码是$
腾讯云	1234567	您的验证码是

企业微信消息

企业微信消息推送需要先完成企业微信基础配置。

forge:
  message:
    wecom:
      enabled: true

消息模板管理

1. 进入「消息中心」→「消息模板」
2. 创建消息模板，配置多渠道内容：

配置项	说明
模板编码	唯一标识
模板名称	显示名称
站内信内容	站内信的标题和正文
邮件内容	邮件的主题和正文
短信内容	短信模板 ID 和变量
变量定义	模板中使用的变量占位符

变量使用

模板中使用 ${变量名} 引用变量：

尊敬的${userName}，您的订单${orderNo}已发货。

安全注意

• AccessKey 和密码加密存储，列表脱敏显示
• 短信发送频率限制，防止恶意调用
• 邮件密码建议使用授权码而非真实密码
• 敏感渠道（短信）建议配置白名单

下一步

• 企业微信基础配置
• 文件存储配置