文档目标:指导用户将指定ECS服务器上的图片文件夹,安全、完整地迁移至同账号下的阿里云对象存储(OSS)中。
前置条件:
您已经通过SSH方式登录到您的阿里云ECS服务器。
您已确认您的ECS服务器与目标OSS Bucket位于同一个阿里云账号下。
您已准备好阿里云账号的 AccessKey ID 和 AccessKey Secret(用于配置工具权限)。
第一步:下载与安装 ossutil 工具
下载安装脚本:
在SSH终端中,执行以下命令,下载官方的安装脚本,并将其命名为 ossutil-install.sh。使用 -O 参数可以避免因多次下载产生混乱的文件名。
wget -O ossutil-install.sh https://gosspublic.alicdn.com/ossutil/install.sh
安全审查(关键步骤):
在运行任何下载的脚本前,强烈建议先查看其内容,确认来源安全。
cat ossutil-install.sh
预期结果:您应该看到一段Shell脚本代码,其逻辑通常包括下载、解压和安装 ossutil。如果发现明显可疑或看不懂的命令,请立即停止并删除该文件。
确认无误后,进行下一步。
执行安装:
使用 bash 命令来执行安装脚本(这种方式无需修改文件权限,更安全)。
sudo bash ossutil-install.sh
成功标志:当终端显示 ossutil version: x.x.x has successfully installed. 的提示时,表示安装成功。
第二步:配置访问密钥
安装完成后,需要配置您的访问密钥,让 ossutil 获得操作您云资源的权限。
启动配置向导:
ossutil config
根据提示输入以下信息:
Please enter the config file name:直接按回车键,接受默认的配置文件路径 /root/.ossutilconfig。
Please enter language:输入 CH 并回车(选择中文界面,后续提示更友好),或直接回车保持默认英文。
Please enter Access Key ID:输入您的 AccessKey ID。可在阿里云控制台“访问控制 (RAM)” -> “用户” -> “创建AccessKey”中获取。
Please enter Access Key Secret:输入您的 AccessKey Secret。请注意保密,输入时不会显示字符。
Please enter Region:输入您的OSS Bucket所在地域的ID,例如 cn-beijing(北京)、cn-hangzhou(杭州)等。
Please enter Endpoint:直接按回车键跳过。工具会自动使用默认的外网Endpoint,但我们将在后续命令中手动指定更优的Endpoint。
Please enter stsToken:直接按回车键跳过。普通用户使用长期AccessKey,无需填写。

验证配置:
执行一个简单命令,测试配置是否成功。
ossutil ls oss://你的bucket名称 -e <内网Endpoint>
示例:ossutil ls oss://yb-jianzhan6 -e oss-cn-beijing-internal.aliyuncs.com
成功标志:如果能列出您Bucket中的文件或文件夹列表,说明配置成功。



第三步:执行图片迁移
这是核心步骤。为了获得最快的传输速度和免流量费,请务必使用内网Endpoint。
确认您的资源在同一地域(关键优化点):
请确认您的ECS服务器和OSS Bucket位于同一个地域(例如都在“华北2-北京”)。您可以在ECS和OSS的控制台概览页查看地域信息。


构建正确的迁移命令:
ossutil 的命令格式如下:
ossutil cp -r <服务器本地图片路径> oss://<Bucket名称>/<云端目标路径> -e <内网Endpoint>
参数说明:
-r:表示递归复制所有子文件夹和文件。
服务器本地图片路径:您要迁移的文件夹在ECS上的绝对路径。请根据您的实际情况修改。
Bucket名称:您的OSS Bucket名字,只包含小写字母、数字和短横线,例如 yb-jianzhan6。
云端目标路径:您希望文件在OSS中存放的路径。工具会自动创建不存在的文件夹。
-e:指定Endpoint。这里使用内网Endpoint,格式为 oss-<地域ID>-internal.aliyuncs.com。
执行迁移命令:
将以下命令中的路径和名称替换为您的实际信息,然后执行。
ossutil cp -r /www/wwwroot/你的网站目录/public/upload/2025/10/30 oss://你的bucket名称/upload/2025/10/30 -e oss-你的地域ID-internal.aliyuncs.com
实际案例(假设Bucket在北京,网站路径为示例):
ossutil cp -r /www/wwwroot/www.iyibai.com/public/upload/2025/10/30 oss://yb-jianzhan6/upload/2025/10/30 -e oss-cn-beijing-internal.aliyuncs.com
监控进度:
命令执行后,终端会实时显示传输进度、速度、剩余时间等信息。如果因网络波动中断,只需重新运行相同的命令,ossutil 会自动进行断点续传。
附录:常见问题与注意事项
关于 stsToken:配置过程中遇到 stsToken 提示,直接回车跳过即可,它仅用于临时授权场景。
为什么使用 -e 参数指定Endpoint:因为在 ossutil config 中我们跳过了Endpoint配置,以便在命令中灵活指定。使用 -e 参数让我们能充分利用内网传输的优势。
迁移大文件夹的建议:60GB的图片属于中等规模,此方法完全适用。如果遇到文件极多的情况,ossutil 的并发机制能有效提升速度。
验证迁移结果:完成后,可以登录OSS控制台,进入您的Bucket,检查 upload/2025/10/30/ 路径下的文件数量和大小,与服务器源文件夹进行比对,确保完整无误。