云端存储配置

1创建 Bucket

1. 登录 阿里云 OSS 控制台
2. 点击 Bucket 列表 → 创建 Bucket
3. 区域:建议选离你最近的(如"华东1-杭州");记住这个区域,下面填 Endpoint 用
4. 读写权限:选 公共读(生成的图片需要直接通过 URL 访问)
5. Bucket 名称:全局唯一,3–63 位小写字母数字和短横线

2创建子账号和 AccessKey(推荐)

⚠️ 不要用主账号 AccessKey——主账号密钥泄露代价过大,务必创建只有 OSS 权限的 RAM 子账号。

1. 打开 RAM 访问控制 → 用户,创建用户,勾选 OpenAPI 调用访问
2. 创建完成后立即保存 AccessKey ID 和 Secret(Secret 只显示一次!)
3. 给这个用户添加权限:附加 AliyunOSSFullAccess(或更精细的自定义策略,只允许访问这一个 Bucket)

{
  "Version": "1",
  "Statement": [{
    "Effect": "Allow",
    "Action": ["oss:PutObject", "oss:GetObject", "oss:DeleteObject"],
    "Resource": ["acs:oss:*:*:apiyi/*"]
  }]
}

3配置 CORS 跨域规则(必须)

浏览器直接请求 OSS 需要 CORS 放行,否则请求会被浏览器拦截。

1. Bucket 详情页 → 数据安全 → 跨域设置 → 创建规则
2. 填写:
   • 来源:*(或填你的域名,如 https://yourdomain.com)
   • 允许 Methods:勾选 GET、PUT、DELETE、POST、HEAD
   • 允许 Headers:*
   • 暴露 Headers:ETag
   • 缓存时间:600

4填入本页表单

💡 常见 Endpoint:杭州 oss-cn-hangzhou、北京 oss-cn-beijing、上海 oss-cn-shanghai、深圳 oss-cn-shenzhen、香港 oss-cn-hongkong。后面加 .aliyuncs.com。

5测试连接

点击本页上方 测试连接,成功会提示 "OSS 连接成功"。失败时页面会显示错误码和 StringToSign 对比,按建议排查即可。