Skip to content

Coolify 提供将您的实例自动备份到 AWS S3 存储桶的功能,为您提供一种无需手动操作、可靠的方式来保护您的配置和数据。

为什么在 Coolify 中使用 AWS S3?

  1. 企业级耐用性和可用性: S3 设计具有 99.999999999% 的耐用性,并在多个设施之间自动复制,确保您的备份始终安全且可访问。

  2. 经济高效的按使用付费定价: 只需为您实际使用的存储和请求付费,通过内置的生命周期规则(例如,过渡到 Glacier)优化长期成本。

  3. 无缝集成 - Coolify 的备份调度程序直接连接到 S3 的 API,无需自定义脚本或第三方工具,确保备份按计划运行。

何时避免在 Coolify 中使用 AWS S3?

  1. 严格的数据驻留或本地部署要求: 如果您的法规要求备份完全保存在私有数据中心内,S3 的公共云模型可能不符合要求。

  2. 无外部网络访问: 在禁止出站互联网访问的环境中,Coolify 无法将快照推送到 S3 端点。


示例数据

本指南中使用以下数据作为示例。请在按照步骤操作时替换为您的实际数据:


快速概览(点击查看)
  1. 在 AWS 控制台中创建存储桶
  2. 在 AWS 控制台中创建具有以下权限的自定义策略:
json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:ListBucket",
        "s3:GetObject",
        "s3:DeleteObject",
        "s3:GetObjectAcl",
        "s3:PutObjectAcl",
        "s3:PutObject"
      ],
      "Resource": [
        // 在此处将 your-bucket-name 替换为您的存储桶名称
        "arn:aws:s3:::your-bucket-name",
        "arn:aws:s3:::your-bucket-name/*"
      ]
    }
  ]
}
  1. 在 AWS 控制台中创建 IAM 用户并附加上一步的策略。
  2. 进入用户设置并在 AWS 控制台中创建一个 Access Key
  3. 在 Coolify 中创建新的 S3 源时添加 Access KeySecret Key

    提示

    您需要使用不带存储桶名称的 S3 HTTP 端点,例如 https://s3.eu-central-1.amazonaws.com

1. 创建 S3 存储桶

要创建您的 S3 存储桶,请按照以下步骤操作:

访问 https://console.aws.amazon.com/s3 并点击 创建存储桶 按钮

系统会要求您选择名称、对象所有权等。

注意

其他所有选项保持默认值,仅在您知道自己在做什么的情况下才进行更改。



点击 创建存储桶 按钮

存储桶创建完成后,您将被重定向到以下页面:

2. 创建 IAM 策略

要创建您的 IAM 策略,请按照以下步骤操作:

访问 https://console.aws.amazon.com/iam/home#/policies 并点击 创建策略 按钮


  • 点击 JSON 选项并将以下代码复制粘贴到策略编辑器中
json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:ListBucket",
        "s3:GetObject",
        "s3:DeleteObject",
        "s3:GetObjectAcl",
        "s3:PutObjectAcl",
        "s3:PutObject"
      ],
      "Resource": [
        // 在下面两行将 envix-coolify-backups-s3 替换为您的存储桶名称
        "arn:aws:s3:::envix-coolify-backups-s3",
        "arn:aws:s3:::envix-coolify-backups-s3/*"
      ]
    }
  ]
}

向下滚动到页面底部,然后点击 继续 按钮。

然后系统会要求您为策略选择名称:

输入名称后,向下滚动到页面底部,然后点击 继续 按钮。

策略创建完成后,您将被重定向到以下页面:

提示

您不会看到刚刚创建的策略,必须在搜索框中搜索其名称。

3. 创建 IAM 用户

要创建您的 IAM 用户,请按照以下步骤操作:

访问 https://console.aws.amazon.com/iam/home#/users 并点击 创建用户 按钮

系统会要求您为用户选择名称:

  • 输入用户名后点击 下一步 按钮。
  1. 选择直接附加策略选项
  2. 选择我们在上一步创建的策略
  3. 点击 下一步 按钮
  • 点击 创建用户 按钮(此页面无需更改任何内容)

策略创建完成后,您将被重定向到以下页面:

  • 点击用户名将创建访问密钥。

4. 创建访问密钥

在上一步点击用户名后,您将被重定向到以下页面:

  • 点击 创建访问密钥 选项以设置新的访问密钥。
  • 选择 其他 选项,然后点击 继续 按钮
  • 点击 创建访问密钥 按钮。
  • 将访问密钥和秘密访问密钥保存在安全的地方,然后点击 完成 按钮

注意

点击 完成 按钮后,您将无法再次查看访问密钥,因此请确保将密钥保存在安全的地方。

5. 在 Coolify 中设置 S3

要在 Coolify 中设置 S3,请按照以下步骤操作:

在您的 Coolify 仪表板中:

  1. 转到侧边栏中的 存储 部分。
  2. 点击 添加 按钮
  1. 为 S3 存储命名(可以是任意名称)
  2. 为存储添加简短描述(可选)
  3. 输入不带存储桶名称的端点:https://s3.YOUR_REGION_NAME.amazonaws.com
  4. 输入您创建的 S3 存储桶名称。
  5. 输入您的 S3 存储桶区域
  6. 输入您的访问密钥
  7. 输入您的秘密访问密钥
  8. 点击 验证连接并继续 按钮

存储桶验证通过后,您将被重定向到以下页面:

然后转到设置页面并点击备份


  1. 启用 S3
  2. 选择您的 S3 存储
  3. 选择备份频率(如果您不熟悉 cron,可以使用此 网站
  4. 设置备份保留策略
  5. 点击立即备份按钮(只是为了检查一切是否正常工作)

您可以从执行日志中查看存储在 S3 上的备份:

现在您已完成所有设置!您的 Coolify 实例已配置为自动备份并将其安全地存储在您的 AWS S3 存储桶中。