[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-71479":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":33,"readmeContent":34,"aiSummary":35,"trendingCount":16,"starSnapshotCount":16,"syncStatus":36,"lastSyncTime":37,"discoverSource":38},71479,"aliyunpan","tickstep\u002Faliyunpan","tickstep","阿里云盘命令行客户端，支持JavaScript插件，支持同步备份功能。","",null,"Go",5042,387,31,18,0,9,11,28,27,90.07,"Apache License 2.0",false,"main",true,[27,28,29,30,31,32],"adrive","backup","linux","macos","sync","windows","2026-06-12 04:01:01","# 关于\r\n阿里云盘CLI。仿 Linux shell 文件处理命令的阿里云盘命令行客户端，支持JavaScript插件，支持同步备份功能，支持相册批量下载。\r\n\r\n# 特色\r\n1. 多平台支持, 支持 Windows, macOS, linux(x86\u002Fx64\u002Farm), android, iOS 等\r\n2. 阿里云盘多用户支持\r\n3. 支持备份盘，资源库无缝切换\r\n4. [下载](docs\u002Fmanual.md#下载文件目录)网盘内文件, 支持多个文件或目录下载, 支持断点续传和单文件并行下载。支持软链接(符号链接)文件。\r\n5. [上传](docs\u002Fmanual.md#上传文件目录)本地文件, 支持多个文件或目录上传，支持排除指定文件夹\u002F文件（正则表达式）功能。支持软链接(符号链接)文件。\r\n6. [同步备份功能](docs\u002Fmanual.md#同步备份功能)支持备份本地文件到云盘，备份云盘文件到本地，双向同步备份保持本地文件和网盘文件同步。常用于嵌入式或者NAS等设备，支持docker镜像部署。\r\n7. 命令和文件路径输入支持Tab键自动补全，路径支持通配符匹配模式\r\n8. 支持[JavaScript插件](docs\u002Fplugin_manual.md#简介)，你可以按照自己的需要定制上传\u002F下载中关键步骤的行为，最大程度满足自己的个性化需求\r\n9. 支持共享相册的相关操作，支持批量下载相册所有普通照片、实况照片文件到本地\r\n10. 支持多用户联合下载功能，对下载速度有极致追求的用户可以尝试使用该选项。详情请查看文档[多用户联合下载](docs\u002Fmanual.md#多用户联合下载)\r\n\r\n# 阿里云盘VIP会员推荐码\r\n如果大家有打算开通阿里云盘VIP会员，可以使用阿里云盘APP扫描下面的优惠推荐码进行开通。    \r\n注意：您需要开通【三方应用权益包】，这样使用本程序下载才能加速，否则下载无法提速。   \r\n![](.\u002Fassets\u002Fimages\u002Faliyunpan_cps_qrcode.png)\r\n\r\n# 目录\r\n- [关于](#关于)\r\n- [特色](#特色)\r\n- [目录](#目录)\r\n- [如何安装](#如何安装)\r\n  - [直接下载安装](#直接下载安装)\r\n  - [apt安装](#apt安装)\r\n  - [yum安装](#yum安装)\r\n  - [brew安装](#brew安装)\r\n  - [winget安装](#winget安装)\r\n  - [docker安装](#docker安装)\r\n    - [sync同步盘](#sync同步盘)\r\n- [如何使用](#如何使用)\r\n  - [基本使用](#基本使用)\r\n    - [修改配置目录](#修改配置目录)\r\n    - [启动程序](#启动程序)\r\n    - [查看帮助](#查看帮助)\r\n    - [登录](#登录)\r\n    - [切换网盘](#切换网盘)\r\n    - [查看文件列表](#查看文件列表)\r\n    - [下载文件](#下载文件)\r\n    - [上传文件](#上传文件)\r\n    - [同步备份文件](#同步备份文件)\r\n  - [更多命令](#更多命令)\r\n- [常见问题](#常见问题)\r\n  - [如何开启Debug调试日志](#如何开启debug调试日志)\r\n    - [第一步](#第一步)\r\n    - [第二步](#第二步)\r\n  - [如何登出和下线客户端](#如何登出和下线客户端)\r\n- [交流反馈](#交流反馈)\r\n- [鸣谢](#鸣谢)\r\n\r\n# 如何安装\r\n## 直接下载安装\r\n可以直接在本仓库 [发布页](https:\u002F\u002Fgithub.com\u002Ftickstep\u002Faliyunpan\u002Freleases) 下载安装包，解压后使用。   \r\n   \r\n要特别注意安装包的标签，不同的标签对应不同架构的系统，相关版本文件的标签说明如下：\r\n1. arm \u002F armv5 \u002F armv7 : 适用32位ARM系统\r\n2. arm64 : 适用64位ARM系统\r\n3. 386 \u002F x86 : 适用32系统，包括Intel和AMD的CPU系统\r\n4. amd64 \u002F x64 : 适用64位系统，包括Intel和AMD的CPU系统\r\n5. mips : 适用MIPS指令集的CPU，例如中标麒麟的系统。MIPS要注意大小端字序的不同对应的版本也不同。\r\n6. macOS amd64适用Intel CPU的机器，macOS arm64目前主要是适用苹果M系列芯片的机器\r\n7. iOS arm64适用iPhone手机，并且必须是越狱的手机才能正常运行\r\n8. loong64 : 适用于LoongArch64架构的机器，例如国产龙芯CPU\r\n\r\n参考例子：\r\n```shell\r\nwget https:\u002F\u002Fgithub.com\u002Ftickstep\u002Faliyunpan\u002Freleases\u002Fdownload\u002Fv0.3.9\u002Faliyunpan-v0.3.9-linux-amd64.zip\r\nunzip aliyunpan-v0.3.9-linux-amd64.zip\r\ncd aliyunpan-v0.3.9-linux-amd64\r\n.\u002Faliyunpan\r\n```\r\n\r\n## apt安装\r\n适用于apt包管理器的系统，例如Ubuntu，国产deepin深度操作系统等。目前只支持amd64和arm64架构的机器。\r\n```shell\r\nsudo curl -fsSL http:\u002F\u002Ffile.tickstep.com\u002Fapt\u002Fpgp | gpg --dearmor | sudo tee \u002Fetc\u002Fapt\u002Ftrusted.gpg.d\u002Ftickstep-packages-archive-keyring.gpg > \u002Fdev\u002Fnull && echo \"deb [signed-by=\u002Fetc\u002Fapt\u002Ftrusted.gpg.d\u002Ftickstep-packages-archive-keyring.gpg arch=amd64,arm64] http:\u002F\u002Ffile.tickstep.com\u002Fapt aliyunpan main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Ftickstep-aliyunpan.list > \u002Fdev\u002Fnull && sudo apt-get update && sudo apt-get install -y aliyunpan\r\n \r\n```\r\n\r\n## yum安装\r\n适用于yum包管理器的系统，例如CentOS、RockyLinux等。目前只支持amd64和arm64架构的机器。\r\n```shell\r\nsudo curl -fsSL http:\u002F\u002Ffile.tickstep.com\u002Frpm\u002Faliyunpan\u002Faliyunpan.repo | sudo tee \u002Fetc\u002Fyum.repos.d\u002Ftickstep-aliyunpan.repo > \u002Fdev\u002Fnull && sudo yum install aliyunpan -y\r\n \r\n```\r\n\r\n## brew安装\r\n适用于brew包管理器的系统，主要是苹果macOS系统。目前只支持amd64和arm64架构(Apple Silicon)的机器。\r\n```shell\r\nbrew install aliyunpan\r\n    \r\n```\r\n由于brew默认安装在系统目录下面，这样配置文件也默认存放在系统目录里了，建议设置系统变量进行配置文件的单独存储，例如\r\n```shell\r\nexport ALIYUNPAN_CONFIG_DIR=\u002FUsers\u002Ftickstep\u002FApplications\u002Fadrive\u002Fconfig\r\n```\r\n\r\n## winget安装\r\n适用于Windows系统的winget包管理器。目前只支持x86和x64架构的机器。  \r\n    \r\n更新源（可选）\r\n```powershell\r\nwinget source update\r\n \r\n```\r\n安装\r\n```powershell\r\nwinget install tickstep.aliyunpan --silent\r\n \r\n```\r\n\r\n## docker安装\r\n### sync同步盘\r\n同步备份功能，支持备份本地文件到云盘，备份云盘文件到本地两种模式。支持JavaScript插件对备份文件进行过滤。\r\n备份功能支持以下模式：\r\n1. 备份本地文件，即上传本地文件到网盘，始终保持本地文件有一个完整的备份在网盘\r\n2. 备份云盘文件，即下载网盘文件到本地，始终保持网盘的文件有一个完整的备份在本地\r\n   \r\n备份功能支持指定备份策略：\r\n1. exclusive，排他备份文件（一比一镜像备份），目标目录多余的文件会被删除。保证备份的源目录，和目标目录文件一比一备份。源目录文件如果文件被删除，则对应的目标目录的文件也会被删除。\r\n2. increment，增量备份文件，目标目录多余的文件不会被删除。只会把源目录修改的文件，新增的文件备份到目标目录。如果源目录有文件删除，或者目标目录有其他文件新增是不会被删除。\r\n   \r\n同步的基本逻辑如下所示，一次循环包括：扫描-对比-执行，一共三个环节。   \r\n![](.\u002Fassets\u002Fimages\u002Fsync_command-basic_logic.jpg)\r\n\r\n```\r\ndocker run -d --name=aliyunpan-sync --restart=always -v \"\u003Cyour aliyunpan_config.json>:\u002Fhome\u002Fapp\u002Fconfig\u002Faliyunpan_config.json\" -v \"\u003Cyour local dir>:\u002Fhome\u002Fapp\u002Fdata\" -e ALIYUNPAN_PAN_DIR=\"\u003Cyour drive pan dir>\" -e ALIYUNPAN_SYNC_MODE=\"upload\" -e ALIYUNPAN_SYNC_POLICY=\"increment\" -e ALIYUNPAN_SYNC_DRIVE=\"backup\" -e ALIYUNPAN_SYNC_LOG=\"true\" tickstep\u002Faliyunpan-sync:v0.3.9 \r\n  \r\n\u003Cyour aliyunpan_config.json>: 用户已经登录成功并保存好的aliyunpan_config.json凭据文件\r\n\u003Cyour local dir>：本地目标目录，绝对路径，例如：\u002Ftickstep\u002FDocuments\u002F设计文档\r\nALIYUNPAN_PAN_DIR：云盘目标目录，绝对路径\r\nALIYUNPAN_SYNC_MODE：备份模式，支持: upload(备份本地文件到云盘),download(备份云盘文件到本地)\r\nALIYUNPAN_SYNC_POLICY：备份策略，支持：exclusive(排他备份文件，目标目录多余的文件会被删除),increment(增量备份文件，目标目录多余的文件不会被删除)\r\nALIYUNPAN_SYNC_DRIVE: 网盘，支持：backup(备份盘), resource(资源盘)\r\nALIYUNPAN_SYNC_LOG: 同步日志，true-开启同步日志显示，false-关闭同步日志\r\n```\r\ndocker-compose启动方式请查看：[docker-compose.yml](https:\u002F\u002Fgithub.com\u002Ftickstep\u002Faliyunpan\u002Fblob\u002Fmain\u002Fdocs\u002Fmanual.md#Docker%E8%BF%90%E8%A1%8C)   \r\n更详情文档请参考dockerhub网址：[tickstep\u002Faliyunpan-sync](https:\u002F\u002Fhub.docker.com\u002Fr\u002Ftickstep\u002Faliyunpan-sync)\r\n\r\n# 如何使用\r\n完整和详细的命令说明请查看手册：[命令手册](docs\u002Fmanual.md)   \r\n\r\n1. Windows\r\n   程序应在 命令提示符 (Command Prompt) 或 PowerShell 中运行.   \r\n   也可直接双击程序运行, 具体使用方法请参见 [命令列表及说明](docs\u002Fmanual.md#命令列表及说明)\r\n\r\n2. Linux \u002F macOS\r\n   程序应在 终端 (Terminal) 运行.   \r\n   具体使用方法请参见 [命令列表及说明](docs\u002Fmanual.md#命令列表及说明)   \r\n\r\n如果程序运行时输出乱码, 请检查下终端的编码方式是否为 `UTF-8`.   \r\n\r\n如果没有带任何参数运行程序, 程序将会进入仿Linux shell系统用户界面的CLI交互模式, 可直接运行相关命令.   \r\n在交互模式下, 光标所在行的前缀应为 `aliyunpan >`, 如果登录了帐号则格式为 `aliyunpan:\u003C工作目录> \u003C用户昵称>$ `  \r\n   \r\n程序内置了相关命令的使用说明，你可以通过运行`命令 -h`的方式获取命令的使用说明，例如：`upload -h`获取上传命令的使用说明。   \r\n\r\n## 基本使用\r\n本程序支持阿里云盘大多数命令操作，这里只介绍基本的使用，更多更详细的命令请查看手册：[命令手册](docs\u002Fmanual.md)。\r\n\r\n### 修改配置目录\r\n你可以指定程序配置文件的存储路径，如果没有指定，程序会使用默认的目录。   \r\n方法为设置环境变量`ALIYUNPAN_CONFIG_DIR`并指定一个存在的目录，例如linux下面可以这样指定\r\n```shell\r\nexport ALIYUNPAN_CONFIG_DIR=\u002Fhome\u002Ftickstep\u002Ftools\u002Faliyunpan\u002Fconfig\r\n```\r\n\r\n### 启动程序\r\n直接启动进入交互命令行\r\n```shell\r\n[tickstep@MacPro ~]$ aliyunpan\r\n提示: 方向键上下可切换历史命令.\r\n提示: Ctrl + A \u002F E 跳转命令 首 \u002F 尾.\r\n提示: 输入 help 获取帮助.\r\naliyunpan > \r\n```\r\n\r\n### 查看帮助\r\n```shell\r\naliyunpan > help\r\n\r\n...\r\n   阿里云盘:\r\n     album, abm   相簿(Beta)\r\n     cd           切换工作目录\r\n     download, d  下载文件\u002F目录\r\n     ls, l, ll    列出目录\r\n     mkdir        创建目录\r\n     mv           移动文件\u002F目录\r\n     pwd          输出工作目录\r\n     recycle      回收站\r\n     rename       重命名文件\r\n     rm           删除文件\u002F目录\r\n     share        分享文件\u002F目录\r\n     sync         同步备份功能\r\n     upload, u    上传文件\u002F目录\r\n...\r\n```\r\n\r\n### 登录\r\n需要先登录，已经登录过的可以跳过此步。登录是在浏览器上进行，你需要进行两次登录。\r\n```shell\r\naliyunpan > login\r\n请在浏览器打开以下链接进行登录，链接有效时间为5分钟。\r\n注意：你需要进行一次授权一次扫码的两次登录。\r\nhttps:\u002F\u002Fopenapi.alipan.com\u002Foauth\u002Fauthorize?client_id=cf9f70e8fc61430f8ec5ab5cadf31375&redirect_uri=https%3A%2F%2Fapi.tickstep.com%2Fauth%2Ftickstep%2Faliyunpan%2Ftoken%2Fopenapi%2F8206f0.....fb5db6b40336%2Fauth&scope=user:base,file:all:read,file:all:write\r\n阿里云盘登录成功:  tickstep\r\naliyunpan:\u002F tickstep$ \r\n```\r\n\r\n### 切换网盘\r\n支持切换备份盘、资源库，默认工作在备份盘下。\r\n```shell\r\naliyunpan:\u002F tickstep(备份盘)$ drive\r\n  #   DRIVE ID   网盘名称  \r\n  1    11519221   备份盘   \r\n  2  1311893110   资源库   \r\n  \r\n输入要切换的网盘 # 值 > 2\r\n切换到网盘：资源库                     \r\naliyunpan:\u002F tickstep(资源库)$ \r\n```\r\n\r\n### 查看文件列表\r\n```shell\r\naliyunpan:\u002F tickstep$ ls\r\n\r\n  #  文件大小       修改日期               文件(目录)                             \r\n  0         -  2021-11-03 13:32:22  临时\u002F                     \r\n  1         -  2021-07-10 07:44:34  好友的分享\u002F               \r\n  2         -  2021-07-09 22:11:22  我的项目\u002F                 \r\n  3         -  2021-07-09 22:10:37  我的游戏\u002F       \r\n  4         -  2021-07-09 22:10:10  我的文档\u002F       \r\n  5  349.86KB  2021-06-06 11:46:02  使用统计.xls                                            \r\n  6  503.57KB  2021-06-06 11:46:02  IMG_0098.JPG                                            \r\n  7   72.20KB  2021-06-06 11:46:02  IMG_0103.PNG \r\n       总: 3.20MB                   文件总数: 3, 目录总数: 7  \r\n----\r\n```\r\n\r\n### 下载文件\r\n通过 `aliyunpan config set -savedir \u003Csavedir>` 可以自定义下载文件保存的目录。\r\n```shell\r\naliyunpan:\u002F tickstep$ download IMG_0106.JPG\r\n\r\n[0] 当前文件下载最大并发量为: 5, 下载缓存为: 64.00KB\r\n[1] 加入下载队列: \u002FIMG_0106.JPG\r\n[1] ----\r\n文件ID: 60bc44f855814e19692a4958b4a8823a1a06e5de\r\n文件名: IMG_0106.JPG\r\n文件类型: 文件\r\n文件路径: \u002FIMG_0106.JPG\r\n\r\n[1] 准备下载: \u002FIMG_0106.JPG\r\n[1] 将会下载到路径: \u002Froot\u002FDownloads\u002F4d001d48564f43b..62874f04bbe6\u002FIMG_0106.JPG\r\n[1] 下载开始\r\n[1] ↓ 704.00KB\u002F1.48MB 0B\u002Fs(1.69MB\u002Fs) in 1.88s, left - ............\r\n[1] 下载完成, 保存位置: \u002Froot\u002FDownloads\u002F4d001d48564f43b..62874f04bbe6\u002FIMG_0106.JPG\r\n[1] 检验文件有效性成功: \u002Froot\u002FDownloads\u002F4d001d48564f43b..62874f04bbe6\u002FIMG_0106.JPG\r\n\r\n下载结束, 时间: 4秒, 数据总量: 1.48MB\r\n```\r\n或者使用UI面板展示下载进度(使用-ui选项)，更加直观和友好。\r\n```shell\r\naliyunpan:\u002F tickstep$ download \u002Fphoto -ui\r\n┌──────────────────────────────────────────────────────────────────────────────────────────┐\r\n│总速度: 341.59 KB\u002Fs | 文件: 0\u002F7 | 失败: 0 | 状态: 下载中 | 已用时间: 9s | 剩余时间: 51s         │\r\n│总进度: [===>                                                  ]   7.4% (896.00KB\u002F11.83MB) │\r\n│──────────────────────────────────────────────────────────────────────────────────────────│\r\n│ 1. IMG_0005.JPG                       [============>       ]  66.9% 258.42KB\u002Fs   3s      │\r\n│ 2. IMG_0007.JPG                       [============>       ]  67.3% 258.54KB\u002Fs   3s      │\r\n│ 3. IMG_0009.JPG                       [                    ]   0.0% 等待中        -       │\r\n│──────────────────────────────────────────────────────────────────────────────────────────│\r\n│[10:39:24] [0] 当前文件下载最大并发量为: 2, 单文件下载分片线程数为: 1, 下载缓存为: 64.00KB         │\r\n│[10:39:27] [2] 加入下载队列: \u002Fphoto\u002Fp\u002FIMG_0007.JPG                                          │\r\n│[10:39:27] [2] ---- 文件ID: 67dfe476a7573e76a2034626bd013f36581296ed 文件名: IMG_0007....  │\r\n│[10:39:27] [3] 准备下载: \u002Fphoto\u002Fp\u002FIMG_0007.JPG                                             │\r\n│[10:39:27] [2] 将会下载到路径: \u002FUsers\u002Ftickstep\u002FDownloads\u002F4d001d48564f43b3bc5662874f04bb...  │\r\n│[10:39:28] [2] 下载开始                                                                    │\r\n└──────────────────────────────────────────────────────────────────────────────────────────┘\r\n```\r\n\r\n### 上传文件\r\n```shell\r\naliyunpan:\u002F tickstep$ upload \u002FUsers\u002Ftickstep\u002FDownloads\u002Fapt.zip \u002Ftmp\r\n\r\n[0] 当前文件上传最大并发量为: 10, 上传分片大小为: 10.00MB\r\n[1] 加入上传队列: \u002FUsers\u002Ftickstep\u002FDownloads\u002Fapt.zip\r\n[1] 2022-08-13 13:41:22 准备上传: \u002FUsers\u002Ftickstep\u002FDownloads\u002Fapt.zip => \u002Ftmp\u002Fapt.zip\r\n[1] 2022-08-13 13:41:22 正在检测和创建云盘文件夹: \u002Ftmp\r\n[1] 2022-08-13 13:41:22 正在计算文件SHA1: \u002FUsers\u002Ftickstep\u002FDownloads\u002Fapt.zip\r\n[1] 2022-08-13 13:41:22 检测秒传中, 请稍候...\r\n[1] 2022-08-13 13:41:22 秒传失败，开始正常上传文件\r\n[1] ↑ 21.00MB\u002F21.00MB 702.53KB\u002Fs(702.70KB\u002Fs) in 15s ............\r\n[1] 2022-08-13 13:41:22 上传文件成功, 保存到网盘路径: \u002Ftmp\u002Fapt.zip\r\n[1] 2022-08-13 13:41:22 文件上传结果： 成功！ 耗时 18秒\r\n\r\n上传结束, 时间: 18秒, 数据总量: 21.00MB\r\n```\r\n或者使用UI面板展示上传进度(使用-ui选项)，更加直观和友好。\r\n```shell\r\naliyunpan:\u002F tickstep$ upload \u002FUsers\u002Ftickstep\u002FDownloads \u002Fphoto -ui\r\n┌─────────────────────────────────────────────────────────────────────────────────────────┐\r\n│总速度:   3.62 MB\u002Fs | 文件: 9\u002F14 | 失败: 0 | 状态: 上传中 | 已用时间: 12s | 剩余时间: 17s      │\r\n│总进度: [==========================>                          ]  51.7% (68.56MB\u002F132.73MB) │\r\n│─────────────────────────────────────────────────────────────────────────────────────────│\r\n│ 1. System Design Interview 2.zip     [====>               ]  26.2% 3.25MB\u002Fs     18s     │\r\n│ 2. ips_20260228.txt                  [                    ]   0.0% 0 B\u002Fs        -       │\r\n│ 3. neko-agent                        [                    ]   0.0% 0 B\u002Fs        -       │\r\n│─────────────────────────────────────────────────────────────────────────────────────────│\r\n│[11:14:49] [9] 2026-03-02 11:14:26 正在计算文件SHA1: \u002FUsers\u002Ftickstep\u002FDownloads\u002Ftest\u002Fda...  │\r\n│[11:14:49] [13] 2026-03-02 11:14:26 正在检测和创建云盘文件夹: \u002Fphoto\u002Fp2\u002Ftest\u002Foutput          │\r\n│[11:14:49] [9] 2026-03-02 11:14:26 检测秒传中, 请稍候...                                    │\r\n│[11:14:49] [9] 2026-03-02 11:14:26 秒传成功, 保存到网盘路径: \u002Fphoto\u002Fp2\u002Ftest\u002Fdata\u002Fips_2...    │\r\n│[11:14:49] [9] 2026-03-02 11:14:26 文件上传结果： 成功！ 耗时 12秒                           │\r\n│[11:14:49] 完成: \u002FUsers\u002Ftickstep\u002FDownloads\u002Ftest\u002Fdata\u002Fips_20260226.txt                    │\r\n└─────────────────────────────────────────────────────────────────────────────────────────┘\r\n```\r\n\r\n### 同步备份文件\r\n同步备份功能，支持备份本地文件到云盘，备份云盘文件到本地，双向同步备份三种模式。支持JavaScript插件对备份文件进行过滤。   \r\n   \r\n例如：将本地目录 `\u002Ftickstep\u002FDocuments\u002F设计文档` 中的文件备份上传到云盘目录 `\u002F备份盘\u002F我的文档`\r\n```shell\r\naliyunpan:\u002F tickstep$ sync start -ldir \"\u002Ftickstep\u002FDocuments\u002F设计文档\" -pdir \"\u002F备份盘\u002F我的文档\" -mode \"upload\" -drive \"backup\"\r\n\r\n启动同步备份进程\r\n备份配置文件：(使用命令行配置)\r\n链接类型：默认链接\r\n下载并发：2\r\n上传并发：2\r\n下载分片大小：1.00MB\r\n上传分片大小：10.00MB\r\n\r\n启动同步任务\r\n任务: 设计文档(de3d6b69a607497b73624bcca0845f19)\r\n同步模式: 备份本地文件（只上传）\r\n本地目录: \u002Ftickstep\u002FDocuments\u002F设计文档\r\n云盘目录: \u002F备份盘\u002F我的文档\r\n```\r\n\r\n## 更多命令\r\n更多更详细的命令请查看手册：[命令手册](docs\u002Fmanual.md)。\r\n\r\n# 常见问题\r\n## 如何开启Debug调试日志\r\n当需要定位问题，或者提交issue的时候抓取log，则需要开启debug日志。步骤如下：\r\n\r\n### 第一步\r\nLinux&MacOS   \r\n命令行运行\r\n```\r\nexport ALIYUNPAN_VERBOSE=1\r\n```\r\n\r\nWindows   \r\n不同版本会有些许不一样，请自行查询具体方法   \r\n设置示意图如下：   \r\n![](.\u002Fassets\u002Fimages\u002Fwin10-env-debug-config.png)\r\n\r\n### 第二步\r\n打开aliyunpan命令行程序，任何云盘命令都有类似如下日志输出   \r\n![](.\u002Fassets\u002Fimages\u002Fdebug-log-screenshot.png)\r\n\r\n## 如何登出和下线客户端\r\n阿里云盘单账户最多只允许同时登录 10 台设备   \r\n当出现这个提示：你账号已超出最大登录设备数量，请先下线一台设备，然后重启本应用，才可以继续使用   \r\n说明你的账号登录客户端已经超过数量，你需要先登出其他客户端才能继续使用，如下所示   \r\n   \r\nAPP手机端   \r\n![](.\u002Fassets\u002Fimages\u002Fapp-deregister-device.png)\r\nWeb网页端   \r\n![](.\u002Fassets\u002Fimages\u002Fweb-deregister-device.png)\r\n\r\n# 交流反馈\r\n提交issue: [issues页面](https:\u002F\u002Fgithub.com\u002Ftickstep\u002Faliyunpan\u002Fissues)   \r\n联系邮箱: tickstep@outlook.com\r\n\r\n# 鸣谢\r\n本项目大量借鉴了以下相关项目的功能&成果   \r\n> [tickstep\u002Faliyunpan-api](https:\u002F\u002Fgithub.com\u002Ftickstep\u002Faliyunpan-api)   \r\n> [tickstep\u002Fcloudpan189-go](https:\u002F\u002Fgithub.com\u002Ftickstep\u002Fcloudpan189-go)   \r\n> [kazutoiris\u002Fali_ecc](https:\u002F\u002Fgithub.com\u002Fkazutoiris\u002Fali_ecc)   ","阿里云盘命令行客户端是一个用于管理和操作阿里云盘文件的工具，支持多平台使用，并且具备JavaScript插件扩展功能。该项目采用Go语言编写，提供了丰富的文件管理功能，包括但不限于上传、下载（支持断点续传和并行下载）、同步备份以及相册批量下载等。此外，它还允许用户通过自定义JavaScript插件来实现更个性化的文件处理逻辑。该客户端非常适合需要在多种操作系统环境下进行高效文件管理的个人或企业用户，尤其是在嵌入式设备、NAS系统中部署时，能够有效提升工作效率。同时，对于追求极致下载速度的用户，还支持多用户联合下载模式。",2,"2026-06-11 03:37:55","high_star"]