kapdap/matrix-appservice-webhooks

matrix-appservice-webhooks镜像说明

镜像概述

matrix-appservice-webhooks是Matrix平台的Slack兼容webhook桥接服务，允许外部系统通过标准webhook接口向Matrix房间发送消息，支持自定义消息样式和格式转换，帮助用户将第三方工具整合到Matrix协作生态中。

核心功能

• Slack兼容接口：无缝对接支持Slack webhook格式的外部系统；
• 自定义消息样式：可设置发送者的显示名称（displayName）和头像（avatarUrl）；
• 多格式支持：消息内容支持plain文本或html格式；
• 表情自动转换：将:heart:等符号转为对应emoji（可通过emoji: false关闭）；
• 消息类型扩展：支持发送通知（notice）或表情消息（emote）。

使用场景

• 监控系统向Matrix房间推送告警通知；
• CI/CD工具（如Jenkins）同步构建结果到团队协作房间；
• 表单系统、客服工具的消息同步到Matrix；
• 其他第三方服务的事件通知整合。

配置与部署

Docker部署示例

bash
docker run -p 9000:9000 -v /path/to/your/config:/data kapdap/matrix-appservice-webhooks

说明：

• -p 9000:9000：映射容器端口到主机（默认服务端口为9000）；
• -v /path/to/your/config:/data：挂载主机配置目录，需包含：
  • config.yaml：服务配置文件（参考官方sample.yaml）；
  • appservice-registration-webhooks.yaml：Matrix应用服务注册文件；
  • database.json：服务数据存储文件。

基础使用流程

1. 在Matrix房间邀请桥接机器人（如@_webhook:t2bot.io）；
2. 发送!webhook指令获取webhook链接；
3. 通过链接发送JSON消息（示例）：

json
{
  "text": "监控告警：服务器CPU使用率超过80%",
  "format": "plain",
  "displayName": "监控机器人",
  "avatarUrl": "[***]"
}