midmich/slack_helper

slack_helper

一个用于简化向Slack发送消息的Docker镜像，通过集成Slack的传入Webhook机制，实现灵活的消息配置与快速部署，适用于各类自动化通知场景。

核心功能

• 支持命令行参数或环境变量两种消息传递方式
• 可自定义Slack渠道、显示用户名及图标
• 提供调试日志级别控制
• 兼容Docker CLI与Docker Compose部署

使用场景

• CI/CD流水线结果通知（如GitLab CI、Jenkins）
• 系统监控告警推送
• 自动化任务状态通知
• 批量消息发送

配置说明

必填环境变量

• SLACK_WEBHOOK_URL
  [字符串] Slack消息接收的Webhook URL，获取方式参考Slack官方文档

可选环境变量

• SLACK_TEXT：消息内容（优先级高于命令行参数）
• SLACK_WEBHOOK_CHANNEL：目标渠道（支持ID、用户DM如@username或公开渠道如#testing）
• SLACK_WEBHOOK_USER：消息显示用户名
• SLACK_WEBHOOK_ICON：消息显示图标URL
• DEBUG_LEVEL：日志输出级别（整数）

部署示例

Docker CLI

bash
# 命令行参数传递消息
docker run --rm docker.xuanyuan.run/midmich/slack_helper:latest "发送到Slack的消息"

# 环境变量传递消息
docker run --rm --env SLACK_TEXT="通过环境变量指定的消息" docker.xuanyuan.run/midmich/slack_helper:latest

Docker Compose

最小化配置文件：

yaml
version: '3.2'
services:
  slack:
    image: docker.xuanyuan.run/midmich/slack_helper:latest
    environment:
      SLACK_WEBHOOK_URL: https://hooks.slack.com/services/你的/webhook/路径
      SLACK_TEXT: "测试消息内容"

使用注意

若同时提供SLACK_TEXT和命令行参数，仅SLACK_TEXT生效。示例：

bash
docker run --rm --env SLACK_TEXT="优先消息" docker.xuanyuan.run/midmich/slack_helper:latest "次要消息"

将发送"优先消息"到Slack。

实现说明

镜像使用Slack标记为"Legacy"的传入Webhook机制，该机制虽为legacy但支持渠道、用户名等自定义，而当前支持的机制无法实现这些特性，故继续使用。 ===END===