{"id":13439604,"url":"https://github.com/tickstep/cloudpan189-go","last_synced_at":"2025-04-13T07:50:07.531Z","repository":{"id":37354119,"uuid":"267333226","full_name":"tickstep/cloudpan189-go","owner":"tickstep","description":"天翼云盘命令行客户端(CLI)，基于GO语言实现","archived":false,"fork":false,"pushed_at":"2024-05-16T02:17:04.000Z","size":12509,"stargazers_count":640,"open_issues_count":60,"forks_count":112,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-04-13T07:50:01.950Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tickstep.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-27T13:55:33.000Z","updated_at":"2025-04-11T08:50:38.000Z","dependencies_parsed_at":"2024-06-18T20:05:15.827Z","dependency_job_id":"3bd9557f-8d64-46c0-b877-e8ee1c0472b2","html_url":"https://github.com/tickstep/cloudpan189-go","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tickstep%2Fcloudpan189-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tickstep%2Fcloudpan189-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tickstep%2Fcloudpan189-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tickstep%2Fcloudpan189-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tickstep","download_url":"https://codeload.github.com/tickstep/cloudpan189-go/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248681494,"owners_count":21144700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T03:01:15.492Z","updated_at":"2025-04-13T07:50:07.509Z","avatar_url":"https://github.com/tickstep.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# 关于\r\n天翼云盘CLI，基于GO语言实现。仿 Linux shell 文件处理命令的天翼云盘命令行客户端。\r\n\r\n# 特色\r\n1. 多平台支持, 支持 Windows, macOS, linux, android, iOS等\r\n2. 天翼云盘多用户支持\r\n3. 支持个人云，家庭云无缝切换\r\n4. 支持导入/导出功能，快速备份（导出）和恢复（导入）网盘文件。利用该功能可以进行跨网盘迁移文件\r\n5. [下载](docs/manual.md#下载文件目录)网盘内文件, 支持多个文件或目录下载, 支持断点续传和单文件并行下载\r\n6. [上传](docs/manual.md#上传文件目录)本地文件, 支持多个文件或目录上传\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- [如何使用](#如何使用)\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  * [1. 如何开启Debug调试日志](#1-如何开启Debug调试日志)\r\n- [交流反馈](#交流反馈)\r\n- [鸣谢](#鸣谢)\r\n\r\n# 如何安装\r\n## 直接下载安装\r\n可以直接在本仓库 [发布页](https://github.com/tickstep/cloudpan189-go/releases) 下载安装包，解压后使用。\r\n\r\n要特别注意安装包的标签，不同的标签对应不同架构的系统，相关版本文件的标签说明如下：\r\n1. arm / armv5 / armv7 : 适用32位ARM系统\r\n2. arm64 : 适用64位ARM系统\r\n3. 386 / x86 : 适用32系统，包括Intel和AMD的CPU系统\r\n4. amd64 / x64 : 适用64位系统，包括Intel和AMD的CPU系统\r\n5. mips : 适用MIPS指令集的CPU，例如国产龙芯CPU\r\n6. macOS amd64适用Intel CPU的机器，macOS arm64目前主要是适用苹果M1芯片的机器\r\n7. iOS arm64适用iPhone手机，并且必须是越狱的手机才能正常运行\r\n\r\n参考例子：\r\n```shell\r\nwget https://github.com/tickstep/cloudpan189-go/releases/download/v0.1.3/cloudpan189-go-v0.1.3-linux-amd64.zip\r\nunzip cloudpan189-go-v0.1.3-linux-amd64.zip\r\ncd cloudpan189-go-v0.1.3-linux-amd64\r\n./cloudpan189-go\r\n```\r\n\r\n## apt安装\r\n适用于apt包管理器的系统，例如Ubuntu，国产deepin深度操作系统等。目前只支持amd64和arm64架构的机器。\r\n```shell\r\nsudo curl -fsSL http://file.tickstep.com/apt/pgp | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/tickstep-packages-archive-keyring.gpg \u003e /dev/null \u0026\u0026 echo \"deb [signed-by=/etc/apt/trusted.gpg.d/tickstep-packages-archive-keyring.gpg arch=amd64,arm64] http://file.tickstep.com/apt cloudpan189-go main\" | sudo tee /etc/apt/sources.list.d/tickstep-cloudpan189-go.list \u003e /dev/null \u0026\u0026 sudo apt-get update \u0026\u0026 sudo apt-get install -y cloudpan189-go\r\n \r\n```\r\n\r\n## yum安装\r\n适用于yum包管理器的系统，例如CentOS、RockyLinux等。目前只支持amd64和arm64架构的机器。\r\n```shell\r\nsudo curl -fsSL http://file.tickstep.com/rpm/cloudpan189-go/cloudpan189-go.repo | sudo tee /etc/yum.repos.d/tickstep-cloudpan189-go.repo \u003e /dev/null \u0026\u0026 sudo yum install cloudpan189-go -y\r\n \r\n```\r\n\r\n## brew安装\r\n适用于brew包管理器的系统，主要是苹果macOS系统。目前只支持amd64和arm64架构(Apple Silicon)的机器。\r\n```shell\r\nbrew install cloudpan189-go\r\n    \r\n```\r\n由于brew默认安装在系统目录下面，这样配置文件也默认存放在系统目录里了，建议设置系统变量进行配置文件的单独存储，例如\r\n```shell\r\nexport CLOUD189_CONFIG_DIR=/Users/tickstep/Applications/cloud189/config\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.cloudpan189-go --silent\r\n \r\n```\r\n\r\n# 如何使用\r\n完整和详细的命令说明请查看手册：[命令手册](docs/manual.md)\r\n\r\n1. Windows\r\n   程序应在 命令提示符 (Command Prompt) 或 PowerShell 中运行.   \r\n   也可直接双击程序运行, 具体使用方法请参见 [命令列表及说明](docs/manual.md#命令列表及说明)\r\n\r\n2. Linux / macOS\r\n   程序应在 终端 (Terminal) 运行.   \r\n   具体使用方法请参见 [命令列表及说明](docs/manual.md#命令列表及说明)\r\n\r\n如果程序运行时输出乱码, 请检查下终端的编码方式是否为 `UTF-8`.\r\n\r\n如果没有带任何参数运行程序, 程序将会进入仿Linux shell系统用户界面的CLI交互模式, 可直接运行相关命令.   \r\n在交互模式下, 光标所在行的前缀应为 `cloudpan189-go \u003e`, 如果登录了帐号则格式为 `cloudpan189-go:\u003c工作目录\u003e \u003c用户昵称\u003e$ `\r\n\r\n程序内置了相关命令的使用说明，你可以通过运行`命令 -h`的方式获取命令的使用说明，例如：`upload -h`获取上传命令的使用说明。\r\n\r\n## 基本使用\r\n本程序支持天翼云盘大多数命令操作，这里只介绍基本的使用，更多更详细的命令请查看手册：[命令手册](docs/manual.md)。\r\n\r\n### 修改配置目录\r\n你可以指定程序配置文件的存储路径，如果没有指定，程序会使用默认的目录。   \r\n方法为设置环境变量`CLOUD189_CONFIG_DIR`并指定一个存在的目录，例如linux下面可以这样指定\r\n```shell\r\nexport CLOUD189_CONFIG_DIR=/Users/tickstep/Applications/cloud189/config\r\n```\r\n\r\n### 启动程序\r\n直接启动进入交互命令行\r\n```shell\r\n[tickstep@MacPro ~]$ cloudpan189-go\r\n提示: 方向键上下可切换历史命令.\r\n提示: Ctrl + A / E 跳转命令 首 / 尾.\r\n提示: 输入 help 获取帮助.\r\ncloudpan189-go \u003e \r\n```\r\n\r\n### 查看帮助\r\n```shell\r\ncloudpan189-go \u003e help\r\n...\r\n   天翼云盘:\r\n     backup           备份文件或目录\r\n     cd               切换工作目录\r\n     cp               拷贝文件/目录\r\n     download, d      下载文件/目录\r\n     export           导出文件/目录元数据\r\n     import           导入文件\r\n     ls, l, ll        列出目录\r\n     mkdir            创建目录\r\n     mv               移动文件/目录\r\n     pwd              输出工作目录\r\n     rapidupload, ru  手动秒传文件\r\n     rename           重命名文件\r\n     rm               删除文件/目录\r\n     share            分享文件/目录\r\n     upload, u        上传文件/目录\r\n     xcp              转存拷贝文件/目录，个人云和家庭云之间转存文件\r\n...\r\n```\r\n\r\n### 登录\r\n需要先登录，已经登录过的可以跳过此步。登录成功后账号会加密存储在配置文件中，下一次程序启动会自动登录无需再次输入账号。\r\n```shell\r\ncloudpan189-go \u003e login -username=131xxxxxx01@189.cn -password=123xxx\r\n\r\n天翼云盘登录成功:  tickstep\r\ncloudpan189-go:/ tickstep$ \r\n```\r\n\r\n### 查看文件列表\r\n```shell\r\ncloudpan189-go:/ tickstep$ ls\r\n  #   文件大小       修改日期               文件(目录)          \r\n   0         -  2023-03-31 00:04:59  同步盘/                    \r\n   1         -  2023-03-31 00:04:59  我的图片/                  \r\n   2         -  2023-03-31 00:04:59  我的音乐/                  \r\n   3         -  2023-03-31 00:04:59  我的视频/                  \r\n   4         -  2023-03-31 00:04:59  我的文档/                  \r\n   5         -  2023-03-31 00:04:59  我的应用/                        \r\n   6         -  2022-09-07 18:43:00  我的项目/                  \r\n   7         -  2023-03-26 22:28:07  cdn/                       \r\n   8         -  2023-04-02 11:00:27  我的资源/                  \r\n   9   47.83KB  2020-05-23 09:24:02  512.png                   \r\n  10   55.35KB  2020-05-23 09:26:47  wx-mini-app-logo.png    \r\n        总: 103.18KB                       文件总数: 2, 目录总数: 9\r\n----\r\n```\r\n\r\n### 下载文件\r\n```shell\r\ncloudpan189-go:/ tickstep$ download 512.png\r\n\r\n[0] 提示: 当前下载最大并发量为: 5, 下载缓存为: 65536\r\n[1] 加入下载队列: /我的图片/512.png\r\n\r\n[1] ----\r\n文件ID: 5150329025489514\r\n文件名: 512.png\r\n文件类型: 文件\r\n文件路径: /我的图片/512.png\r\n\r\n[1] 准备下载: /我的图片/512.png\r\n[1] 将会下载到路径: /Users/tickstep/Downloads/761169075/我的图片/512.png\r\n\r\n[1] 下载开始\r\n\r\n\r\n[1] 下载完成, 保存位置: /Users/tickstep/Downloads/761169075/我的图片/512.png\r\n[1] 检验文件有效性成功: /Users/tickstep/Downloads/761169075/我的图片/512.png\r\n\r\n下载结束, 时间: 1.361s, 数据总量: 47.830078KB\r\ncloudpan189-go:/ tickstep$ \r\n```\r\n支持并发同时下载文件，默认并发数是5个文件，你可以通过config进行修改。同时支持文件过滤。\r\n\r\n### 上传文件\r\n```shell\r\ncloudpan189-go:/ tickstep$ upload /Users/tickstep/Downloads/app.zip /tmp\r\n2023-04-06 22:06:17 [1] 加入上传队列: /Users/tickstep/Downloads/app.zip\r\n[1] 准备上传: /Users/tickstep/Downloads/app.zip=\u003e/tmp/app.zip\r\n[1] 检测秒传中, 请稍候...\r\n[1] 秒传失败，开始正常上传文件\r\n[1] ↑ 7.21MB/7.21MB 0B/s in 3s ................\r\n[1] 上传文件成功, 保存到网盘路径: /tmp/app.zip\r\n2023-04-06 22:06:23 [1] 文件上传结果：成功！  耗时 5.400578399s\r\n\r\n上传结束, 时间: 5.4s, 总大小: 7.211734MB\r\ncloudpan189-go:/ tickstep$ \r\n```\r\n上传也支持并发，默认并发数是10个文件，你可以通过config进行修改。同时支持文件过滤。\r\n\r\n### 创建分享链接\r\n```shell\r\ncloudpan189-go:/ tickstep$ share set /tmp/app.zip \r\n路径: /tmp/app.zip\r\n链接: https://cloud.189.cn/t/UbqQnuEnyAJn（访问码：nq0c）\r\ncloudpan189-go:/ tickstep$ \r\n```\r\n\r\n### 签到\r\n```shell\r\ncloudpan189-go:/ tickstep$ sign\r\n签到成功，获得37M空间\r\n第1次抽奖成功: 天翼云盘50M空间\r\n第2次抽奖成功: 天翼云盘50M空间\r\ncloudpan189-go:/ tickstep$ \r\n```\r\n\r\n## 更多命令\r\n更多更详细的命令请查看手册：[命令手册](docs/manual.md)。\r\n\r\n# 常见问题\r\n## 1 如何开启Debug调试日志\r\n当需要定位问题，或者提交issue的时候抓取log，则需要开启debug日志。步骤如下：\r\n\r\n### 第一步\r\nLinux\u0026MacOS   \r\n命令行运行\r\n```\r\nexport CLOUD189_VERBOSE=1\r\n```\r\n\r\nWindows   \r\n不同版本会有些许不一样，请自行查询具体方法   \r\n设置示意图如下：\r\n![](./assets/images/win10-env-debug-config.png)\r\n\r\n### 第二步\r\n打开cloudpan189-go命令行程序，任何云盘命令都有类似如下日志输出\r\n![](./assets/images/debug-log-screenshot.png)\r\n\r\n# 交流反馈\r\n提交issue: [issues页面](https://github.com/tickstep/cloudpan189-go/issues)   \r\n联系邮箱: tickstep@outlook.com\r\n\r\n# 鸣谢\r\n本项目大量借鉴了以下相关项目的功能\u0026成果   \r\n\u003e [iikira/BaiduPCS-Go](https://github.com/iikira/BaiduPCS-Go)   \r\n\u003e [Aruelius/cloud189](https://github.com/Aruelius/cloud189)   \r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftickstep%2Fcloudpan189-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftickstep%2Fcloudpan189-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftickstep%2Fcloudpan189-go/lists"}