MySQL Router 是 InnoDB 集群的一部分,是一种轻量级中间件,可在应用程序与后端 MySQL 服务器之间提供透明路由。它可用于多种场景,例如通过有效地将数据库流量路由到适当的后端 MySQL 服务器来提供高可用性和可扩展性。其可插拔架构还使开发人员能够扩展 MySQL Router 以满足自定义需求。
镜像会在新的 MySQL Server 维护版本和开发里程碑发布时更新。请注意,非 GA 版本仅用于预览目的,不应在生产环境中使用。
当前镜像使用以下必填环境变量:
| 变量 | 描述 |
|---|---|
| MYSQL_HOST | 要连接的 MySQL 主机 |
| MYSQL_PORT | 要使用的端口 |
| MYSQL_USER | 用于连接的用户 |
| MYSQL_PASSWORD | 用于连接的密码 |
在容器中运行需要一个正常工作的 InnoDB 集群。
镜像使用以下可选环境变量:
| 变量 | 描述 |
|---|---|
| MYSQL_INNODB_CLUSTER_MEMBERS | 等待至少此数量的集群实例处于 ONLINE 状态 |
| MYSQL_CREATE_ROUTER_USER | 是否为 Router 创建新账户。默认为 1,设为 0 可禁用 |
如果提供了上述变量,运行脚本将等待指定的 MySQL 主机启动、InnoDB 集群具有 MYSQL_INNODB_CLUSTER_MEMBERS 数量的实例,然后使用指定的服务器进行引导模式(引导)。
可通过以下命令运行镜像:
docker run -e MYSQL_HOST=localhost -e MYSQL_PORT=3306 -e MYSQL_USER=mysql -e MYSQL_PASSWORD=mysql -e MYSQL_INNODB_CLUSTER_MEMBERS=3 -ti mysql/mysql-router
可通过以下命令验证:
docker ps
应显示类似以下输出:
4954b1c80be1 mysql-router:8.0 "/run.sh mysqlrouter" About a minute ago Up About a minute (healthy) 6447/tcp, 6448/tcp, 0.0.0.0:6446->6446/tcp, 6449/tcp innodbcluster_mysql-router_1
MySQL Router 容器暴露以下 TCP 端口:
| 端口 | 描述 |
|---|---|
| 6446 | 读写(R/W)连接端口。连接到此端口的客户端将被转发到 PRIMARY |
| 6447 | 只读(R/O)连接端口。连接到此端口的客户端将被转发到 SECONDARY |
| 6448 | X 协议读写(R/W)连接端口。用于 X 协议客户端连接的读写端口 |
| 6449 | X 协议只读(R/O)连接端口。用于 X 协议客户端连接的只读端口 |
| 8443 | HTTPS REST 接口端口 |
有关 REST 接口 API 的更多信息,请参见:
[***]
有关完整使用文档,请参见:
[***]
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务