jancubillan/webhook Docker Image Overview

jancubillan/webhook

基于Rocky Linux的轻量级webhook服务镜像，用于接收HTTP请求并执行指定命令，支持热重载、详细日志及自定义触发器规则，默认监听9000端口。

0 次下载activejancubillan镜像

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

镜像概述

基于Rocky Linux构建的轻量级webhook服务镜像，集成adnanh/webhook工具，用于创建HTTP端点接收外部请求并触发预定义命令执行。默认配置支持热重载、详细日志输出，并通过hooks.json文件定义触发器规则。

核心功能与特性

轻量级基础：基于Rocky Linux，镜像体积小，运行资源占用低
默认配置优化：默认启用详细日志（-verbose）、热重载（-hotreload），监听9000端口
灵活触发器：通过hooks.json文件自定义webhook ID、执行命令、响应消息及触发规则
安全验证：支持基于URL参数的令牌验证（如token参数匹配）
热重载支持：配置文件更新后自动加载，无需重启容器

使用场景

自动化部署流程：接收代码仓库（如GitHub、GitLab）的webhook事件触发部署脚本
系统监控响应：接收监控系统告警触发应急处理命令
定时任务触发：配合外部定时工具调用webhook端点执行周期性任务
跨系统集成：作为不同系统间的事件桥梁，通过HTTP请求触发特定操作

使用方法

基本运行（docker run）

bash
docker run -d \
  --name=webhook \
  -p 9000:9000 \
  -v /path/to/local/config:/config \
  jancubillan/webhook

Docker Compose配置

yaml
---
version: "2.1"
services:
  webhook:
    image: jancubillan/webhook
    container_name: webhook
    environment:
      - PUID=1000  # 运行用户ID
      - PGID=1000  # 运行用户组ID
      - TZ=Asia/Singapore  # 时区设置
    volumes:
      - ./config-webhook:/config  # 挂载配置目录（包含hooks.json）
    ports:
      - 9000:9000  # 端口映射
    restart: unless-stopped
    command: -verbose -hooks=hooks.json -hotreload  # 自定义启动参数
    logging:
      driver: "json-file"
      options:
        max-file: "6"  # 日志文件最大数量
        max-size: "50m"  # 单个日志文件大小限制

配置说明

核心配置文件：hooks.json

容器默认从/config/hooks.json加载webhook配置，需通过卷挂载自定义配置文件。配置示例：

json
[
  {
    "id": "simple-one",  // webhook唯一标识（用于URL路径：/hooks/simple-one）
    "execute-command": "/path/to/command.sh",  // 触发时执行的命令/脚本路径
    "response-message": "Executing simple webhook...",  // 响应客户端消息
    "trigger-rule": {  // 触发规则配置
      "match": {
        "type": "value",  // 匹配类型（value：值匹配）
        "value": "42",  // 期望匹配的值
        "parameter": {
          "source": "url",  // 参数来源（url：URL查询参数）
          "name": "token"  // 参数名称（如URL中的?token=42）
        }
      }
    }
  }
]