https://github.com/wxy1343/aliyunpan
阿里云盘cli
https://github.com/wxy1343/aliyunpan
aliyundrive aliyunpan cli tui
Last synced: 5 months ago
JSON representation
阿里云盘cli
- Host: GitHub
- URL: https://github.com/wxy1343/aliyunpan
- Owner: wxy1343
- License: gpl-3.0
- Created: 2020-12-05T21:25:39.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2023-02-17T15:11:28.000Z (over 3 years ago)
- Last Synced: 2025-09-28T09:01:42.150Z (9 months ago)
- Topics: aliyundrive, aliyunpan, cli, tui
- Language: Python
- Homepage:
- Size: 595 KB
- Stars: 473
- Watchers: 11
- Forks: 63
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# aliyunpan
[](https://github.com/wxy1343/aliyunpan/actions)
[](https://github.com/wxy1343/aliyunpan/blob/main/LICENSE)
[](https://pypi.org/project/aliyunpan/)
[](https://github.com/wxy1343/aliyunpan/releases/latest/)
[](https://github.com/wxy1343/aliyunpan/wiki)
---
阿里云盘cli
环境要求： python 3.7 通过测试
~~低版本环境运行报错参考~~[~~issue9~~](https://github.com/wxy1343/aliyunpan/issues/9)
## 安装
```shell
pip install aliyunpan
```
## 更新
```shell
pip install aliyunpan --upgrade
```
## 运行
```shell
aliyunpan-cli
```
## pyinstaller打包
[最新版下载](https://github.com/wxy1343/aliyunpan/releases/latest) (GitHub
Actions打包，glibc版本较高 [#42](https://github.com/wxy1343/aliyunpan/issues/42))
[第三方下载](https://media.cooluc.com/source/aliyunDrive-cli) (更新较慢)
## 克隆项目
* `--recurse-submodules` 用于克隆子模块，部分功能需要(可选)
```shell
git clone https://github.com/wxy1343/aliyunpan --recurse-submodules
```
## 获取refresh_token
### 注意
* web端获取的refresh_token有防盗链检测
1. 可以指定账号密码登入
2. 可以通过手机端查找日志获取refresh_token
> /sdcard/Android/data/com.alicloud.databox/files/logs/trace/userId/yunpan/latest.log
* ~~登录api加入了ua检测，需要运行混淆的js代码来获取ua~~
* ~~推荐安装 [node.js](https://nodejs.org) 和 [jsdom](https://github.com/jsdom/jsdom) 模块来运行js代码~~
* 目前阿里云盘修改了ua的算法,加入了鼠标移动之类的信息,如果有解决方法的欢迎来[pr](https://github.com/wxy1343/aliyunpan/pulls)
```shell
npm install jsdom
```
### 配置refresh_token
```shell
echo "refresh_token: 'xxxxx'" > ~/.config/aliyunpan.yaml
```
### 配置账号(可选)
```shell
echo "username: 'xxxxx'" > ~/.config/aliyunpan.yaml
echo "password: 'xxxxx'" >> ~/.config/aliyunpan.yaml
```
### 配置aria2(可选)
```shell
cat >> ~/.config/aliyunpan.yaml <
查看详情
参数
描述
-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
指定使用正则匹配文件
* 查看指令参数
```shell
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
* 格式
```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.文件分享
```shell
aliyunpan-cli share 示例文件.txt
```
导入
```shell
aliyunpan-cli upload "aliyunpan://示例文件.txt|F61851825609372B3D7F802E600B35A497CFC38E|url_base64|24|root"
```
3.文件夹分享
```shell
aliyunpan-cli share 示例文件夹
```
导入
```shell
aliyunpan-cli upload -s "aliyunpan://示例文件夹|80E7E25109D4246653B600FDFEDD8D8B0D97E517|url_base64|970|root"
```
### TUI按键指南
* 显示菜单(ctrl+x)
* 退出(ctrl+c)
* 切换标签(↑↓←→,kjhl,TAB)
### 环境变量
```ALIYUNPAN_CONF``` 配置文件路径
```ALIYUNPAN_ROOT``` 根目录(log和tasks输出路径)
## 致谢
感谢 [zhjc1124/aliyundrive](https://github.com/zhjc1124/aliyundrive) 的登录接口参考