立即开始

用于文件和上传的对象存储。

项目的 S3 兼容存储:如何添加存储桶、应用获得的 S3_* 变量,以及存储和操作的计费方式。

1 分钟阅读

对象存储将文件保存在应用之外:用户上传的文件、生成的报表、媒体文件、您自己的备份。它兼容所有支持 S3 协议 的库和工具——AWS SDK、Laravel 的 s3 磁盘、django-storages、boto3、rclone 等等。

添加存储

在应用的 概览 → 服务 → 对象存储 → 添加存储 中操作。为存储桶命名——使用小写拉丁字母、数字和短横线,以字母开头——然后确认。存储桶片刻即可就绪。

一个项目最多可有 3 个存储桶。

应用获得的变量

访问信息会自动添加到项目变量中;应用在下一次部署时读取:

变量说明
S3_ENDPOINT存储地址
S3_REGION在 S3 客户端中使用的区域
S3_BUCKET存储桶名称
S3_KEY访问密钥
S3_SECRET私密密钥

该密钥 仅适用于此存储桶。项目的第二个存储桶,其变量名前会加上存储桶名称:<NAME>_S3_ENDPOINT、<NAME>_S3_BUCKET 等。

您自己的同名变量会保持不变——适用于应用的部分功能需要继续使用其他存储的情况。请参阅环境变量。

示例:Laravel

在 config/filesystems.php 中,将 s3 磁盘指向这些变量:

's3' => [
    'driver' => 's3',
    'key' => env('S3_KEY'),
    'secret' => env('S3_SECRET'),
    'region' => env('S3_REGION'),
    'bucket' => env('S3_BUCKET'),
    'endpoint' => env('S3_ENDPOINT'),
    'use_path_style_endpoint' => true,
],

然后在 变量 标签页中设置 FILESYSTEM_DISK=s3。

示例:Node.js

import { S3Client } from '@aws-sdk/client-s3'
 
const s3 = new S3Client({
  endpoint: process.env.S3_ENDPOINT,
  region: process.env.S3_REGION,
  credentials: { accessKeyId: process.env.S3_KEY, secretAccessKey: process.env.S3_SECRET },
})

价格

价格
存储每 GB 每月 US$0.025
流量免费——从存储下载不收费
写入每百万次操作 US$6
读取每百万次操作 US$0.50

存储量每天计量一次并按月平均,因此保存半个月的文件只收取一半费用。一个自然月的用量作为一行计入项目的下一次付款;无需单独订阅。

迁入文件

已存放在 Amazon S3、Google Cloud Storage、其他 S3 兼容存储或您服务器文件夹中的文件,可以迁入存储桶——一次性迁移,或逐步迁移且不中断服务。请参阅将文件迁入对象存储。

删除存储桶

删除存储桶 会删除其中的所有文件;文件无法恢复,其变量也会从项目中移除。账户所有者和应用的管理员可以删除存储桶。

还有疑问?

和我们聊聊——AI 即时回答,需要时工程师加入,全天候在线。

联系技术支持