dbscale/proxysql

ProxySQL Docker镜像文档

镜像概述

ProxySQL是一款轻量级、高性能的数据库中间件，专为MySQL设计，具备数据库协议感知能力。作为代理层，它位于应用与MySQL数据库之间，能够智能管理数据库流量，实现负载均衡、读写分离、故障转移等核心功能，从而提升MySQL集群的可用性、性能和安全性。该Docker镜像封装了ProxySQL的核心功能，便于快速部署和集成到各类MySQL环境中。

核心功能与特性

• 协议感知：深度理解MySQL协议，支持完整的MySQL客户端交互，包括事务、存储过程等复杂操作
• 负载均衡：支持多种负载均衡算法（轮询、权重、最小连接数等），分发读/写请求至后端MySQL节点
• 读写分离：根据SQL语句类型自动路由读请求至从库，写请求至主库，优化资源利用
• 故障检测：内置健康检查机制，自动发现并隔离故障节点，保障服务连续性
• 查询缓存：缓存频繁执行的查询结果，减少数据库重复计算，提升响应速度
• 动态配置：支持通过管理接口实时修改配置，无需重启服务，适应动态变化的集群环境
• 流量控制：提供连接池管理、查询限流等功能，防止数据库过载

使用场景

• MySQL主从架构：实现读写分离，提高读操作吞吐量
• MySQL集群环境：如Percona XtraDB Cluster、Galera Cluster等，实现负载均衡和高可用
• 高并发读写场景：通过连接池和查询缓存优化数据库性能
• 多环境隔离：在开发、测试、生产环境中统一代理配置，简化环境管理
• 数据库迁移过渡：在数据库版本升级或迁移过程中作为中间层，实现平滑过渡

使用方法

基本运行命令

bash
docker run -d \
  --name proxysql \
  -p 6032:6032 \  # 管理接口端口
  -p 6033:6033 \  # MySQL客户端连接端口
  proxysql/proxysql

端口说明

环境变量配置

常用环境变量及说明：

示例：指定后端MySQL节点

bash
docker run -d \
  --name proxysql \
  -p 6032:6032 -p 6033:6033 \
  -e MYSQL_HOST=mysql-master \
  -e MYSQL_PORT=3306 \
  -e MYSQL_USER=proxyuser \
  -e MYSQL_PASSWORD=proxypass \
  proxysql/proxysql

配置文件挂载

ProxySQL的核心配置通过配置文件（proxysql.cnf）管理，可通过挂载本地配置文件实现自定义配置：

bash
docker run -d \
  --name proxysql \
  -p 6032:6032 -p 6033:6033 \
  -v /path/to/local/proxysql.cnf:/etc/proxysql.cnf \
  proxysql/proxysql

docker-compose示例

yaml
version: '3'
services:
  proxysql:
    image: proxysql/proxysql
    container_name: proxysql
    ports:
      - "6032:6032"
      - "6033:6033"
    environment:
      - ADMIN_USER=admin
      - ADMIN_PASSWORD=secureadmin
      - MYSQL_HOST=mysql-master
      - MYSQL_PORT=3306
      - MYSQL_USER=proxyuser
      - MYSQL_PASSWORD=proxypass
    volumes:
      - proxysql_data:/var/lib/proxysql  # 持久化ProxySQL数据
    restart: unless-stopped

volumes:
  proxysql_data:

管理接口使用

通过MySQL客户端连接管理接口进行配置：

bash
mysql -u admin -padmin -h 127.0.0.1 -P 6032 --prompt 'ProxySQL Admin> '

在管理接口中可执行SQL语句配置后端节点、路由规则等，例如添加后端MySQL节点：

sql
INSERT INTO mysql_servers (hostgroup_id, hostname, port, weight) VALUES (1, 'mysql-master', 3306, 10);
INSERT INTO mysql_servers (hostgroup_id, hostname, port, weight) VALUES (2, 'mysql-slave1', 3306, 5);
LOAD MYSQL SERVERS TO RUNTIME;
SAVE MYSQL SERVERS TO DISK;

注意事项

• 首次启动需通过管理接口或配置文件设置后端MySQL节点，否则ProxySQL无法路由请求
• 生产环境建议持久化/var/lib/proxysql目录，保存配置和运行时数据
• 定期备份配置文件，避免配置丢失
• 根据实际负载调整连接池大小、查询缓存策略等参数以优化性能