Traefik 不处理 PHP 与 MySQL 连接，仅负责 HTTP 路由；PHP 容器需通过容器网络（同 Docker 网络、用服务名 mysql 作主机）访问 MySQL 容器，并确保 MySQL 配置 bind-address=0.0.0.0 且用户授权 'user'@'%'。
traefik 本身不处理 PHP 与 MySQL 的连接
很多人搜 traefik php mysql 连接不上，其实是混淆了职责边界：traefik 是反向代理/网关，只管 HTTP 流量路由，它不参与、也不配置 PHP 应用怎么连 MySQL。真正要查的是你的 PHP 容器（比如 php:8.2-apache）能否从容器网络访问 MySQL 容器（比如 mysql:8.0），而 traefik 只负责把外部请求转给 PHP 容器。
PHP 容器连不上 MySQL 的常见原因和检查点
典型现象是 PHP 报错：PDOException: SQLSTATE[HY000] [2002] Connection refused 或 mysqli_connect(): (HY000/2002): Connection refused。重点看这几点：
- MySQL 容器是否真的在运行？用
docker ps确认状态，不是Exited - PHP 和 MySQL 是否在同一个 Docker 网络里？
docker network inspect your-network-name查看两者是否共属一个Containers列表 - PHP 代码里写的 MySQL 主机名是不是容器名（如
mysql），而不是localhost或127.0.0.1—— 容器内localhost指自己，不是 MySQL 容器 - MySQL 是否允许远程连接？默认只监听
127.0.0.1；需在my.cnf中设bind-address = 0.0.0.0，或用 Docker 启动参数--bind-address=0.0.0.0 - MySQL 用户是否授权给对应主机？比如创建用户时用了
'user'@'localhost'，但 PHP 容器 IP 不是 localhost，应改用'user'@'%'并执行FLUSH PRIVILEGES;
docker-compose.yml 中的关键配置示例
下面是最小可行的三件套（traefik + php + mysql）网络配置要点，注意注释部分：
minimax-mcp-docker版（适配极空间）
下载
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
version: '3.8'
services:
traefik:
image: traefik:v2.10
command:
- "--providers.docker=true"
- "--entrypoints.web.address=:80"
ports:
- "80:80"
volumes:
- "/var/run/docker.sock:/var/run/docker.sock:ro"
<p>php:
image: php:8.2-apache
depends_on:</p><ul><li>mysql
environment:</li><li>MYSQL_HOST=mysql # ← 必须填 MySQL 容器名，不是 localhost</li><li>MYSQL_USER=appuser</li><li>MYSQL_PASSWORD=appsecret</li><li>MYSQL_DB=appdb
labels:</li><li>"traefik.http.routers.php.rule=Host(<code>localhost</code>)"
networks:</li><li>appnet</li></ul><p>mysql:
image: mysql:8.0
environment:</p><ul><li>MYSQL_ROOT_PASSWORD=rootpass</li><li>MYSQL_DATABASE=appdb</li><li>MYSQL_USER=appuser</li><li>MYSQL_PASSWORD=appsecret
command: --default-authentication-plugin=mysql_native_password --bind-address=0.0.0.0
networks:</li><li>appnet<h1>← 不要暴露 3306 给宿主机，除非真需要本地客户端连；容器间通信走内部网络即可</h1></li></ul><p>networks:
appnet:
driver: bridge</p>验证连接是否通的最快办法
别急着改代码，先进 PHP 容器手动测试连通性：
立即学习“PHP免费学习笔记（深入）”；
- 进容器：
docker exec -it <php-container-name> sh - 装个客户端（如果没自带）：
apk add mysql-client（Alpine）或apt-get update && apt-get install -y mysql-client（Debian） - 直连测试：
mysql -h mysql -u appuser -pappsecret appdb -e "SELECT 1"—— 这里-h mysql是关键，必须用服务名 - 如果这步失败，说明网络或 MySQL 配置有问题；成功了再查 PHP 代码里的
new PDO(...)参数是否一致
最容易被忽略的是：MySQL 容器日志里有没有报错？用 docker logs <mysql-container-name> 看是否启动失败、密码错误、或权限拒绝。很多“连不上”其实 MySQL 根本没起来。
