xTag

Overview

Full name
docker.io/mariadb/maxscale
Registry
docker.io
Namespace
mariadb
Repository
maxscale
Cached tags
167
Last synced
07/06/2026, 01:57 PM

Introduction

MariaDB MaxScale 数据库代理镜像，提供读写分离、连接路由与查询过滤，部署于应用与 MariaDB/MySQL 集群之间。

Details

mariadb/maxscale 是 MariaDB 官方 MaxScale 代理，解析 MySQL 协议并按规则将读请求转发至 replica、写请求至 primary。典型用于 PHP/Java 应用统一连接入口，避免客户端感知拓扑变更。与 ProxySQL 相比与 MariaDB 生态集成更深；配置经 /etc/maxscale.cnf 挂载，Kubernetes 中无状态 Deployment 即可，backend 地址变更后 reload 配置。

快速启动

docker run -d --name maxscale \
  -p 4006:4006 \
  -v $(pwd)/maxscale.cnf:/etc/maxscale.cnf \
  docker.io/mariadb/maxscale:latest

推荐实践

docker run -d --name maxscale \
  --restart unless-stopped \
  -p 4006:4006 -p 8989:8989 \
  -v /data/maxscale/maxscale.cnf:/etc/maxscale.cnf \
  -e MAXSCALE_USER=admin \
  -e MAXSCALE_PASSWORD=admin-pass \
  docker.io/mariadb/maxscale:23.08.5

核心参数说明

  • -p 4006:4006 — 应用连接 MaxScale 的 MySQL 端口
  • -p 8989:8989 — REST API / MaxCtrl 管理端口
  • -v .../maxscale.cnf:... — 路由与 backend 配置
  • -e MAXSCALE_USER/PASSWORD — 管理 API 凭据
  • --restart unless-stopped — 数据库代理层高可用
  • 固定 tag — MaxScale 大版本 pin

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: maxscale
spec:
  replicas: 2
  selector:
    matchLabels:
      app: maxscale
  template:
    metadata:
      labels:
        app: maxscale
    spec:
      containers:
        - name: maxscale
          image: docker.io/mariadb/maxscale:23.08.5
          ports:
            - containerPort: 4006
          volumeMounts:
            - name: config
              mountPath: /etc/maxscale.cnf
              subPath: maxscale.cnf
      volumes:
        - name: config
          configMap:
            name: maxscale-config
---
apiVersion: v1
kind: Service
metadata:
  name: maxscale
spec:
  selector:
    app: maxscale
  ports:
    - port: 4006
      targetPort: 4006

应用 JDBC 指向 maxscale:4006；backend primary/replica 写在 ConfigMap，拓扑变更后滚动重启或 REST API reload。

Latest tags (20)

View all 167 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/mariadb/maxscale
:latest
linux/amd64linux/arm64
2026/06/16 21:34431.2 MBsha256:a5614cf9632c…
docker.io/mariadb/maxscale
:24.02
linux/amd64linux/arm64
2026/06/16 21:34431.2 MBsha256:a5614cf9632c…
docker.io/mariadb/maxscale
:23.08
linux/amd64linux/arm64
2026/06/16 21:33437.5 MBsha256:02171471b943…
docker.io/mariadb/maxscale
:23.02
linux/amd64linux/arm64
2026/06/16 21:31430.1 MBsha256:8c7a0379fbfa…
docker.io/mariadb/maxscale
:24.02.9-ubi-2
linux/amd64linux/arm64
2026/06/02 20:28180.3 MBsha256:c53f7d88e46a…
docker.io/mariadb/maxscale
:23.08.13-ubi-2
linux/amd64linux/arm64
2026/06/02 20:23186.6 MBsha256:0bb010f95fe6…
docker.io/mariadb/maxscale
:24.02.9-ubi-1
linux/amd64linux/arm64
2026/05/19 00:01180.2 MBsha256:ae9168833423…
docker.io/mariadb/maxscale
:23.08.13-ubi-1
linux/amd64linux/arm64
2026/05/18 23:57186.5 MBsha256:e80db788fcc7…
docker.io/mariadb/maxscale
:24.02.9-2
linux/amd64linux/arm64
2026/05/18 23:32431.2 MBsha256:a5614cf9632c…
docker.io/mariadb/maxscale
:23.08.13-2
linux/amd64linux/arm64
2026/05/18 23:12437.5 MBsha256:02171471b943…
docker.io/mariadb/maxscale
:23.02.17-2
linux/amd64linux/arm64
2026/05/18 22:53430.1 MBsha256:8c7a0379fbfa…
docker.io/mariadb/maxscale
:22.08
linux/amd64linux/arm64
2026/05/18 21:47424.1 MBsha256:1a5d6d82886d…
docker.io/mariadb/maxscale
:22.08.19-3
linux/amd64linux/arm64
2026/05/18 21:47424.1 MBsha256:1a5d6d82886d…
docker.io/mariadb/maxscale
:24.02.9-1
linux/amd64linux/arm64
2026/03/31 14:32420.7 MBsha256:cd95e369926a…
docker.io/mariadb/maxscale
:23.08.13-1
linux/amd64linux/arm64
2026/03/30 23:51427.0 MBsha256:13ac710d6507…
docker.io/mariadb/maxscale
:23.02.17-1
linux/amd64linux/arm64
2026/03/30 21:47419.7 MBsha256:a1cccff99b2b…
docker.io/mariadb/maxscale
:22.08.19-2
linux/amd64linux/arm64
2026/03/30 21:17413.7 MBsha256:27f7c0641c0e…
docker.io/mariadb/maxscale
:21.06
linux/amd64linux/arm64
2026/03/30 20:09397.9 MBsha256:ffd066ce05f3…
docker.io/mariadb/maxscale
:21.06.21-2
linux/amd64linux/arm64
2026/03/30 20:08397.9 MBsha256:ffd066ce05f3…
docker.io/mariadb/maxscale
:25.10.2-trial
linux/amd64linux/arm64linux/ppc64le
2026/03/25 17:45342.2 MBsha256:d9a5c4f5fce2…