Overview

Full name
docker.io/pingcap/tidb-binlog
Registry
docker.io
Namespace
pingcap
Repository
tidb-binlog
Cached tags
279
Last synced
07/06/2026, 11:56 AM

Introduction

TiDB Binlog 增量同步组件镜像,将 TiDB 变更流式输出至下游 MySQL/Kafka,用于灾备复制与异构数据订阅。

Details

pingcap/tidb-binlog 包含 Pump 与 Drainer 角色,Pump 从 TiKV 采集 binlog,Drainer 按规则写入目标库或消息队列。典型用于 TiDB 到 MySQL 的准实时同步、审计流水归档,与 TiCDC 相比属上一代方案但仍有存量集群依赖。生产应固定 tag、Pump/Drainer 分节点部署并监控 sync lag,下游凭据经 Secret 管理。

快速启动

docker run -d --name tidb-drainer \
  -p 8249:8249 \
  -e PD_ADDRS=pd0:2379 \
  docker.io/pingcap/tidb-binlog:latest

推荐实践

docker run -d --name tidb-drainer \
  --restart unless-stopped \
  -p 8249:8249 \
  -e PD_ADDRS=pd0.internal:2379,pd1.internal:2379 \
  -v /data/tidb-binlog/drainer:/data \
  docker.io/pingcap/tidb-binlog:v8.1.0

核心参数说明

  • -p 8249:8249 — Drainer status/metrics 端口
  • -e PD_ADDRS — TiDB PD 集群地址列表
  • -v .../drainer:... — checkpoint 与元数据持久化
  • --restart unless-stopped — 同步链路持续运行
  • 固定 tag — 与 TiDB 大版本 pin
  • 拓扑 — Pump 与 Drainer 分角色部署

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: tidb-drainer
spec:
  replicas: 1
  selector:
    matchLabels:
      app: tidb-drainer
  template:
    metadata:
      labels:
        app: tidb-drainer
    spec:
      containers:
        - name: drainer
          image: docker.io/pingcap/tidb-binlog:v8.1.0
          ports:
            - containerPort: 8249
          env:
            - name: PD_ADDRS
              value: "pd.tidb.svc:2379"
          volumeMounts:
            - name: data
              mountPath: /data
      volumes:
        - name: data
          persistentVolumeClaim:
            claimName: tidb-drainer-data
---
apiVersion: v1
kind: Service
metadata:
  name: tidb-drainer
spec:
  selector:
    app: tidb-drainer
  ports:
    - port: 8249
      targetPort: 8249

Pump 独立 Deployment;PVC 保留 checkpoint,NetworkPolicy 放行 PD/TiKV 端口。

Latest tags (20)

View all 279 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/pingcap/tidb-binlog
:v7.5.7
linux/amd64linux/arm64
2025/09/04 12:30300.0 MBsha256:b05effd3a39c
docker.io/pingcap/tidb-binlog
:v7.5.6
linux/amd64linux/arm64
2025/03/14 12:27289.7 MBsha256:d019f0f30e18
docker.io/pingcap/tidb-binlog
:v6.5.12
linux/arm64linux/amd64
2025/02/27 19:32249.1 MBsha256:91ff3c2ab542
docker.io/pingcap/tidb-binlog
:v7.5.5
linux/amd64linux/arm64
2024/12/31 13:40299.8 MBsha256:dd003536d32c
docker.io/pingcap/tidb-binlog
:v8.1.2
linux/amd64linux/arm64
2024/12/26 11:07291.7 MBsha256:4a1300a31ee5
docker.io/pingcap/tidb-binlog
:v7.1.6
linux/amd64linux/arm64
2024/11/21 16:34256.7 MBsha256:8250ba149266
docker.io/pingcap/tidb-binlog
:v7.5.4
linux/amd64linux/arm64
2024/10/15 15:58291.7 MBsha256:1997b7212afa
docker.io/pingcap/tidb-binlog
:v6.1.0
linux/amd64linux/arm64
2024/10/09 14:41147.5 MBsha256:b72551220e85
docker.io/pingcap/tidb-binlog
:v6.5.11
linux/amd64linux/arm64
2024/09/20 11:25172.7 MBsha256:cfd0ed0e79be
docker.io/pingcap/tidb-binlog
:v8.1.1
linux/amd64linux/arm64
2024/08/27 14:16288.4 MBsha256:06ab74ff04a0
docker.io/pingcap/tidb-binlog
:v8.3.0
linux/amd64linux/arm64
2024/08/22 11:32291.7 MBsha256:8e3ca06681cd
docker.io/pingcap/tidb-binlog
:nightly
linux/amd64linux/arm64
2024/08/19 02:05291.7 MBsha256:2d95587302b7
docker.io/pingcap/tidb-binlog
:master
linux/amd64linux/arm64
2024/08/19 02:05291.7 MBsha256:2d95587302b7
docker.io/pingcap/tidb-binlog
:v7.5.3
linux/amd64linux/arm64
2024/08/05 11:44256.7 MBsha256:c42aabc0b9d8
docker.io/pingcap/tidb-binlog
:v8.2.0
linux/arm64linux/amd64
2024/07/11 16:35264.7 MBsha256:a141f5556ffb
docker.io/pingcap/tidb-binlog
:v6.5.10
linux/arm64/v8linux/amd64
2024/06/20 15:17295.1 MBsha256:4f1ead353bf4
docker.io/pingcap/tidb-binlog
:v6.5.10-pre
linux/arm64/v8linux/amd64
2024/06/18 23:25295.1 MBsha256:4f1ead353bf4
docker.io/pingcap/tidb-binlog
:v7.5.2
linux/amd64linux/arm64
2024/06/13 11:39256.7 MBsha256:d0a8307f5caa
docker.io/pingcap/tidb-binlog
:v8.1.0
linux/amd64linux/arm64
2024/05/24 16:27256.7 MBsha256:d86549857c52
docker.io/pingcap/tidb-binlog
:v7.1.5
linux/amd64linux/arm64
2024/04/26 11:00256.7 MBsha256:dd02c1d31aa0