TOS Bucket名称必须全局唯一且严格遵循命名规则:①仅小写字母、数字、短横线;②字母或数字开头结尾;③3–63字符;④非IP格式;⑤无连续短横线;⑥不以短横线起止。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

火山引擎对象存储(TOS)中创建 Bucket 时,名称必须全局唯一且符合严格命名规则,否则创建失败或后续无法正常使用 SDK/API 访问。
Bucket 命名基本规则
第一步:打开火山引擎控制台 → 进入「对象存储 TOS」→ 点击「创建 Bucket」。
第二步:在「Bucket 名称」输入框中,填写满足以下全部条件的字符串:
① 只能包含小写字母、数字、短横线(-);
② 必须以字母或数字开头和结尾;
③ 长度为 3~63 个字符;
④ 不能使用 IP 地址格式(如 192.168.0.1);
⑤ 不能包含两个连续的短横线(--);
⑥ 不能以短横线开头或结尾。
第三步:输入后系统会实时校验,绿色对勾表示合规,红色叉号提示具体错误原因。例如输入 my-bucket-2026 合规,而 -mybucket、my..bucket、MyBucket 均会被拒绝。
命名避坑要点
避免使用与已有公共域名冲突的名称,例如 www、cdn、api 等前缀可能被系统拦截——这不是报错提示,而是创建后无法通过虚拟主机式(Virtual Host)访问,【会导致所有 S3 兼容 SDK 默认连接失败】。
不要用下划线(_)或大写字母,哪怕控制台前端没报错,后端服务在解析 endpoint 时会直接拒绝请求,错误码为 InvalidBucketName。
命名一旦确认创建,【无法修改】,只能删除重建。
推荐命名方式
方法一:项目缩写 + 环境 + 序号,例如 prod-logs-01、dev-images-02。
方法二:公司名拼音首字母 + 业务模块 + 区域,例如 vl-userdata-sh(vl = volcengine,sh = 上海地域)。
方法三:日期戳 + 用途,例如 202608-backup,但需确保不超 63 字符且不含非法符号。

















