用途:在 Zeabur 上部署 S3 兼容对象存储(MinIO 或 RustFS),并把应用或本地工具接入该存储。
主要能力:通过 npx zeabur@latest 调用 Zeabur CLI 搜索并部署存储模板;查询服务网络与变量列表以获取连接信息;给出 MinIO、RustFS 的凭据变量、内网端点、公网域名绑定方式,以及 Node.js、Python、Go 的 S3 SDK 配置示例。
使用方式:部署前须先加载 zeabur-template 技能了解模板机制。搜索模板示例:npx zeabur@latest template search minio -i=false --json,选择部署量最高的模板。未指定时默认 MinIO;需要轻量或明确提到 RustFS 时推荐 RustFS。部署后用 npx zeabur@latest service network --id <storage-service-id> -i=false 查看内网主机名与端口,用 npx zeabur@latest variable list --id <storage-service-id> -i=false 获取访问密钥。同项目应用通过环境变量接入,S3 端点需按内网主机名硬编码(如 http://minio.zeabur.internal:9000)。本地访问需为 API 端口绑定域名,再用 mc 或 aws CLI 连接。
适用场景:需要为 Zeabur 上的应用提供 S3 兼容存储、文件上传或对象管理能力。
限制与注意:S3 SDK 必须设置 forcePathStyle: true,否则会出现 bucket not found;RustFS 初始无 bucket,需先创建;S3 端点不是模板变量,需手动填写;变量引用在 CLI 中存在 ${} 展开问题,建议在 Dashboard 设置;MinIO API 端口 9000、控制台 9090,RustFS API 9000、控制台 9001。