在 coolify 中让 laravel 应用连接同一网络内的 mysql,核心做法是将数据库服务部署在同一 coolify 实例或同一 docker 网络下,并在 laravel 的 .env 文件中配置对应的内部主机名。通常直接使用 coolify 自动生成的服务名称(如 mysql)作为 db_host,配合默认端口 3306 即可连通。若使用外部自建 mysql,需确保其加入 coolify 管理的网络或使用 host.docker.internal(视环境而定),但推荐统一由 coolify 管理以保证网络互通。

Coolify 自动生成的服务间如何通信
当 MySQL 和 Laravel 均由 Coolify 部署时,它们默认处于同一个 Docker 网络中。Laravel 容器可以通过服务名称直接解析 IP。无需修改防火墙或暴露端口,只需在 Laravel 的环境变量中指向服务名。

DB_CONNECTION=mysql DB_HOST=mysql DB_PORT=3306 DB_DATABASE=your_database DB_USERNAME=your_username DB_PASSWORD=your_password
上述配置中,DB_HOST=mysql 是关键。Coolify 会为每个资源分配一个唯一的标识符,通常在内部 DNS 中注册为服务名。如果 Coolify 生成的服务名包含项目前缀(例如 project-mysql),则需使用完整的服务名。验证连通性可在 Laravel 容器中执行 ping mysql 或 telnet mysql 3306。
外部 MySQL 如何接入 Coolify 网络
若 MySQL 不在 Coolify 中管理,而是独立服务器或本地数据库,需将其纳入 Coolify 的网络体系。Coolify 允许将现有资源添加为“Server”或“Database”,并自动处理网络路由。对于本地开发或外部云数据库,可使用 Coolify 提供的内部网关 IP 或服务发现机制。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。

# 假设外部 MySQL IP 为 192.168.1.100 DB_CONNECTION=mysql DB_HOST=192.168.1.100 DB_PORT=3306 DB_DATABASE=external_db DB_USERNAME=root DB_PASSWORD=external_pass
在此场景下,需确保 Coolify 所在服务器能访问该 IP,且 MySQL 允许远程连接。若使用 Docker Desktop 或特定虚拟化环境,可能需要使用 host.docker.internal 代替具体 IP。建议在 Coolify 界面中添加该数据库资源,以便统一管理密钥和网络策略。
Laravel 环境变量未生效导致连接失败
即使配置正确,若 Laravel 未重新加载环境变量,仍会连接失败。Coolify 在部署时会注入环境变量,但若手动修改 .env 而未触发重新部署,缓存可能导致旧配置生效。此时需检查 php artisan config:clear 是否执行,或确认 Coolify 的“Deploy”按钮已点击以刷新容器。










