toughiq/maxscale

docker-maxscale

Docker化的MaxScale镜像，专为Galera集群后端设计，可与https://github.com/toughIQ/docker-mariadb-cluster%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%E3%80%82

分支与标签

镜像提供两个分支，分别对应MaxScale1和MaxScale2版本。由于MaxScale1可免费使用，MaxScale2部分场景需MariaDB许可，当前master分支默认使用1.4.5版本。

运行

基础运行（3节点配置）

bash
docker run -d -p 3306:3306 -p 3307:3307 \
    --name maxscale \
    -e BACKEND_SERVER_LIST="db01.myserver db02.myserver db03.myserver" \
    -e MAX_PASS="myMaxScalePassword" \
    toughiq/maxscale

使用docker-compose

修改docker-compose.yml中的参数后启动：

bash
docker-compose up -d

构建镜像

bash
docker build -t toughiq/maxscale .

自定义静态镜像

可构建包含个人配置的静态镜像（注意：勿推送到公共仓库，避免泄露凭据）：

示例Dockerfile

dockerfile
FROM toughiq/maxscale
MAINTAINER yourname@domain.com
ENV MAX_PASS="yourMaxScalePassword" \
    MAX_THREADS=2 \
    ENABLE_ROOT_USER=1 \ 
    SPLITTER_PORT=4407 \
    ROUTER_PORT=4408 \
    BACKEND_SERVER_LIST="maria01.db maria02.db maria03.db" \
    BACKEND_SERVER_PORT="3306" \
    USE_SQL_VARIABLES_IN="all"

构建并运行：

bash
docker build -t mymaxscale .
docker run -d -p 3306:4407 -p 3307:4408 mymaxscale

环境变量默认值

• MAX_THREADS=4：MaxScale运行线程数
• MAX_USER="maxscale"：集群中的MaxScale用户
• MAX_PASS="maxscalepass"：MaxScale用户密码（需自定义）
• ENABLE_ROOT_USER=0：是否允许root通过MaxScale访问数据库（0/1）
• SPLITTER_PORT=3306：读写分离服务暴露端口
• ROUTER_PORT=3307：读连接路由服务暴露端口
• ROUTER_OPTIONS="synced"：路由选项（支持master/slave/synced等）
• CLI_PORT=6603：MaxScale CLI端口
• CONNECTION_TIMEOUT=600：连接超时（秒）
• BACKEND_SERVER_LIST="server1 server2 server3"：后端服务器列表（需自定义）
• BACKEND_SERVER_PORT="3306"：后端服务器端口

Docker Swarm服务发现

若后端服务运行在Docker Swarm中，可通过服务名自动发现节点：

bash
docker service create --name maxscale \
    --network myDBnet \
    --env DB_SERVICE_NAME=my_db_service \
    toughiq/maxscale

镜像会通过内部DNS查询生成maxscale.cnf配置。