tuyoogame 阿里云 OSS 管理
通过 aliyun-oss-cli 命令行工具管理阿里云 OSS 存储桶中的文件：上传、列出、预览、签名、删除。
前置条件
- 已安装
aliyun-oss-cli（Rust 编译的二进制），源码及文档见 https://github.com/tuyoogame/aliyun-oss-cli.rs - 已配置
~/.aliyun-oss-cli/config.yaml或通过环境变量设置凭证
安装
git clone https://github.com/tuyoogame/aliyun-oss-cli.rs.git
cd aliyun-oss-cli.rs
./build.sh
编译产物在 build/ 目录下，将二进制放入 $PATH 即可使用。
初始化配置
aliyun-oss-cli init
生成 ~/.aliyun-oss-cli/config.yaml，编辑填入 endpoint、access-key、secret-key、bucket。
配置格式
扁平格式（单配置）：
endpoint: "oss-cn-hangzhou.aliyuncs.com"
access-key: "your-access-key-id"
secret-key: "your-access-key-secret"
bucket: "your-bucket-name"
多 profile 格式（多环境，用 --profile 切换）：
default:
endpoint: "oss-cn-hangzhou.aliyuncs.com"
access-key: "..."
secret-key: "..."
bucket: "bucket-a"
beijing:
endpoint: "oss-cn-beijing.aliyuncs.com"
access-key: "..."
secret-key: "..."
bucket: "bucket-b"
配置优先级
命令行参数 > 环境变量 > 配置文件
环境变量：ALIYUN_OSS_ENDPOINT、ALIYUN_OSS_ACCESS_KEY、ALIYUN_OSS_SECRET_KEY、ALIYUN_OSS_BUCKET
命令速查
| 命令 | 用途 | 风险等级 |
|---|---|---|
init |
初始化配置文件 | write |
ls |
列出文件 | read |
upload |
上传文件/目录 | write |
preview |
图片预览（签名链接） | read |
sign |
生成签名访问链接 | read |
delete |
删除文件 | destructive |
使用方法
列出文件
aliyun-oss-cli ls # 根目录
aliyun-oss-cli ls images/ # 指定前缀
aliyun-oss-cli ls -l # 详细模式（大小+时间）
aliyun-oss-cli ls --max-keys 50 # 限制返回数量
aliyun-oss-cli ls --profile beijing # 使用指定 profile
上传文件
aliyun-oss-cli upload myfile.jpg # 上传单文件
aliyun-oss-cli upload myfile.jpg images/ # 上传到指定目录
aliyun-oss-cli upload myfolder/ -d # 上传整个目录
aliyun-oss-cli upload myfile.jpg -p assets/ # 指定前缀
aliyun-oss-cli upload myfile.jpg --public # 公共读权限
aliyun-oss-cli upload myfile.jpg -r # 覆盖已存在文件
| 选项 | 短选项 | 说明 |
|---|---|---|
DESTINATION |
- | 位置参数，目标路径 |
--dir |
-d |
上传目录模式 |
--prefix |
-p |
目标路径前缀 |
--public |
- | 公共读 ACL |
--replace |
-r |
覆盖已存在文件 |
预览图片
aliyun-oss-cli preview myimage.jpg # 生成签名链接（24h 有效）
aliyun-oss-cli preview myimage.jpg -o # 浏览器打开
aliyun-oss-cli preview myimage.jpg --expire 3600 # 1 小时有效
生成签名链接
aliyun-oss-cli sign myfile.txt # 下载签名链接（24h）
aliyun-oss-cli sign myfile.txt -u # 上传签名链接
aliyun-oss-cli sign myfile.txt -e 3600 # 1 小时有效
删除文件
aliyun-oss-cli delete myfile.jpg # 删除单文件（需确认）
aliyun-oss-cli delete file1.jpg file2.png # 批量删除
aliyun-oss-cli delete myfile.jpg -q # 静默模式，跳过确认
安全约束
- 删除操作前必须确认：除非用户明确要求，禁止使用
-q跳过确认 - 禁止在日志或输出中暴露 access-key / secret-key
- 上传公共读文件（
--public）前需向用户确认，避免意外公开敏感文件 - 操作多个文件时先
ls确认目标，再执行写/删操作
常见场景
上传构建产物到 OSS
aliyun-oss-cli upload dist/ -d -p releases/v1.0.0/ --profile default
生成临时分享链接
aliyun-oss-cli sign docs/report.pdf -e 7200
清理过期文件
aliyun-oss-cli ls old-prefix/ -l
aliyun-oss-cli delete old-prefix/file1.txt old-prefix/file2.txt