关键是要明确数据库位置、打通网络通路、配对访问参数：容器不可用localhost访问宿主机数据库，应使用host.docker.internal（docker desktop）或宿主机ip（linux），数据库需监听0.0.0.0并开放防火墙端口，连接参数须通过环境变量注入，跨容器通信推荐自定义网络+容器名。
要让 Docker 容器连接到指定的数据库实例，关键不是“改容器”，而是明确数据库位置、打通网络通路、配对访问参数。不同场景下方法略有差异，但逻辑一致。
确认数据库实例的可访问地址
容器无法用 localhost 或 127.0.0.1 访问宿主机上的数据库，因为这是容器自己的回环地址。你需要用真实可达的 IP 或 DNS 名：
- 若数据库在宿主机上（如开发环境）：
- Docker Desktop 用户：直接用 host.docker.internal
- Linux 环境用户：查宿主机局域网 IP（如 ip addr | grep "inet " | grep -v "127.0.0.1"），常用类似 192.168.x.x 或 172.17.0.1
- 若数据库在另一台服务器或云服务上：填该机器的公网/内网 IP 或域名（如 db-prod.example.com:3306）
- 若数据库也在 Docker 容器中（同机部署）：推荐用 自定义网络 + 容器名（如 mysql-db:3306），而非 IP
确保数据库监听并放行连接
光有地址还不够，数据库服务本身必须允许外部连接：
- 检查数据库配置文件（如 MySQL 的 my.cnf）是否设为 bind-address = 0.0.0.0（或具体网卡 IP），而非仅 127.0.0.1
- 确认数据库用户权限支持远程登录（例如 MySQL 执行：GRANT ALL ON *.* TO 'user'@'%' IDENTIFIED BY 'pass'; FLUSH PRIVILEGES;）
- 宿主机防火墙需开放对应端口（如 3306、5432），Linux 常用：sudo ufw allow 3306 或 sudo firewall-cmd --add-port=3306/tcp --permanent
在容器中正确传入连接参数
应用代码读取的是环境变量或配置文件，不是硬编码 localhost。推荐通过 docker-compose.yml 或 docker run 注入：
- 使用环境变量（最常见）：
environment: - DB_HOST=host.docker.internal - DB_PORT=3306 - DB_USER=root - DB_PASS=secret
- Linux 下若用 IP 需额外加 extra_hosts（Docker Desktop 不需要）：
extra_hosts: - "host.docker.internal:host-gateway"
- 如果数据库也在 Docker 中，且共用自定义网络：
networks: - mynet services: app: networks: - mynet mysql-db: networks: - mynet应用中直接写 DB_HOST=mysql-db 即可
验证连接是否生效
别等应用启动失败才排查，提前验证更高效：
- 进容器执行简单测试（以 MySQL 为例）：
docker exec -it your-app-container sh apk add mysql-client # Alpine # 或 apt-get update && apt-get install mysql-client -y # Debian/Ubuntu mysql -h host.docker.internal -P 3306 -u root -p
- 观察容器日志：docker logs your-app-container，看是否有 “connection refused”、“timeout” 或认证失败提示
- 从宿主机 telnet 测试连通性：telnet 192.168.1.100 3306（成功表示网络层通，失败则先查防火墙或数据库监听）
