Alpine的mysql-client默认走socket连接且依赖/var/run/mysqld目录，但client-only环境无mysqld进程和该目录，故报socket错误；连远程库需显式指定-h、装ca-certificates、处理DNS及SSL配置。
直接用 apk add mysql-client 就能跑起来，但不加配置会报 Can't connect to local MySQL server through socket —— 这不是连不上数据库，而是客户端默认找 /var/run/mysqld/mysqld.sock，而 Alpine 里压根没这个目录、也没 mysqld 进程。
为什么 mysql-client 在 Alpine 上不能直接连远程库？
Alpine 的 mysql-client 包（来自 mariadb-connector-c）本身是可用的，但它依赖运行时解析 host 和 socket 路径。常见错误包括：
- 执行
mysql -h 10.0.2.100 -P 3306 -u root -p却卡住或报错Host 'xxx' is not allowed to connect—— 实际是 DNS 解析失败，因为 Alpine 默认没开getaddrinfo的 IPv6 fallback，且/etc/nsswitch.conf缺失 - 未指定
-h时走 socket 连接，但/var/run/mysqld/不存在，导致报 socket 错误 - 某些老版本
mysql-client（如 Alpine 3.6 自带的）不支持 TLS 1.3，连启用了现代加密的 MySQL 8.0+ 服务端会直接拒绝
构建最小可行客户端镜像的 Dockerfile 关键点
目标是「只装 client、不带服务、能稳定连任意远程 MySQL」。推荐基于 alpine:3.18（LTS 版本，musl 和 openssl 兼容性好）：
- 必须显式安装
ca-certificates：否则 HTTPS 域名解析和 TLS 握手会失败，mysql -h db.example.com直接报SSL connection error - 加一行
RUN mkdir -p /var/run/mysqld：避免无意义的 socket 报错干扰调试 - 用
apk add --no-cache mysql-client ca-certificates，不装mysql（那是服务端）、不装mariadb-connector-c-dev（开发头文件，运行时不需要） - ENTRYPOINT 设为
["mysql"]可省略命令输入，但要提醒用户：所有参数都得通过docker run传入，比如docker run myclient -h db -u root -p
示例精简版 Dockerfile：
FROM alpine:3.18 RUN apk add --no-cache mysql-client ca-certificates \ && mkdir -p /var/run/mysqld ENTRYPOINT ["mysql"]
连接远程 MySQL 时必须传的参数和常见陷阱
Alpine 的 mysql 客户端行为和 Ubuntu/CentOS 上略有差异，关键在于：
-
-h必须显式指定，哪怕连127.0.0.1—— 省略就走 socket，而 socket 路径在 client-only 镜像里无效 - 如果目标 MySQL 启用了
require_secure_transport=ON，必须加--ssl-mode=REQUIRED，否则连接被拒（Alpine 默认不启用 SSL，即使证书存在） - 遇到
Unknown MySQL server host，先检查是否漏了ca-certificates或 DNS 配置；可在容器内运行nslookup db-host测试（需额外装bind-tools） - 密码含特殊字符（如
@、/）时，建议用-p交互式输入，避免 shell 解析错误
真正轻量的核心不在“少装几个包”，而在理解 musl libc 下的网络栈行为和 client-only 场景的约束 —— 比如你永远不该指望它自动读取 ~/.my.cnf（home 目录不存在），也不该假设 localhost 等价于 127.0.0.1（Alpine 默认禁用 IPv6 localhost 解析）。这些细节不处理，镜像再小也连不上库。
