当您需要将本地文件、图片、视频等资源上传到OSS，或者需要上传大文件至OSS时，可以使用ossutil的cp命令。您也可以指定--include和--exclude选项，批量上传符合指定条件的文件。命令格式./ossutil64 cp file_url cloud_url [-r, --recursive] [-f --force] [-u --update] [--maxupspeed <value>] [--enable-symlink-dir] [--disable-all-symlink] [--disable-ignore-error] [--only-current-dir] [--bigfile-threshold <value>] [--part-size <value>] [--checkpoint-dir <value>] [--encoding-type <value>] [--include <value>] [--exclude <value>] [--meta <value>] [--acl <value>] [--snapshot-path <value>] [--disable-crc64] [--disable-dir-object] [--payer <value>] [--tagging <value>] [-j, --job <value>] [--parallel <value>] [--start-time <value>] [--end-time <value>]参数及选项说明如下：配置项说明file_url本地文件路径。例如Linux系统文件路径/localfolder/examplefile.txt，Windows系统文件路径D:\localfolder\examplefile.txt。cloud_urlOSS文件路径。格式为oss://bucketname/objectname。例如oss://examplebucket/examplefile.txt。-r, --recursive递归操作。当指定该选项时，ossutil会对Bucket下所有符合条件的Object进行操作，否则只对指定的单个Object进行操作。-f --force强制操作，不进行询问提示。-u，--update只有当目标文件不存在，或源文件的最后修改时间晚于目标文件时，ossutil才会执行上传操作。--maxupspeed最大上传速度，单位为KB/s。默认值为0，表示不限制上传速度。--enable-symlink-dir上传链接子目录，默认不上传。--disable-all-symlink上传时忽略所有的软链接子文件以及软链接子目录。--disable-ignore-error批量操作时不忽略错误。--only-current-dir仅上传当前目录下的文件，忽略子目录及子目录下的文件。--bigfile-threshold设置断点续传文件的大小阈值，单位为字节。默认值：100 MB取值范围：0~9223372036854775807--part-size设置分片大小，单位为字节。默认情况下ossutil会根据文件大小自行计算合适的分片大小值。取值范围：1~9223372036854775807--checkpoint-dir指定断点续传记录信息所在的目录。断点续传操作失败时，ossutil会自动创建名为.ossutil_checkpoint的目录，并在该目录下记录checkpoint信息，断点续传成功后会删除该目录。如果指定了该选项，请确保指定的目录可以被删除。--encoding-type文件名称的编码方式。取值为url。如果不指定该选项，则表示文件名称未经过编码。--include包含符合指定条件的所有文件。语法规范和使用示例，请参见批量上传符合条件的文件。--exclude不包含任何符合指定条件的文件。语法规范和使用示例，请参见批量上传符合条件的文件。--meta文件的元数据。包括部分HTTP标准属性（HTTP Header）以及以x-oss-meta-开头的用户自定义元数据（User Meta）。文件元数据格式为header:value#header:value，示例为Cache-Control:no-cache#Content-Encoding:gzip。有关OSS支持元数据的更多介绍，请参见管理文件元数据。--acl文件的读写权限ACL。取值如下：default（默认值）：继承Bucket的读写权限。private：只有该Bucket的拥有者可以对该Bucket内的文件进行读写操作，其他人无法访问该Bucket内的文件。public-read：只有Bucket拥有者可以对该Bucket内的文件进行写操作，其他用户（包括匿名访问者）都可以对该Bucket中的文件进行读操作。这有可能造成您数据的外泄以及费用激增，如果被人恶意写入违法信息还可能会侵害您的合法权益。除特殊场景外，不建议您配置此权限。public-read-write：任何人（包括匿名访问者）都可以对该Bucket内文件进行读写操作。这有可能造成您数据的外泄以及费用激增，请谨慎操作。--snapshot-path指定保存上传文件时的快照信息所在的目录。在下一次上传文件时，ossutil会读取指定目录下的快照信息进行增量上传。--disable-crc64关闭CRC64数据校验。默认情况下，ossutil进行数据传输时都会打开CRC64校验。--disable-dir-object表示上传文件时不为目录生成Object。--payer请求的支付方式。如果希望访问指定路径下的资源产生的流量、请求次数等费用由请求者支付，请将此选项的值设置为requester。--tagging上传文件时设置标签信息，格式为TagkeyA=TagvalueA&TagkeyB=TagvalueB....。-j，--jobs多文件操作时的并发任务数，默认值为3，取值范围为1~10000。--parallel单文件操作时的并发任务数，取值范围为1~10000。 如果不设置此选项，默认由ossutil根据操作类型和文件大小自行决定。--start-timeUnix时间戳。如果输入这个选项，最后更新时间早于该时间的Object会被忽略。--end-timeUnix时间戳。如果使用该选项，则最后更新时间晚于通过此选项指定时间的Object会被忽略。从以上命令格式中的-j，--jobs和--parallel选项得知，当ossutil自行设置的默认并发数达不到用户的性能要求时，您可以自行调整这两个选项来升降性能。默认情况下，ossutil会根据文件大小来计算parallel个数。当批量上传大文件时，实际的并发数为jobs个数乘以parallel个数。当ECS虚拟机或者服务器在网络、内存、CPU等资源不是特别大的情况下，建议将并发数调整到100以下。如果网络、内存、CPU等资源没有占满，可以适当增加并发数。由于线程间资源切换及抢夺等原因，如果并发数过大，ossutil上传性能可能会下降。此外，并发数过大还可能产生EOF错误。所以请根据实际的机器情况调整-j，--jobs和--parallel选项的数值。如果要进行压测，可在一开始时调低这两项数值，然后逐渐调大直至找到最优值。示例环境本文以Linux系统为例，将本地文件或文件夹上传至OSS中。您在实际使用中，请根据您的系统和使用环境修改对应参数。本文涉及的通用示例说明如下：本地文件：examplefile.txt（根目录下的文件）本地文件夹：localfolder（根目录下的文件夹）目标Bucket：examplebucket目标Bucket指定目录：desfolder简单上传当您需要将本地文件、图片、视频等资源上传到OSS，可以使用ossutil，示例如下：上传单个文件 上传文件时，如果不指定上传至OSS的文件名，则默认使用原文件名进行保存；如果指定文件名，则按照指定的文件名保存在OSS中。./ossutil64 cp examplefile.txt oss://examplebucket/desfolder/仅上传文件夹内的文件 上传文件夹内的文件并指定时间戳将本地文件夹内的文件上传到OSS指定路径，文件修改时间限定在北京时间2023年10月31日10:09:18至2023年10月31日12:55:58内。./ossutil64 cp -r localfolder/ oss://examplebucket/desfolder/ --start-time 1698718158 --end-time 1698728158上传文件夹及文件夹内的文件使用cp命令时增加-r选项，并在OSS指定路径下添加本地文件夹名称，可以将本地文件夹以及文件夹内的文件上传到OSS指定路径。 对于文件夹内的文件夹，OSS会对应创建0 KB大小、以正斜线（/）结尾的Object；对于指定的文件夹，OSS不会创建对应的Object。如果您需要创建对应的Object，您可以使用mkdir（创建目录）。./ossutil64 cp -r localfolder/ oss://examplebucket/desfolder/localfolder/上传单个文件并指定--meta选项 上传文件夹并跳过已有文件 批量上传失败重传时，可以指定--update（可缩写为-u）选项跳过已经上传成功的文件，实现增量上传。示例如下：./ossutil64 cp -r localfolder/ oss://examplebucket/desfolder/ -u上传文件到开通了请求者付费模式的Bucket ./ossutil64 cp localfolder/examplefile.txt oss://examplebucket/ --payer=requester仅上传当前目录下的文件，忽略子目录 ./ossutil64 cp localfolder/ oss://examplebucket/desfolder/ --only-current-dir -r上传时不为目录生成Object OSS的目录是用一个0 KB大小，名称以正斜线（/）结尾的Object模拟的。上传时增加--disable-dir-object参数，ossutil不会为该目录生成Object，但您仍可以在OSS控制台看到对应的目录结构。当您删除目录内的文件时，该目录也会消失。./ossutil64 cp localfolder/ oss://examplebucket/desfolder/ --disable-dir-object -r上传软链接子目录下的文件 ./ossutil64 cp localfolder/ oss://examplebucket/desfolder/ --enable-symlink-dir -r上传时忽略所有的软链接子文件以及软链接子目录 ./ossutil64 cp localfolder/ oss://examplebucket/desfolder/ -r --disable-all-symlink上传时限速上传并设置对象标签关于对象标签的更多说明请参见object-tagging（对象标签）。上传并指定存储类型您可以在上传文件时，通过--meta选项设置文件存储类型。存储类型可选值为：Standard：标准存储IA：低频访问Archive：归档存储ColdArchive：冷归档存储DeepColdArchive：深度冷归档存储如果上传时未指定存储类型，则以存储空间的存储类型为准。更多信息，请参见存储类型概述。上传并指定存储类型的示例如下：上传单个文件并指定存储类型为低频访问类型 ./ossutil64 cp examplefile.txt oss://examplebucket/desfolder/ --meta X-oss-Storage-Class:IA上传文件夹并指定存储类型为标准存储类型 ./ossutil64 cp localfolder/ oss://examplebucket/desfolder/ --meta X-oss-Storage-Class:Standard -r上传并指定读写权限ACL上传并指定加密方式上传文件并指定加密方式为OSS完全托管，加密算法为AES256./ossutil64 cp examplefile.txt oss://examplebucket/desfolder/ --meta=x-oss-server-side-encryption:AES256上传文件并指定加密方式为OSS完全托管，加密算法为SM4./ossutil64 cp examplefile.txt oss://examplebucket/desfolder/ --meta=x-oss-server-side-encryption:SM4上传文件并指定加密方式为KMS，指定加密算法为AES256，不指定CMK ID./ossutil64 cp examplefile.txt oss://examplebucket/desfolder/ --meta=x-oss-server-side-encryption:KMS使用KMS加密时，会产生少量KMS密钥使用费用，详情请参见KMS计费标准。上传文件并指定加密方式为KMS，指定加密算法为SM4，指定CMK ID./ossutil64 cp examplefile.txt oss://examplebucket/desfolder/ --meta=x-oss-server-side-encryption:KMS#x-oss-server-side-data-encryption:SM4#x-oss-server-side-encryption-key-id:7bd6e2fe-cd0e-483e-acb0-f4b9e1******有关服务器端加密功能介绍，请参见服务器端加密。上传并生成快照批量上传符合条件的文件批量上传时，如果指定--include和--exclude选项，ossutil会批量上传符合指定条件的文件。通用选项当您需要通过命令行工具ossutil切换至另一个地域的Bucket时，可以通过-e选项指定该Bucket所属的Endpoint。当您需要通过命令行工具ossutil切换至另一个阿里云账号下的Bucket时，可以通过-i选项指定该账号的AccessKey ID，并通过-k选项指定该账号的AccessKey Secret。关于此命令的其他通用选项的更多信息，请参见通用选项。