tickstep / aliyunpan

关于 阿里云盘CLI。仿 Linux shell 文件处理命令的阿里云盘命令行客户端，支持JavaScript插件，支持同步备份功能，支持相册批量下载。 特色• 多平台支持, 支持 Windows, macOS, linux(x86/x64/arm), android, iOS 等• 阿里云盘多用户支持• 支持备份盘，资源库无缝切换• 下载网盘内文件, 支持多个文件或目录下载, 支持断点续传和单文件并行下载。支持软链接(符号链接)文件。• 上传本地文件, 支持多个文件或目录上传，支持排除指定文件夹/文件（正则表达式）功能。支持软链接(符号链接)文件。• 同步备份功能支持备份本地文件到云盘，备份云盘文件到本地，双向同步备份保持本地文件和网盘文件同步。常用于嵌入式或者NAS等设备，支持docker镜像部署。• 命令和文件路径输入支持Tab键自动补全，路径支持通配符匹配模式• 支持JavaScript插件，你可以按照自己的需要定制上传/下载中关键步骤的行为，最大程度满足自己的个性化需求• 支持共享相册的相关操作，支持批量下载相册所有普通照片、实况照片文件到本地• 支持多用户联合下载功能，对下载速度有极致追求的用户可以尝试使用该选项。详情请查看文档多用户联合下载 阿里云盘VIP会员推荐码 如果大家有打算开通阿里云盘VIP会员，可以使用阿里云盘APP扫描下面的优惠推荐码进行开通。 注意：您需要开通【三方应用权益包】，这样使用本程序下载才能加速，否则下载无法提速。 目录• 关于• 特色• 目录• 如何安装• 直接下载安装• apt安装• yum安装• brew安装• winget安装• docker安装• sync同步盘• 如何使用• 基本使用• 修改配置目录• 启动程序• 查看帮助• 登录• 切换网盘• 查看文件列表• 下载文件• 上传文件• 同步备份文件• 更多命令• 常见问题• 如何开启Debug调试日志• 第一步• 第二步• 如何登出和下线客户端• 交流反馈• 鸣谢 如何安装 直接下载安装 可以直接在本仓库 发布页 下载安装包，解压后使用。 要特别注意安装包的标签，不同的标签对应不同架构的系统，相关版本文件的标签说明如下：• arm / armv5 / armv7 : 适用32位ARM系统• arm64 : 适用64位ARM系统• 386 / x86 : 适用32系统，包括Intel和AMD的CPU系统• amd64 / x64 : 适用64位系统，包括Intel和AMD的CPU系统• mips : 适用MIPS指令集的CPU，例如中标麒麟的系统。MIPS要注意大小端字序的不同对应的版本也不同。• macOS amd64适用Intel CPU的机器，macOS arm64目前主要是适用苹果M系列芯片的机器• iOS arm64适用iPhone手机，并且必须是越狱的手机才能正常运行• loong64 : 适用于LoongArch64架构的机器，例如国产龙芯CPU 参考例子： apt安装 适用于apt包管理器的系统，例如Ubuntu，国产deepin深度操作系统等。目前只支持amd64和arm64架构的机器。 yum安装 适用于yum包管理器的系统，例如CentOS、RockyLinux等。目前只支持amd64和arm64架构的机器。 brew安装 适用于brew包管理器的系统，主要是苹果macOS系统。目前只支持amd64和arm64架构(Apple Silicon)的机器。 由于brew默认安装在系统目录下面，这样配置文件也默认存放在系统目录里了，建议设置系统变量进行配置文件的单独存储，例如 winget安装 适用于Windows系统的winget包管理器。目前只支持x86和x64架构的机器。 更新源（可选） 安装 docker安装 sync同步盘 同步备份功能，支持备份本地文件到云盘，备份云盘文件到本地两种模式。支持JavaScript插件对备份文件进行过滤。 备份功能支持以下模式：• 备份本地文件，即上传本地文件到网盘，始终保持本地文件有一个完整的备份在网盘• 备份云盘文件，即下载网盘文件到本地，始终保持网盘的文件有一个完整的备份在本地 备份功能支持指定备份策略：• exclusive，排他备份文件（一比一镜像备份），目标目录多余的文件会被删除。保证备份的源目录，和目标目录文件一比一备份。源目录文件如果文件被删除，则对应的目标目录的文件也会被删除。• increment，增量备份文件，目标目录多余的文件不会被删除。只会把源目录修改的文件，新增的文件备份到目标目录。如果源目录有文件删除，或者目标目录有其他文件新增是不会被删除。 同步的基本逻辑如下所示，一次循环包括：扫描-对比-执行，一共三个环节。 docker-compose启动方式请查看：docker-compose.yml 更详情文档请参考dockerhub网址：tickstep/aliyunpan-sync 如何使用 完整和详细的命令说明请查看手册：命令手册 • Windows 程序应在 命令提示符 (Command Prompt) 或 PowerShell 中运行. 也可直接双击程序运行, 具体使用方法请参见 命令列表及说明• Linux / macOS 程序应在 终端 (Terminal) 运行. 具体使用方法请参见 命令列表及说明 如果程序运行时输出乱码, 请检查下终端的编码方式是否为 . 如果没有带任何参数运行程序, 程序将会进入仿Linux shell系统用户界面的CLI交互模式, 可直接运行相关命令. 在交互模式下, 光标所在行的前缀应为 , 如果登录了帐号则格式为 程序内置了相关命令的使用说明，你可以通过运行 的方式获取命令的使用说明，例如： 获取上传命令的使用说明。 基本使用 本程序支持阿里云盘大多数命令操作，这里只介绍基本的使用，更多更详细的命令请查看手册：命令手册。 修改配置目录 你可以指定程序配置文件的存储路径，如果没有指定，程序会使用默认的目录。 方法为设置环境变量 并指定一个存在的目录，例如linux下面可以这样指定 启动程序 直接启动进入交互命令行 查看帮助 登录 需要先登录，已经登录过的可以跳过此步。登录是在浏览器上进行，你需要进行两次登录。 切换网盘 支持切换备份盘、资源库，默认工作在备份盘下。 查看文件列表 下载文件 通过 可以自定义下载文件保存的目录。 或者使用UI面板展示下载进度(使用-ui选项)，更加直观和友好。 上传文件 或者使用UI面板展示上传进度(使用-ui选项)，更加直观和友好。 同步备份文件 同步备份功能，支持备份本地文件到云盘，备份云盘文件到本地，双向同步备份三种模式。支持JavaScript插件对备份文件进行过滤。 例如：将本地目录 中的文件备份上传到云盘目录 更多命令 更多更详细的命令请查看手册：命令手册。 常见问题 如何开启Debug调试日志 当需要定位问题，或者提交issue的时候抓取log，则需要开启debug日志。步骤如下： 第一步 Linux&MacOS 命令行运行 Windows 不同版本会有些许不一样，请自行查询具体方法 设置示意图如下： 第二步 打开aliyunpan命令行程序，任何云盘命令都有类似如下日志输出 如何登出和下线客户端 阿里云盘单账户最多只允许同时登录 10 台设备 当出现这个提示：你账号已超出最大登录设备数量，请先下线一台设备，然后重启本应用，才可以继续使用 说明你的账号登录客户端已经超过数量，你需要先登出其他客户端才能继续使用，如下所示 APP手机端 Web网页端 交流反馈 提交issue: issues页面 联系邮箱: tickstep@outlook.com 鸣谢 本项目大量借鉴了以下相关项目的功能&成果 > tickstep/aliyunpan-api > tickstep/cloudpan189-go > kazutoiris/ali_ecc