ossutil npm package / ossutil npm 包

阿里云ossutil 2.0的npm统一入口，自动下载并运行对应平台的ossutil工具。

Alibaba Cloud ossutil 2.0 unified npm entry point - automatically downloads and runs the appropriate ossutil binary for your platform.

特性 / Features

• 🚀 开箱即用 / Ready to Use: 无需手动下载和安装，一条命令即可运行 / No manual download or installation required, run with a single command
• 🔄 自动检测 / Auto Detection: 自动识别你的操作系统和架构，使用对应的ossutil版本 / Automatically detects your OS and architecture, uses the corresponding ossutil version
• 💾 无需网络 / No Network Required: 所有平台二进制文件已包含在npm包中，无需网络下载 / All platform binaries included in the npm package, no network download needed
• 🌍 跨平台 / Cross-Platform: 支持Windows、Linux、macOS三大平台 / Supports Windows, Linux, and macOS
• 📦 最新版本 / Latest Version: 当前使用ossutil 2.3.0版本 / Currently using ossutil version 2.3.0

安装和使用 / Installation & Usage

直接使用npx（推荐）/ Use npx directly (Recommended)

npx ossutil version

全局安装 / Global Installation

npm install -g ossutil
ossutil version

常用命令 / Common Commands

# 查看版本信息 / Show version
npx ossutil version

# 配置ossutil / Configure ossutil
npx ossutil config

# 列出bucket / List buckets
npx ossutil ls

# 上传文件 / Upload file
npx ossutil cp file.txt oss://bucket/path/

# 下载文件 / Download file
npx ossutil cp oss://bucket/path/file.txt ./

支持的平台 / Supported Platforms

• Windows (x86 32bit, x86 64bit)
• macOS (x86 64bit, ARM 64bit)
• Linux (x86 32bit, x86 64bit, ARM 32bit, ARM 64bit)

工作原理 / How It Works

1. 当你运行 npx ossutil 时，npm会自动下载这个包 / When you run npx ossutil, npm automatically downloads this package
2. 包会检测你的操作系统和架构 / The package detects your operating system and architecture
3. 自动选择并运行对应平台的ossutil二进制文件 / Automatically selects and runs the appropriate ossutil binary for your platform
4. 所有平台的二进制文件都已包含在npm包中，无需额外下载 / All platform binaries are included in the npm package, no additional download needed

版本说明 / Version Information

• npm包版本 / npm package version: 2.3.0
• ossutil版本 / ossutil version: 2.3.0 (Released on May 8, 2026)

依赖 / Dependencies

• Node.js >= 14.0.0
• 无需其他依赖，所有二进制文件已包含 / No other dependencies required, all binaries included

常见问题 / FAQ

权限错误（Linux/macOS）/ Permission Errors (Linux/macOS)

如果遇到权限错误，npm包会自动尝试设置可执行权限。如果仍有问题，请手动设置：

If you encounter permission errors, the npm package will automatically try to set executable permissions. If issues persist, manually set them:

chmod +x node_modules/.bin/ossutil

许可证 / License

MIT License

作者 / Author

vtxf

参考链接 / References

• 阿里云ossutil官方文档 / Alibaba Cloud ossutil Official Documentation
• ossutil 2.0历史版本 / ossutil 2.0 Version History

支持 / Support

如有问题请在GitHub提issue。

For issues, please open a GitHub issue.