{"id":18559077,"url":"https://github.com/linux-china/ali-oss-shell","last_synced_at":"2025-06-23T05:42:48.152Z","repository":{"id":4012655,"uuid":"5111508","full_name":"linux-china/ali-oss-shell","owner":"linux-china","description":"Aliyun OSS Shell","archived":false,"fork":false,"pushed_at":"2024-10-03T17:01:53.000Z","size":376,"stargazers_count":12,"open_issues_count":1,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-02T02:51:07.188Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/linux-china.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"MIT-LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2012-07-19T15:06:49.000Z","updated_at":"2025-01-10T07:04:08.000Z","dependencies_parsed_at":"2023-07-06T07:28:47.598Z","dependency_job_id":null,"html_url":"https://github.com/linux-china/ali-oss-shell","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linux-china%2Fali-oss-shell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linux-china%2Fali-oss-shell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linux-china%2Fali-oss-shell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linux-china%2Fali-oss-shell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linux-china","download_url":"https://codeload.github.com/linux-china/ali-oss-shell/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248144158,"owners_count":21054876,"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-11-06T21:41:59.659Z","updated_at":"2025-04-10T02:30:38.553Z","avatar_url":"https://github.com/linux-china.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"介绍\n====================================\n阿里云弹性存储终端控制台，通过控制台方式管理OSS云端的Bucket和Object。\n\n### OSS Console手册\n\n关于OSS Console的手册，请访问： https://github.com/linux-china/ali-oss-shell/wiki\n\n### 开发步骤\n\nCheck out代码，编译，最后执行。步骤如下：\n\n    git clone git://github.com/linux-china/ali-oss-shell.git\n    cd ali-oss-shell\n    mvn -DskipTests clean package\n\n接下来执行\n\n    java -jar target/ali-oss-java-cli-1.0.0.jar\n\n即可进入控制台执行操作。\n打包分发：\n\n    mvn -DskipTests clean package assembly:assembly\n\n然后将target目录下tar.gz和zip文件提供下载即可。\n\n### 开发指南\n\n整个系统包含ConfigService和AliyunOssService，ConfigService包含相关的配置的服务，如保存Access Token和全局配置等。\nAliyunOssService负责和OSS进行交互，如获取OSS Object信息，上传文件等。\n由于OSS主要包含Bucket和Object，所以我们介入OSSUri类来标识Object，以后相关的操作都是基于object uri完成的。\n整体类图如下：\n\n![系统类图](https://github.com/linux-china/ali-oss-java-cli/wiki/assets/img/ali-oss-java-cli-class-diagram.png)\n\n### 如何调试控制台程序\n\nOSS Console运行在terminal中，当然你也可以在IDEA中直接以debug方式运行程序，但是一些功能会缺失，如颜色显示，自动提示等，这个时候需在terminal中运行，但是我们也需要调试程序，\n所以我们我们要以debug状态启动App，然后在IDEA中以Remote Debug方式连接到JVM上进行调试。运行参数如下\n\n    java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 -jar target/ali-oss-java-cli-1.0.0.jar\n\n接下来就是在IDEA中创建一个Remote Debug运行项即可。\n\n### OSS Console颜色列表\n\n整个OSS Console主要涉及四种颜色：绿色、白色、黄色和红色。\n\n* 绿色: Spring Shell的默认颜色，显示命令返回的字符串，通常是内容，提示消息等。\n* 白色: Console在操作中输出的文本，如批量上传、下载和删除等。\n* 黄色: 用于提示，如提示用户选择bukcet，设置必需参数等。\n* 红色: 系统中的错误信息，如和Aliyun OSS通讯异常、非法操作等。\n\n**注意:** 命令的返回值可以使用wrappedAsRed进行文本颜色设置，可以显示不同的颜色。\n\n### Road Map\n\n* 分片上传\n* 允许设置一次显示object的最大数量\n* 多参数时key为空的自动提示\n* 统计支持：dump bucket下的所有object的基本信息，然后进行Lucene索引，支持自定义查询。\n\n### Change Log\n\n* 20220212: 更新至Spring Boot 2.6.3, Spring Shell 2.1.0-M2\n* 20121031: 将域名调整为oss.aliyuncs.com，api endpoint也进行了调整\n* 20121031: 修复complete有候选项时的错误提示\n* 20121031: 更新aliyun-openservice版本为1.0.8\n\n### Issues\n\n* List Objects能够显示匹配的object总数\n\n### 控制台截屏\n\n![OSS Console](https://github.com/linux-china/ali-oss-java-cli/wiki/assets/img/console_shot.png)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinux-china%2Fali-oss-shell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinux-china%2Fali-oss-shell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinux-china%2Fali-oss-shell/lists"}