zapier/proxysql

ProxySQL Docker镜像

ProxySQL Docker镜像，由Zapier提供，支持以下特性：

• 实时配置更新
• 从环境变量渲染配置模板中的敏感数据

镜像地址：https://hub.docker.com/r/zapier/proxysql

镜像概述与主要用途

该镜像基于ProxySQL构建，是一款高性能的MySQL数据库代理工具，主要用于数据库读写分离、负载均衡、故障转移及查询路由。通过支持实时配置更新和环境变量渲染敏感数据，可灵活适应动态环境需求，简化配置管理流程。

核心功能与特性

• 实时配置更新：支持配置文件的动态刷新，无需重启服务即可应用新配置
• 敏感数据渲染：从环境变量中读取敏感信息（如密码、地址等）并注入配置模板，避免配置文件中硬编码敏感数据
• 灵活的配置模板：支持自定义配置模板，通过变量占位符动态生成ProxySQL配置文件
• 完整的ProxySQL功能：包含ProxySQL的全部核心功能，如连接池管理、查询规则、服务器分组等

使用场景与适用范围

• MySQL数据库集群的代理与负载均衡
• 需要动态调整数据库路由规则的场景
• 对敏感配置信息有安全管理需求的环境
• 容器化部署的数据库代理服务

使用方法与配置说明

配置模板（proxysql.cnf.tpl）

创建配置模板文件，使用变量占位符（如${VARIABLE_NAME}）定义需要从环境变量注入的配置项。示例如下：

datadir="/var/lib/proxysql"

admin_variables=
{
        admin_credentials="${PROXYSQL_ADMIN_USERNAME}:${PROXYSQL_ADMIN_PASSWORD}"
        mysql_ifaces="${PROXYSQL_ADMIN_HOST}:${PROXYSQL_ADMIN_PORT}"
        refresh_interval=2000
}

mysql_variables=
{
        threads=${PROXYSQL_MYSQL_THREADS}
        max_connections=2048
        default_query_delay=0
        default_query_timeout=36000000
        have_compress=true
        poll_timeout=2000
        interfaces="${PROXYSQL_MYSQL_INTERFACES}"
        default_schema="information_schema"
        stacksize=${PROXYSQL_MYSQL_STACKSIZE}
        server_version="5.7"
        connect_timeout_server=10000
        monitor_history=60000
        monitor_connect_interval=200000
        monitor_ping_interval=200000
        ping_interval_server_msec=10000
        ping_timeout_server=200
        commands_stats=true
        sessions_sort=true
        autocommit_false_is_transaction=true
        init_connect="SET SESSION TX_ISOLATION='READ-COMMITTED'"
        monitor_username="${proxysql_monitor_username}"
        monitor_password="${proxysql_monitor_password}"
        enforce_autocommit_on_reads=true
        free_connections_pct=100
}

mysql_servers =
(
        { address="${db1_host}" , port=${db1_port} , hostgroup=10, max_connections=10 },
        { address="${db2_host}" , port=${db2_port} , hostgroup=20, max_connections=10 }
)

mysql_users =
(
        { username = "${db1_username}" , password = "${db1_password}" , default_hostgroup = 10 , active = 1 },
        { username = "${db2_username}" , password = "${db2_password}" , default_hostgroup = 20 , active = 1 }
)

mysql_query_rules =
(
        {
                rule_id=100
                active=1
                proxy_port=6033
                destination_hostgroup=10
                apply=1
                username="${db1_username}"
        },
        {
                rule_id=200
                active=1
                proxy_port=6033
                destination_hostgroup=20
                apply=1
                username="${db2_username}"
        }
)

敏感信息文件（secrets.env）

创建包含敏感配置的环境变量文件，可通过本地文件、Docker secrets或Kubernetes secrets等方式加载。示例如下：

db1_host=db1.example.com
db1_port=3306
db1_username=db1
db1_password=password
db2_host=db2.example.com
db2_port=3306
db2_username=db2
db2_password=password
proxysql_monitor_username=root
proxysql_monitor_password=root

运行命令

通过docker run命令启动容器，挂载配置模板和敏感信息文件，并设置必要的环境变量：

docker run -ti --name proxysql \
-v secrets.env:/proxysql/secrets/secrets.env \
-v ./proxysql.cnf.tpl:/proxysql/conf/proxysql.cnf.tpl \
-e PROXYSQL_CONF_CHECK_INTERVAL=15 \
-e PROXYSQL_CONF_LIVE_RELOAD=true \
-e PROXYSQL_ADMIN_PASSWORD=somepassword \
-e PROXYSQL_MYSQL_THREADS=6 \
-p 16032:6032 \
-p 16033:6033 \
zapier/proxysql:latest

环境变量说明