aliyunpan-cli
aliyunpan-cli 是一款第三方开源的阿里云盘命令行管理工具,能让你在终端上实现阿里云盘客户端的功能,能更方便地实现本地&云端文件自动化管理,配合web直链挂载程序拓展更多的可能性!
构建日期:2023/02/16
版本:v3.0.9
上游:[52376de]

获取refresh_token
-
傻瓜方法(请用于个人,勿用于 API):https://mytoken.cooluc.com/
配置 refresh_token
Linux aarch64/x86_64 (glibc):
echo "refresh_token: 'xxxxx'" > ~/.config/aliyunpan.yaml
OpenWrt & Alpine (musl)(日志路径:/tmp/aliyunpan-cli.log):
echo "refresh_token: 'xxxxx'" > /opt/aliyunpan.yaml
Windows:
在桌面按住 Shift 键,在桌面空白处右键并打开 “在此处打开PowerShell窗口”,执行以下命令写入 refresh_token 配置。
echo "refresh_token: 'xxxxx'" | Out-File -Encoding ascii ~/aliyunpan.yaml
功能介绍
| 指令 | 描述 |
|---|---|
| download (d) | 下载文件/文件夹 |
| ls (dir,l,list) | 列目录 |
| mv (move) | 移动文件/文件夹 |
| rm (del,delete) | 删除文件/文件夹 |
| rename (r) | 重命名文件/文件夹 |
| tree (show,t) | 查看文件树 |
| upload (u) | 上传文件/文件夹 |
| share (s) | 分享文件 |
| mkdir (m) | 创建文件夹 |
| cat (c) | 显示文件内容 |
| tui | 文本用户界面 |
| search | 搜索文件/文件夹 |
| sync | 同步文件夹 |
| token (r,refresh_token) | 查看refresh_token |
使用指南
- 查看帮助
aliyunpan-cli -h
| 参数 | 描述 |
| -h, --help | 查看帮助 |
| --version | 查看版本 |
| -c, --config-file | 指定配置文件 |
| -t, --refresh-token | 指定REFRESH_TOKEN |
| -u, --username | 指定账号 |
| -p, --password | 指定密码 |
| -d, --depth | 文件递归深度 |
| -T, --timeout | 请求超时时间(秒) |
| -id, --drive-id | 指定drive_id |
| -a, --album | 是否访问相册 |
| -s, --share-id | 指定分享id |
| -sp, --share-pwd | 指定分享密码 |
| -f, --filter-file | 过滤文件(多个) |
| -w, --whitelist | 使用白名单过滤文件 |
| -m, --match | 指定使用正则匹配文件 |
- 查看指令参数
aliyunpan-cli COMMAND -h
| 指令 | 参数 | 描述 |
| download | -p, --file | 选择文件(多个) |
| download | -s, --share | 指定分享的序列文件 |
| download | -cs, --chunk-size | 分块大小(字节) |
| download | -a, --aria2 | 发送到aria2 |
| ls,search | -l | 查看详情 |
| share | -p, --file | 指定文件(多个) |
| share | -f, --file-id | 指定file_id(多个) |
| share | -t, --expire-sec | 分享过期时间(秒),默认最大14400 |
| share | -l, --share-link | 输出分享链接 |
| share | -d, --download-link | 输出下载链接 |
| share | -s, --save | 保存序列文件到云盘和本地 |
| share | -S, --share-official | 官方分享功能(需要账号支持) |
| upload | -p, --file | 选择文件(多个) |
| upload,sync | -t, --time-out | 分块上传超时时间(秒) |
| upload,sync | -r, --retry | 上传失败重试次数 |
| upload | -f, --force | 强制覆盖文件 |
| upload | -s, --share | 指定分享的序列文件 |
| upload,sync | -cs, --chunk-size | 分块大小(字节) |
| upload | -c | 断点续传 |
| cat | -e, --encoding | 文件编码 |
| sync | -st, --sync-time | 同步间隔时间 |
| sync | --no-delete, -n | 不删除(云盘/本地)文件(默认) |
| sync | -d, --delete | 允许删除(云盘/本地)文件 |
| sync | -l, --local | 同步云盘文件到本地 |
| token | --refresh, -r | 刷新配置文件token |
| token | --refresh-time, -t | 自动刷新token间隔时间(秒) |
| token | --change, -c | 设置新的refresh_token |
断点续传
- 将文件分成多块顺序上传
- 文件上传进度保存在当前目录下的tasks.yaml
- 格式
文件sha1: path: 绝对路径 upload_id: 上传id file_id: 文件id chunk_size: 分块大小 part_number: 最后上传的分块编号 - 文件未上传成功时,CTRL+C会自动保存
- 断点续传需带上参数-c
分享
- 由于官方修改秒传接口导致该功能失效
- 暂时采用在秒传链接中加入直链的方法用以获取proof_code
- 分享秒传文件时需要通过直链获取文件随机8字节,导致速度较慢
- 由于直链的局限,秒传链接有效期为4小时
1.分享链接格式
aliyunpan://文件名|sha1|url_base64|文件大小|相对路径
例如
- 以下秒传链接均已失效,仅供参考
aliyunpan://示例文件.txt|F61851825609372B3D7F802E600B35A497CFC38E|url_base64|24|root
2.文件分享
aliyunpan-cli share 示例文件.txt
导入
aliyunpan-cli upload "aliyunpan://示例文件.txt|F61851825609372B3D7F802E600B35A497CFC38E|url_base64|24|root"
3.文件夹分享
aliyunpan-cli share 示例文件夹
导入
aliyunpan-cli upload -s "aliyunpan://示例文件夹|80E7E25109D4246653B600FDFEDD8D8B0D97E517|url_base64|970|root"
TUI按键指南
- 显示菜单(ctrl+x)
- 退出(ctrl+c)
- 切换标签(↑↓←→,kjhl,TAB)
环境变量
ALIYUNPAN_CONF 配置文件路径
ALIYUNPAN_ROOT 根目录(log和tasks输出路径)