用途:Neon Object Storage 是 S3 兼容的对象存储,与 Neon 项目分支绑定。每个分支获得独立的写时复制存储状态,文件与数据库行随分支一起切换,适合已使用 Neon Postgres、希望文件与数据行跨环境保持一致的用户。
主要能力:兼容 S3 API,支持 AWS SDK、boto3、AWS CLI 和预签名 URL,仅支持路径式寻址和 SigV4;分支随数据库一起分叉,子分支继承父分支的桶和对象且不复制数据;提供 private 与 public_read 两种访问模式;与 Functions、AI Gateway 共用同一套 Neon 凭据系统。
使用方式:在 neon.ts 的 preview.buckets 中声明桶,例如 images 为私有、public-assets 设为 public_read,然后运行 neon deploy(即 neon config apply)创建。可用 neon config status/plan/apply 查看与协调配置。通过 neon env pull 或 neon-env run 获取注入的 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_ENDPOINT_URL_S3、AWS_REGION 等标准环境变量。推荐使用 Files SDK 的 neon 适配器(files-sdk/neon)进行 upload、download、url、list、exists、copy、delete、signedUploadUrl 等操作;也可直接用 AWS S3 客户端,但必须设置 forcePathStyle: true。
适用场景:需要文件与数据库行在同一分支上保持一致、希望用一套 Neon 凭据同时管理数据库与存储、需要可丢弃的预览或 CI 环境、以及希望沿用标准 S3 工具链的项目。
限制:该功能为预览(早期访问),仅适用于 us-east-2 区域的新项目,无法在现有项目上启用;未获得访问权限时需通过官方博客的私有测试注册入口申请。文档是权威来源且功能演进较快,使用前应核对官方文档。具体定价、配额等信息资料未提供。