文档中心

对象存储

图片处理

原图保护

原图保护

原图保护功能是对图片的一种保护措施，用于防止原图被匿名用户盗用。开启原图保护后，匿名用户将不能直接通过 URL 访问图片，只能通过携带图片样式参数的 URL 或预签名 URL 访问图片。本文介绍原图保护的功能和操作步骤。

功能说明

开启原图保护后，匿名用户可以通过以下方式访问图片：

使用携带图片样式参数的 URL 访问图片，格式为 https://<存储桶的名称>.<Endpoint>/<图片的名称>?x-tos-process=style/<样式的名称>。关于图片样式的介绍，请参见使用图片样式。

使用预签名 URL 访问图片，格式为 https://<存储桶的名称>.<Endpoint>/<图片的名称>?<签名>。关于预签名的介绍，请参见预签名概述。

操作步骤

登录对象存储控制台。

在左侧导航栏，单击桶列表，在桶列表页面单击目标桶名称。

在左侧导航栏，选择数据处理 > 图片处理。

在图片处理页面，单击原图保护页签，然后单击编辑。

在原图保护页签下，设置如下参数。

参数	说明
当前状态	设置是否开启原图保护功能。
原图保护后缀	选择需要使用原图保护功能的图片后缀，设置完成后，存储桶中所有匹配原图保护后缀的图片都会被保护。说明如下：支持选择、png、jpg、jpeg、gif、bmp 、tiff、heic、webp。选择时，原图保护功能将应用到桶内所有对象，包含图片及非图片类型对象。支持选择多个后缀。
自定义分隔符	自定义分隔符可以代替图片样式参数（?x-tos-process=style/），简化图片 URL。支持四种分隔符：短横线（-）、下划线（_）、正斜线（/）和感叹号（!）。例如携带图片样式参数的 URL 为 https://test.tos-cn-beijing.volces.com/abc.jpg?x-tos-process=style/test，设置自定义分隔符为短横线（-）后，您可以直接使用 https://test.tos-cn-beijing.volces.com/abc.jpg-test 访问图片。
后缀	设置自定义分隔符后，搭配后缀功能处理图片时，会默认为图片名称添加后缀，即使用 URL 处理图片时，无需设置完整的图片名称，可以简化图片 URL。例如自定义分隔符为 - ，使用 test 样式处理名称为 fast_a.jpg 的图片，设置后缀为 _a.jpg后，您可以直接使用 https://test.tos-cn-beijing.volces.com/fast-test 处理图片。如果您使用 https://test.tos-cn-beijing.volces.com/fast_a.jpg-test 处理图片，则实际处理图片的名称是fast_a.jpg_a.jpg，如果不存在 fast_a.jpg_a.jpg 图片，则会报错。注意一个存储桶仅支持设置一个后缀，后缀长度必须小于 1024。设置自定义分隔符后，才可以设置后缀。使用图片样式参数的 URL（例如 https://test.tos-cn-beijing.volces.com/abc.jpg?x-tos-process=style/test）处理图片时，后缀无效。设置后缀后，只要使用自定义分隔符的样式处理图片，都默认会在图片名称后加上后缀。您需要确保存储桶中存在图片名称加上后缀后的对象，否则处理图片时会报错 NoSuchKey。

单击确定。

最近更新时间：2026.07.07 16:36:20

这个页面对您有帮助吗？

有用

有用

无用

无用