用于文件和上传的对象存储。
项目的 S3 兼容存储:如何添加存储桶、应用获得的 S3_* 变量,以及存储和操作的计费方式。
对象存储将文件保存在应用之外:用户上传的文件、生成的报表、媒体文件、您自己的备份。它兼容所有支持 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 兼容存储或您服务器文件夹中的文件,可以迁入存储桶——一次性迁移,或逐步迁移且不中断服务。请参阅将文件迁入对象存储。
删除存储桶
删除存储桶 会删除其中的所有文件;文件无法恢复,其变量也会从项目中移除。账户所有者和应用的管理员可以删除存储桶。