阿里云盘CLI。仿 Linux shell 文件处理命令的阿里云盘命令行客户端。
- 本项目还处于开发阶段，未经过充分的测试，如有bug或者好的建议欢迎提交issue
- 由于阿里云盘还在内测中，后面功能和接口随时会被修改，相对应的，本工具相关功能也会被影响
- 目前阶段优先处理Bug，功能增强的开发会相对往后安排
- arm / armv5 / armv7 : 适用32位ARM系统
- arm64 : 适用64位ARM系统
- 386 / x86 : 适用32系统，包括Intel和AMD的CPU系统
- amd64 / x64 : 适用64位系统，包括Intel和AMD的CPU系统
- mips : 适用MIPS指令集的CPU，例如国产龙芯CPU
- macOS amd64适用Intel CPU的机器，macOS arm64目前主要是适用苹果M1芯片的机器
- iOS arm64适用iPhone手机，并且必须是越狱的手机才能正常运行
- 多平台支持, 支持 Windows, macOS, linux(x86/x64/arm), android, iOS 等
- 阿里云盘多用户支持
- 支持文件网盘，相册网盘无缝切换
- 支持导入/导出功能，快速备份（导出）和恢复（导入）网盘的文件
- 下载网盘内文件, 支持多个文件或目录下载, 支持断点续传和单文件并行下载
- 上传本地文件, 支持多个文件或目录上传，支持排除指定文件夹/文件（正则表达式）功能
- 备份本地文件支持备份本地文件夹到网盘中，保持本地文件和网盘文件同步。常用于嵌入式或者NAS等设备。
可以直接在发布页下载使用.
也可以使用这个天翼云盘分享链接（阿里云盘还不支持zip压缩包分享）进行下载：下载链接（访问码：5o9b）
如果程序运行时输出乱码, 请检查下终端的编码方式是否为 UTF-8.
使用本程序之前, 非常建议先学习一些 linux 基础命令知识.
如果没有带任何参数运行程序, 程序将会进入仿Linux shell系统用户界面的cli交互模式, 可直接运行相关命令.
cli交互模式下, 光标所在行的前缀应为 aliyunpan >, 如果登录了帐号则格式为 aliyunpan:<工作目录> <用户昵称>$
程序会提供相关命令的使用说明.
程序应在 命令提示符 (Command Prompt) 或 PowerShell 中运行.
也可直接双击程序运行, 具体使用方法请参见 命令列表及说明.
程序应在 终端 (Terminal) 运行.
具体使用方法请参见 命令列表及说明 .
命令的前缀 aliyunpan 为指向程序运行的全路径名 (ARGv 的第一个参数)
直接运行程序时, 未带任何其他参数, 则程序进入cli交互模式, 进入cli模式运行以下命令时要把命令的前缀 aliyunpan 去掉! 即不需要输入aliyunpan。
cli交互模式支持按tab键自动补全命令.
aliyunpan update
aliyunpan help
列出程序支持的命令
aliyunpan help
查看login命令的帮助手册
aliyunpan help login
当前支持使用RefreshToken进行登录。RefreshToken请参考 1. 如何获取RefreshToken 获取
aliyunpan login
按照引导步骤登录
aliyunpan login
请输入RefreshToken, 回车键提交 > 626a27b6193f4c5ca6ef0.......
命令行指定RefreshToken登录
aliyunpan login -RefreshToken=626a27b6193f4c5ca6ef0.......
aliyunpan loglist
列出所有已登录的帐号
aliyunpan who
切换已登录的帐号
aliyunpan su <uid>
aliyunpan su
请输入要切换帐号的 # 值 >
退出当前登录的帐号
aliyunpan logout
程序会进一步确认退出帐号, 防止误操作.
程序默认工作在文件网盘下，如需切换到相册网盘，可以使用本命令进行切换。
aliyunpan drive <driveId>
aliyunpan drive
输入要切换的网盘 # 值 >
aliyunpan quota
获取网盘的总储存空间, 和已使用的储存空间
aliyunpan cd <目录>
# 切换 /我的文档 工作目录
aliyunpan cd /我的文档
# 切换 上级目录
aliyunpan cd ..
# 切换 根目录
aliyunpan cd /
aliyunpan pwd
列出当前工作目录的文件和目录或指定目录
aliyunpan ls
aliyunpan ls <目录>
-driveId value 网盘ID
# 列出 我的文档 内的文件和目录
aliyunpan ls 我的文档
# 绝对路径
aliyunpan ls /我的文档
# 详细列出 我的文档 内的文件和目录
aliyunpan ll /我的文档
aliyunpan download <网盘文件或目录的路径1> <文件或目录2> <文件或目录3> ...
aliyunpan d <网盘文件或目录的路径1> <文件或目录2> <文件或目录3> ...
--ow overwrite, 覆盖已存在的文件
--status 输出所有线程的工作状态
--save 将下载的文件直接保存到当前工作目录
--saveto value 将下载的文件直接保存到指定的目录
-x 为文件加上执行权限, (windows系统无效)
-p value 指定下载线程数 (default: 0)
-l value 指定同时进行下载文件的数量 (default: 0)
--retry value 下载失败最大重试次数 (default: 3)
--nocheck 下载文件完成后不校验文件
--exn value 指定排除的文件夹或者文件的名称，只支持正则表达式。支持排除多个名称，每一个名称就是一个exn参数
# 设置保存目录, 保存到 D:\Downloads
# 注意区别反斜杠 "\" 和 斜杠 "/" !!!
aliyunpan config set -savedir D:/Downloads
# 下载 /我的文档/1.mp4
aliyunpan d /我的文档/1.mp4
# 下载 /我的文档 整个目录!!
aliyunpan d /我的文档
下载的文件默认保存到 程序所在目录 的 download/ 目录, 支持设置指定目录, 重名的文件会自动跳过!
通过 aliyunpan config set -savedir <savedir> 可以自定义保存的目录.
支持多个文件或目录下载.
自动跳过下载重名的文件!
aliyunpan upload <本地文件/目录的路径1> <文件/目录2> <文件/目录3> ... <目标目录>
aliyunpan u <本地文件/目录的路径1> <文件/目录2> <文件/目录3> ... <目标目录>
# 将本地的 C:\Users\Administrator\Desktop\1.mp4 上传到网盘 /视频 目录
# 注意区别反斜杠 "\" 和 斜杠 "/" !!!
aliyunpan upload C:/Users/Administrator/Desktop/1.mp4 /视频
# 将本地的 C:\Users\Administrator\Desktop\1.mp4 和 C:\Users\Administrator\Desktop\2.mp4 上传到网盘 /视频 目录
aliyunpan upload C:/Users/Administrator/Desktop/1.mp4 C:/Users/Administrator/Desktop/2.mp4 /视频
# 将本地的 C:\Users\Administrator\Desktop 整个目录上传到网盘 /视频 目录
aliyunpan upload C:/Users/Administrator/Desktop /视频
## 下面演示文件或者文件夹排除功能
# 将本地的 C:\Users\Administrator\Video 整个目录上传到网盘 /视频 目录，但是排除所有的.jpg文件
aliyunpan upload -exn "\.jpg$" C:/Users/Administrator/Video /视频
# 将本地的 C:\Users\Administrator\Video 整个目录上传到网盘 /视频 目录，但是排除所有的.jpg文件和.mp3文件，每一个排除项就是一个exn参数
aliyunpan upload -exn "\.jpg$" -exn "\.mp3$" C:/Users/Administrator/Video /视频
以下是典型的排除特定文件或者文件夹的例子，注意：参数值必须是正则表达式
1)排除@eadir文件或者文件夹：-exn "^@eadir$"
2)排除.jpg文件：-exn "\.jpg$"
3)排除.号开头的文件：-exn "^\."
4)排除~号开头的文件：-exn "^~"
5)排除 myfile.txt 文件：-exn "^myfile.txt$"
本地备份功能一般用于NAS等系统，日常只进行增量备份操作，默认情况下本地删除不影响网盘文件。
比如在手机上备分照片目录，就可以使用这个功能定时备份，备份完成后本地文件可安全删除。
基本用法和upload命令一样，额外增加两个参数
- delete 用于同步删除操作（只通过本地数据库记录对比）。
- sync 使网盘上的文件和本地文件同步（本地为主），会删除网盘中不存在于本地的文件或目录（速度比较慢）。
sync 和 delete 的区别在于sync是通过网盘文件列表和本地文件进行判断。
delete 只通过本地数据库进行判断,正常情况下使用 delete 就够用了。
和 upload 相比由于增加了本地数据库，可以快速判断文件是否有更新等，大大减少了 API 的调用，操作速度更快。
aliyunpan backup <本地目录1> <目录2> <目录3> ... <目标目录>
注：
1. 默认不删除网盘文件，可用 delete 或 sync 参数进行同步删除。
# 将本地的 C:\Users\Administrator\Desktop 备份到网盘 /test 目录
# 注意区别反斜杠 "\" 和 斜杠 "/" !!!
aliyunpan backup C:/Users/Administrator/Desktop /test
# 将本地的 C:\Users\Administrator\Desktop 备份到网盘 /test 目录，但排除所有 @eadir 目录
aliyunpan backup -exn "^@eadir$" C:/Users/Administrator/Desktop /test
通过秒传链接上传文件到网盘，秒传链接可以通过share命令获取
aliyunpan rapidupload <秒传链接1> <秒传链接2> <秒传链接3> ...
# 如果秒传成功, 则保存到网盘路径 /file.dmg
aliyunpan rapidupload "aliyunpan://file.dmg|752FCCBFB2436A6FFCA3B287831D4FAA5654B07E|7005440|"
# 如果秒传成功, 则保存到网盘路径 /pan_folder/file.dmg
aliyunpan rapidupload "aliyunpan://file.dmg|752FCCBFB2436A6FFCA3B287831D4FAA5654B07E|7005440|pan_folder"
aliyunpan mkdir <目录>
aliyunpan mkdir test123
aliyunpan rm <网盘文件或目录的路径1> <文件或目录2> <文件或目录3> ...
注意: 删除多个文件和目录时, 请确保每一个文件和目录都存在, 否则删除操作会失败.
被删除的文件或目录可在网盘文件回收站找回.
# 删除 /我的文档/1.mp4
aliyunpan rm /我的文档/1.mp4
# 删除 /我的文档/1.mp4 和 /我的文档/2.mp4
aliyunpan rm /我的文档/1.mp4 /我的文档/2.mp4
# 删除 /我的文档 整个目录 !!
aliyunpan rm /我的文档
aliyunpan mv <文件/目录1> <文件/目录2> <文件/目录3> ... <目标目录>
注意: 移动多个文件和目录时, 请确保每一个文件和目录都存在, 否则移动操作会失败.
# 将 /我的文档/1.mp4 移动到 根目录 /
aliyunpan mv /我的文档/1.mp4 /
aliyunpan rename <旧文件/目录名> <新文件/目录名>
注意: 重命名的文件/目录，如果指定的是绝对路径，则必须保证新旧的绝对路径在同一个文件夹内，否则重命名失败！
# 将 /我的文档/1.mp4 重命名为 /我的文档/2.mp4
aliyunpan rename /我的文档/1.mp4 /我的文档/2.mp4
导出文件主要是用于备份网盘的文件。通过该命令将网盘的文件元数据信息导出并保存到本地文件中，等到以后需要的时候再通过import命令导入到网盘中。
aliyunpan export <网盘文件/目录的路径1> <文件/目录2> <文件/目录3> ... <本地保存文件路径>
导出指定文件/目录下面的所有文件的元数据信息，并保存到指定的本地文件里面。导出的文件元信息可以使用 import 命令（秒传文件功能）导入到网盘中。
导出 /我的资源 整个目录 元数据到文件 /Users/tickstep/Downloads/export_files.txt
aliyunpan export /我的资源 /Users/tickstep/Downloads/export_files.txt
导出 网盘 整个目录 元数据到文件 /Users/tickstep/Downloads/export_files.txt
aliyunpan export / /Users/tickstep/Downloads/export_files.txt
aliyunpan export <本地元数据文件路径>
导入文件中记录的元数据文件到网盘。保存到网盘的文件会使用文件元数据记录的路径位置，如果没有指定云盘目录(saveto)则默认导入到目录 aliyunpan 中。 导入的文件可以使用 export 命令获得。
导入文件每一行是一个文件元数据，样例如下：
aliyunpan://file.dmg|752FCCBFB2436A6FFCA3B287831D4FAA5654B07E|7005440|
导入文件 /Users/tickstep/Downloads/export_files.txt 存储的所有文件元数据项
aliyunpan import /Users/tickstep/Downloads/export_files.txt
导入文件 /Users/tickstep/Downloads/export_files.txt 存储的所有文件元数据项并保存到目录 /my2020 中
aliyunpan import -saveto=/my2020 /Users/tickstep/Downloads/export_files.txt
导入文件 /Users/tickstep/Downloads/export_files.txt 存储的所有文件元数据项并保存到网盘根目录 / 中
aliyunpan import -saveto=/ /Users/tickstep/Downloads/export_files.txt
aliyunpan share
阿里目前之支持少数文件类型的分享，不支持的文件分享会提示分享失败
aliyunpan share set <文件/目录1> <文件/目录2> ...
aliyunpan share s <文件/目录1> <文件/目录2> ...
aliyunpan share list
aliyunpan share l
aliyunpan share cancel <shareid_1> <shareid_2> ...
aliyunpan share c <shareid_1> <shareid_2> ...
目前只支持通过分享id (shareid) 来取消分享.
秒传链接支持所有类型的文件分享，可以突破阿里的分享限制。得到的链接可以使用import或者rapidupload命令保存到自己网盘中。 秒传链接只支持文件分享，不支持文件夹。如果指定文件夹会创建文件夹下所有文件的秒传链接。
aliyunpan share mc <文件/目录1> <文件/目录2> ...
例子
# 创建文件 1.mp4 的秒传链接
aliyunpan share mc 1.mp4
# 创建文件 1.mp4 的秒传链接，但链接隐藏相对路径
aliyunpan share mc -hp 1.mp4
# 创建文件夹 share_folder 下面所有文件的秒传链接
aliyunpan share mc share_folder/
# 显示配置
aliyunpan config
# 设置配置
aliyunpan config set
# 显示所有可以设置的值
aliyunpan config -h
aliyunpan config set -h
# 设置下载文件的储存目录
aliyunpan config set -savedir D:/Downloads
# 设置下载最大并发量为 15
aliyunpan config set -max_download_parallel 15
# 组合设置
aliyunpan config set -max_download_parallel 15 -savedir D:/Downloads
需要通过浏览器获取refresh_token。这里以Chrome浏览器为例，其他浏览器类似。
打开 阿里云盘网页 并进行登录，然后F12按键打开浏览器调试菜单，按照下面步骤进行
当需要定位问题，或者提交issue的时候抓取log，则需要开启debug日志。步骤如下：
Linux&MacOS
命令行运行
export ALIYUNPAN_VERBOSE=1
Windows
不同版本会有些许不一样，请自行查询具体方法
设置示意图如下：
打开aliyunpan命令行程序，任何云盘命令都有类似如下日志输出
提交issue: issues页面
联系邮箱: [email protected]
本项目大量借鉴了以下相关项目的功能&成果
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent