coolify 通过内置的备份机制支持 mysql 定时备份，核心做法是在 coolify 面板中为应用配置 backup 设置并启用 schedule。你需要进入应用的 settings 页面，找到 backup 部分，选择备份目标（如 s3 或本地），然后开启定时任务开关并设置 cron 表达式。coolify 会基于此计划自动执行数据库转储，并将备份文件存储到指定的远程位置。
如何配置备份的目标存储路径？
在 Coolify 中配置 MySQL 备份时，必须指定一个有效的存储驱动，目前主要支持 S3 兼容存储和服务器本地存储。若选择 S3，需提前在 Coolify 的 Resources 中创建对应的 S3 Bucket 资源，并在应用备份设置中关联该资源。若选择 Local，备份将保存在 Coolify 服务器的 /var/www/html/storage/app/backups 目录下（具体路径可能随版本略有差异，但通常由系统管理）。配置完成后，Coolify 会在每次触发备份时将生成的 .sql.gz 文件上传至该目标。
curl -X POST "http://localhost/api/v1/instances" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"type": "s3",
"name": "my-backup-bucket",
"region": "us-east-1",
"bucket": "coolify-backups",
"access_key": "YOUR_ACCESS_KEY",
"secret_key": "YOUR_SECRET_KEY"
}'
上述代码展示了如何通过 API 创建一个 S3 类型的备份存储资源。在实际操作中，你可以通过 Coolify 的 Web UI 更直观地完成此步骤：进入左侧菜单的 "Resources" - "Storage"，点击 "Create"，选择 "S3"，填入相应的 Access Key、Secret Key、Bucket Name 和 Region。创建成功后，回到你的 MySQL 应用设置页，在 Backup 部分的 "Backup Destination" 下拉菜单中选择刚创建的 "my-backup-bucket"。这样，后续的定时备份就会自动流向该 S3 桶。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
如何验证备份是否成功执行？
验证 Coolify 的 MySQL 定时备份是否成功，最直接的方法是检查备份历史记录和存储目标中的文件。在 Coolify 面板中，进入对应 MySQL 应用的 "Backups" 标签页，这里会列出所有已执行的备份记录，包括开始时间、结束时间、大小以及状态（Success/Failed）。如果状态显示为 Success，说明备份流程已完成。此外，你可以登录到配置的 S3 控制台或查看服务器本地备份目录，确认是否存在以时间戳命名的 .sql.gz 文件。若备份失败，Coolify 会在 "Backups" 页面标记为 Failed，并提供错误日志链接，通常涉及网络连通性、权限不足或磁盘空间满等问题。
# 在 Coolify 服务器上检查本地备份目录 ls -lh /var/www/html/storage/app/backups/ # 或者通过 Docker 命令查看最近的备份容器日志 docker logs coolify-worker --tail 50 | grep backup
以上命令可用于手动验证备份文件的生成情况。第一个命令列出本地备份目录下的文件，确认是否有新产生的 .sql.gz 文件及其大小是否合理。第二个命令查看 Coolify 工作节点的日志，过滤出与 backup 相关的最近 50 行输出，这有助于排查自动化任务执行时的潜在错误。结合面板上的 "Backups" 页面信息，可以全面确认定时备份任务的运行状态。
如果备份任务失败，常见的排查步骤是什么？
当 Coolify 的 MySQL 定时备份任务失败时，首要步骤是查看应用 "Backups" 页面中对应失败记录的详细错误日志。常见原因包括：1. 存储目标不可达：如果是 S3 备份，检查 Access Key、Secret Key 是否正确，Bucket 是否存在且权限配置无误；2. 网络问题：Coolify 服务器无法连接到外部存储服务或内部 MySQL 服务端口异常；3. 磁盘空间不足：服务器本地存储空间已满，导致无法写入临时备份文件或上传数据；4. 数据库负载过高：在业务高峰期，MySQL 可能因锁表或性能瓶颈导致备份超时。针对这些情况，建议先检查存储资源的连接测试功能（如有），再监控服务器资源使用情况，最后调整备份计划避开业务高峰时段。
