阿里云盘命令行工具 aliyunpan 完整指南：上传下载、自动备份一步到位

阿里云盘命令行工具 aliyunpan 完整指南：上传下载、自动备份一步到位

【免费下载链接】aliyunpan阿里云盘命令行客户端，支持JavaScript插件，支持同步备份功能。项目地址: https://gitcode.com/GitHub_Trending/ali/aliyunpan

手动把文件拖到网盘、在网页里等文件一个个下完，都很磨人。阿里云盘命令行客户端 aliyunpan 在终端里把这些全干了：上传下载、目录操作、多账号叠加提速，还能 7×24 小时跑同步备份，全程可以脚本化。

快速上手：三步跑通第一条命令

装包按你的系统来：brew、apt、yum、winget 都支持，或者直接下载对应架构的发行包解压即用。装完做两件事：指定配置目录、登录账号。

# 建议指定配置目录，多账号或服务化部署时更清晰 export ALIYUNPAN_CONFIG_DIR=/opt/aliyunpan/config # 登录：终端会给出浏览器链接，先点一次授权、再扫码一次，两步都完成后终端提示成功 aliyunpan login # 跑通第一条命令：列一下网盘根目录 aliyunpan ls

登录链接 5 分钟有效，过期就重新login。登录后默认在备份盘工作，用drive命令可以在备份盘和资源库之间切换。

核心场景实操

整个文件夹怎么传到网盘

上传一条命令搞定，-exn支持正则排除不想要的文件。比如备份视频目录但不想传.jpg：

# 上传整个文件夹，正则排除 .jpg 文件 aliyunpan upload /data/video "/备份/video" -exn "\.jpg$"

文件多的时候加-ui，终端里会出现进度面板，每个文件的百分比一目了然。

怎么把云盘目录拉到本地

反向操作同理，--saveto指定落盘目录，支持断点续传：

# 把云盘目录下载到指定本地目录 aliyunpan download "/备份/video" --saveto /data/video

本地已有同名文件时，加--ow才会覆盖，默认不动旧文件。

自动备份怎么配

同步备份有两个方向：upload（本地→云盘）和download（云盘→本地），两种策略：exclusive镜像备份（源侧删了目标侧跟着删）、increment增量备份（只同步新增和修改）。

# 把本地文档目录备份到网盘，前台跑起来看效果 aliyunpan sync start -ldir /data/docs -pdir "/备份/docs" -mode upload

任务逻辑是"扫描→对比→执行"三步一个循环，跑稳后就可以丢后台：

多个备份任务可以写进配置文件，再执行aliyunpan sync start全部拉起，配置结构参考 assets/sync_drive/sync_drive_config.json.sample，参数细节见 同步备份说明。

进阶玩法

多账号叠加下载速度

适合追求极限下载速度、又没开会员的用户。把多个账号都登录进去（loglist查看、su切换），下载时加-md，所有账号的线程叠加到同一个文件上，N 个账号约等于 N×3 并发：

# 多用户联合下载，叠加所有已登录账号的速度 aliyunpan download /大文件.iso -md

JS 插件定制上传下载行为

适合有"只过滤某些敏感文件""上传后删除本地原文件""完成后发通知"这类个性化需求的用户。把脚本放进配置目录的plugin/js/下即可生效，仓库里带了 5 个样例模板（上传/下载/删除/同步/Token），复制一份改掉.sample后缀就能跑。不会写 JS 也没关系，JS 插件手册 里现成了 8 个场景样例可直接抄。

注册为系统服务长期跑

适合 NAS、服务器上需要备份进程常驻的场景。Linux 自带 systemd 单元文件（assets/service/linux/下的aliyunpansync.service和 start/stop 脚本），Windows 可用 WinSW 注册成系统服务。先快速验证的话，一条 nohup 就够：

# 后台启动同步脚本 nohup ./sync.sh >/dev/null 2>&1 &

避坑手册：现象→原因→解法

• 下载速度只有几百 KB/s→ 原因：账号没开三方应用权益包。解法：开通后限速明显放开，会员账号可跑到 50MB/s 量级。
• 大文件下载经常中断→ 原因：网络抖动，默认只重试 3 次。解法：--retry 5加大重试，同时适当降低并发。
• 想调并发但默认偏保守→ 解法：aliyunpan config set -max_download_parallel 15，一次设置长期生效。
• 提示"已超出最大登录设备数量"→ 原因：单账号最多同时登录 10 台设备。解法：到阿里云盘 App 或 Web 端把不用的旧设备下线，再重启程序。

• 出问题了不知道卡在哪→ 原因：没开详细日志。解法：执行export ALIYUNPAN_VERBOSE=1后再跑命令，所有云盘请求都会打印 debug 日志，反馈问题时也用它抓现场。

适合谁

如果你有一台 NAS 或服务器，或者想把网盘管理全部脚本化，aliyunpan 基本能覆盖所有需求；命令细节看 命令手册，插件玩法看 JS 插件手册，有定制需求也可以到项目社区里直接提。

【免费下载链接】aliyunpan阿里云盘命令行客户端，支持JavaScript插件，支持同步备份功能。项目地址: https://gitcode.com/GitHub_Trending/ali/aliyunpan