跳到主要内容
孤云
语言 简体 繁體 English

AWS S3

大约 10 分钟，建桶与建密钥都不收费，就能在 AWS S3 上给孤云准备好一个桶和一对访问密钥（费用只在实际存储、请求与外网流量上）。

需要一个 AWS 账号（要绑一张支持国际支付的信用卡）；控制台语言可以在右上角切换。

分步操作

  1. 第 1 步

    注册 AWS 账号

    • 打开 AWS 官网 注册账号：注册时要绑一张支持国际支付的信用卡；已有账号就跳过这一步。

  2. 第 2 步

    创建存储桶

    • 打开 S3 控制台 →「创建存储桶」（Create bucket），桶名要全球唯一：3–63 位，只能用英文小写字母、数字、短横线与点，首尾必须是字母或数字。
    • 选一个离你近的区域（例如 us-east-1、ap-southeast-1）。如果「创建存储桶」一直转圈、桶建不出来，把右上角的区域换成「亚太地区（新加坡）ap-southeast-1」再试 —— 个别区域的 S3 地址在有些网络（例如中国大陆）下不可达，换个区域就好（孤云连的也是这个区域地址）。
    • 「存储桶命名空间」（Bucket namespace）保持默认的全局命名空间（Global namespace）；「阻止公共访问」（Block all public access）保持开启，Object Ownership 与其余选项保持默认，最后点「创建存储桶」。

  3. 第 3 步

    创建 IAM 用户并取访问密钥

    • 打开 IAM 控制台 →「用户」（Users）→「创建用户」（Create user）：只填用户名，不要给它控制台登录密码。
    • 打开这个用户 →「安全凭证」（Security credentials）→「创建访问密钥」（Create access key），用途选「其他」（Other）；中间那个「描述标签」可以留空（要填只能用字母、数字、空格与 _ . : / = + - @，括号会被拒）：Access key ID 与 Secret access key 只显示一次，立刻下载存好。不要用根账号（root）的访问密钥。

  4. 第 4 步

    给这个用户挂最小权限策略

    • 在这个用户的页面点「权限」（Permissions）→「添加权限」（Add permissions）→「创建内联策略」（Create inline policy），切到 JSON。
    • 粘贴下面那段，把 your-bucket-name 换成你的桶名（两处），保存。

  5. 第 5 步

    回孤云填三个值并测试

    • 孤云「添加存储」→ 服务商选 AWS S3，选好地点，按下面那张表填桶名、端点与密钥。
    • 再点「测试连接并保存」。

这个用户要的最小权限策略

在 IAM 里创建内联策略时切到 JSON，粘贴这段：

json 
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:ListBucket", "s3:GetBucketLocation", "s3:ListBucketMultipartUploads"],
      "Resource": "arn:aws:s3:::your-bucket-name"
    },
    {
      "Effect": "Allow",
      "Action": ["s3:GetObject", "s3:PutObject", "s3:DeleteObject", "s3:AbortMultipartUpload", "s3:ListMultipartUploadParts"],
      "Resource": "arn:aws:s3:::your-bucket-name/*"
    }
  ]
}

把里面的 your-bucket-name 换成真实桶名（两处）。不要把资源范围缩窄到某个目录 —— 孤云要在 .guyun/ 前缀下写回收站清单、设备连接记录与跨设备交接记录。

其他情况（用不到可以跳过）

控制台地址：https://console.aws.amazon.com/s3/（IAM：https://console.aws.amazon.com/iam/）。

AWS 中国区是另一套

  • 全球区（aws.amazon.com）与中国区（amazonaws.cn）账号不通用，中国区要求以中国实体注册；本页讲的是全球区，桶也要放在全球区。

地点与端点

  • 选好地点后 Endpoint 已自动填好；如果你的桶用特殊端点，可在 HTTPS Endpoint 里就地修改。
  • 端点只写主机名，不带桶名与路径。

费用与账号安全

  • 按用量计费：存储、请求与外网流量分别计费。
  • AWS 在 2025 年调整过新账号的免费额度规则，以官网为准。
  • 建议给根账号开启 MFA，日常别用根账号的访问密钥（这次建的 IAM 用户只授权这一个桶）。

官方来源

抄下这三个值

它们要填进孤云「添加存储」页对应的格子： 地点：在 App 里选与你桶所在区域对应的那一项（例如 us-east-1、ap-southeast-1；列表里有 21 个常用区域） —— 选好地点，地域与 HTTPS Endpoint 会自动填好。

抄下这个值填进孤云的哪一格
桶名
你刚才建的桶名，例如 your-bucket-name。		桶名称
端点
https://s3.<区域>.amazonaws.com，例如 https://s3.ap-southeast-1.amazonaws.com。		Endpoint
密钥
刚才那个 IAM 用户的 Access key ID 与 Secret access key。		Access key ID 与 Secret access key

怎么知道成了

  • 「测试连接并保存」通过，说明这对密钥能读到这个桶；孤云只读根目录，不会改动桶里的东西。
  • 之后这条存储会出现在孤云的存储列表里，可以打开看桶里的文件。
  • 连接报错时，到常见错误对照排查。

回到孤云，点「测试连接并保存」。