必须先创建存储桶、再上传文件、最后通过URL或SDK访问;创建时需全局唯一桶名、选地域、设权限;上传支持控制台或tosutil;公共读桶可直接复制URL访问,私有桶须用Python SDK生成签名URL或服务端直取。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在火山引擎上完成对象存储从创建到访问的全流程,必须先创建存储桶(Bucket),再上传文件,最后通过正确方式获取可公开访问的URL或使用SDK安全访问。跳过任一环节都会导致文件无法被正常读取。
创建存储桶
登录火山引擎控制台→进入「对象存储 TOS」服务→点击「创建存储桶」。
填写存储桶名称(【必须全局唯一,不能包含下划线、大写字母或中文】)、选择地域(如 cn-beijing)、设置访问权限为「公共读」(仅测试用,生产环境请选「私有」)、存储类型选「标准存储」。
点击确认创建,等待状态变为「运行中」即完成。
上传文件到存储桶
方法一:控制台直传
在存储桶列表中点击刚创建的桶→进入「文件管理」页→点击「上传文件」→选择本地文件→点击「开始上传」。
方法二:命令行工具(tosutil)
先安装 tosutil 工具,配置好 AK/SK 和 region;执行 tosutil cp ./local.jpg oss://your-bucket-name/photo/ → 上传成功后终端会显示 ETag 值。
【注意:若上传目录路径含中文或特殊字符(如空格、#、?),tosutil 会静默失败且不报错】
生成可访问的文件链接
第一步:确认文件已上传成功,且所在存储桶的访问权限为「公共读」。
第二步:在控制台文件列表中找到目标文件→点击右侧「更多」→选择「复制文件 URL」。
第三步:粘贴链接到浏览器访问,格式类似 https://your-bucket-name.oss-cn-beijing.volces.com/photo/local.jpg。
第四步:若返回 403 错误,请立即检查存储桶权限是否仍为「私有」,该权限修改不可逆,需重新设置并等待约 30 秒生效。
使用 Python SDK 安全访问私有文件
方法1:临时签名 URL(推荐用于前端直传或限时访问)
安装 volcengine:pip install volcengine;初始化 OssClient 后调用 generate_presigned_url('your-bucket', 'photo/local.jpg', expires_in=3600) 获取带签名的一小时有效链接。
方法2:服务端直取(适合后台逻辑)
调用 client.get_object('your-bucket', 'photo/local.jpg') 返回响应体,直接读取 response.read() 即可获得原始字节流。
【关键前提:AK/SK 必须具备该 Bucket 的 GetObject 权限,否则抛出 AccessDenied 异常】


















