webhook-buffer

목적지가 죽어도, 웹훅은 남습니다.

웹훅을 받아 등록된 목적지로 그대로 넘기는 작은 Rust 서버입니다. 전달에 실패한 웹훅은 저장해 두었다가 다시 보냅니다.

먼저 저장하고, 실패 이유에 따라 다르게 보냅니다.

POST /h/{slug}→SQLite에 저장→202 Accepted→목적지마다 따로 전달
2xx

끝

그 목적지는 완료됩니다. 목적지 하나가 죽어도 다른 목적지에는 영향이 없습니다.

에러 응답

백오프로 재시도

실패할 때마다 간격이 두 배로 늘고, 정해진 횟수(기본 10회)까지 다시 보냅니다. 다 쓰면 “실패”로 멈추고, 패널에서 재시도하거나 포기합니다.

응답 없음

쌓아 두고 대기

연결 실패나 타임아웃이면 다시 보내지 않습니다. 새 웹훅도 쌓아 두었다가, 목적지가 복구 알림을 보내면 한꺼번에 보냅니다.

컨테이너 하나로 시작.

엔드포인트와 목적지는 웹 패널에서 관리하고, 받은 웹훅과 전달 상태도 거기서 봅니다.

docker run -d --name webhook-buffer -p 8080:8080 \
  -e ADMIN_TOKEN=your-secret \
  -v webhook-buffer-data:/data \
  ghcr.io/pixelzx0/webhook-buffer:latest

SUPPORTED ARCHITECTURES

  • amd64
  • arm64
  • arm/v7
  • arm/v6
  • 386
  • ppc64le
  • riscv64
  • loong64
  • s390x

기본값

MAX_BACKOFF_SECS
300
MAX_CONCURRENCY
16
MAX_BODY_BYTES
10 MiB

타임아웃도 응답 없음으로 봅니다. 느리기만 한 목적지도 복구 알림이 올 때까지 받지 못하니 REQUEST_TIMEOUT_SECS를 넉넉히 잡으세요.