在火山引擎控制台上传文件至TOS桶需先创建并进入目标桶,注意选择“公共读”策略以支持CDN回源和Flink消费;支持单文件上传、拖拽上传、文件夹上传及tosutil命令行方式;上传后须验证文件状态、URL生成及HTTP 200访问。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在火山引擎控制台中将本地文件上传至对象存储(TOS)桶,是管理静态资源、部署镜像或同步业务数据的第一步。这一步操作本身不复杂,但若忽略桶策略或网络条件,可能上传失败或后续无法被CDN回源、AI链路消费。
创建并进入目标存储桶
登录火山引擎控制台 → 在顶部导航栏选择「产品服务」→「对象存储 TOS」→ 进入「桶列表」页面 → 单击已创建的桶名称(如未创建,请先点击「创建桶」,桶名称建议用英文小写+数字组合,避免特殊字符)。
⚠️ 注意:若该桶用于CDN回源或Flink实时消费,必须在创建时选择「公共读」策略;私有桶会导致CDN回源403、TOS-CDC无法拉取对象元信息。
上传单个文件
在桶内「文件列表」页,点击右上角「上传文件」按钮 → 点击「选择文件」,从本地选取目标文件(如 AR6700V-L_V600R024C00SPC100_VolcEngineX8664.qcow2 或 20220908-1.txt)→ 点击「上传」。
上传进度条消失且文件出现在列表中,即表示成功。此时可单击文件名右侧「详情」查看URL,该URL将用于注册镜像、配置CDN源站或构造Flink CDC路径。
批量上传多个文件
方法一:拖拽上传
直接将多个文件(或整个文件夹)拖入「上传文件」弹窗区域,系统自动识别并排队上传。此方式适合上传 5~20 个中小文件(单个 ≤50MB),浏览器兼容性好,无需额外插件。
方法二:使用「上传文件夹」功能
点击「上传文件」→ 切换到「上传文件夹」标签 → 点击「选择文件夹」→ 选中含多个待传文件的本地目录 → 点击「上传」。【注意:该功能仅支持 Chrome / Edge 最新版,Firefox 和 Safari 不支持】
方法三:命令行辅助(适用于大文件或自动化场景)
若上传文件 >100MB 或需定时同步,不建议依赖控制台。应改用火山引擎官方 CLI 工具 tosutil,执行 tosutil cp -r ./local_dir/ tos://your-bucket-name/,规避浏览器并发限制与内存溢出风险。
验证上传结果
第一步:检查文件列表是否显示新文件,状态为「正常」;
第二步:单击文件名 → 查看「详情」页中的「访问URL」是否生成且可直连(若为私有桶则URL含临时签名,此处不校验);
第三步:打开浏览器,粘贴该URL访问(仅限「公共读」桶),确认返回 HTTP 200 及预期内容(如文本文件显示“v1”,镜像文件返回二进制头信息)。
若第三步失败,立即返回桶设置页检查「桶策略」是否仍为「公共读」——控制台有时会在修改其他配置时意外重置此项。

















