{"id":44376446,"url":"https://github.com/opcooc/opcooc-storage-spring-boot-starter","last_synced_at":"2026-02-11T21:11:14.888Z","repository":{"id":55408673,"uuid":"324986934","full_name":"opcooc/opcooc-storage-spring-boot-starter","owner":"opcooc","description":"opcooc-storage-boot-starter是一个基于aws s3快速集成多storage client的启动器","archived":false,"fork":false,"pushed_at":"2023-06-27T02:15:59.000Z","size":316,"stargazers_count":8,"open_issues_count":0,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2023-06-27T04:15:02.715Z","etag":null,"topics":["aws-s3","client","cos","kodo","minio","oss","storage"],"latest_commit_sha":null,"homepage":"https://github.com/opcooc/opcooc-storage-spring-boot-starter","language":"Java","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/opcooc.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}},"created_at":"2020-12-28T10:55:35.000Z","updated_at":"2023-06-27T04:15:02.715Z","dependencies_parsed_at":"2023-01-19T15:15:08.459Z","dependency_job_id":null,"html_url":"https://github.com/opcooc/opcooc-storage-spring-boot-starter","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/opcooc/opcooc-storage-spring-boot-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opcooc%2Fopcooc-storage-spring-boot-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opcooc%2Fopcooc-storage-spring-boot-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opcooc%2Fopcooc-storage-spring-boot-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opcooc%2Fopcooc-storage-spring-boot-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opcooc","download_url":"https://codeload.github.com/opcooc/opcooc-storage-spring-boot-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opcooc%2Fopcooc-storage-spring-boot-starter/sbom","scorecard":{"id":708193,"data":{"date":"2025-08-11","repo":{"name":"github.com/opcooc/opcooc-storage-spring-boot-starter","commit":"4992f9ede00310a373e2fee337c07ac7b6e5886b"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.3,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/build.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"project is archived","details":["Warn: Repository is archived."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":9,"reason":"binaries present in source code","details":["Warn: binary detected: gradle/wrapper/gradle-wrapper.jar:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/opcooc/opcooc-storage-spring-boot-starter/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/opcooc/opcooc-storage-spring-boot-starter/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/opcooc/opcooc-storage-spring-boot-starter/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/opcooc/opcooc-storage-spring-boot-starter/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/opcooc/opcooc-storage-spring-boot-starter/build.yml/main?enable=pin","Warn: downloadThenRun not pinned by hash: .github/workflows/build.yml:52","Warn: downloadThenRun not pinned by hash: .github/workflows/build.yml:53","Info:   0 out of   5 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 downloadThenRun dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}}]},"last_synced_at":"2025-08-22T07:20:53.288Z","repository_id":55408673,"created_at":"2025-08-22T07:20:53.288Z","updated_at":"2025-08-22T07:20:53.288Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29345433,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T20:11:40.865Z","status":"ssl_error","status_checked_at":"2026-02-11T20:10:41.637Z","response_time":97,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["aws-s3","client","cos","kodo","minio","oss","storage"],"created_at":"2026-02-11T21:11:14.014Z","updated_at":"2026-02-11T21:11:14.881Z","avatar_url":"https://github.com/opcooc.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/opcooc/opcooc-storage-spring-boot-starter\"\u003e\n   \u003cimg alt=\"opcooc-storage-logo\" src=\"https://gitee.com/opcooc/opcooc-storage-spring-boot-starter/raw/main/doc/img/opcooc-storage.png\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eopcooc-storage-spring-boot-starter 是一个基于aws s3快速集成多storage client的启动器\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003ca target=\"_blank\" href=\"https://search.maven.org/search?q=g:com.opcooc%20AND%20a:opcooc-storage-spring-boot-starter\"\u003e\n\t\t\u003cimg alt='maven' src=\"https://img.shields.io/maven-central/v/com.opcooc/opcooc-storage-spring-boot-starter\" /\u003e\n\t\u003c/a\u003e\n\t\u003ca target=\"_blank\" href=\"https://www.apache.org/licenses/LICENSE-2.0.html\"\u003e\n\t\t\u003cimg alt='license' src=\"https://img.shields.io/badge/license-Apache%202-4EB1BA.svg?style=square\" /\u003e\n\t\u003c/a\u003e\n\t\u003ca target=\"_blank\" href=\"https://www.oracle.com/technetwork/java/javase/downloads/index.html\"\u003e\n\t\t\u003cimg alt='JDK' src=\"https://img.shields.io/badge/JDK-1.8+-green.svg\" /\u003e\n\t\u003c/a\u003e\n\t\u003ca target=\"_blank\" href=\"https://github.com/opcooc/opcooc-storage-spring-boot-starter/wiki\" title=\"参考文档\"\u003e\n\t\t\u003cimg alt='Docs' src=\"https://img.shields.io/badge/Docs-latest-blueviolet.svg\" /\u003e\n\t\u003c/a\u003e\n\t\u003ca target=\"_blank\" href='https://gitee.com/opcooc/opcooc-storage-spring-boot-starter/stargazers'\u003e\n\t  \u003cimg alt='gitee star' src='https://gitee.com/opcooc/opcooc-storage-spring-boot-starter/badge/star.svg?theme=white'/\u003e\n\t\u003c/a\u003e\n\t\u003ca target=\"_blank\" href='https://github.com/opcooc/opcooc-storage-spring-boot-starter'\u003e\n\t\t\u003cimg alt=\"github star\" src=\"https://img.shields.io/github/stars/opcooc/opcooc-storage-spring-boot-starter?style=social\"/\u003e\n\t\u003c/a\u003e\n\t\u003ca target=\"_blank\" href='https://gitter.im/opcooc/opcooc-storage-spring-boot-starter?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge'\u003e\n\t\t\u003cimg alt=\"gitter\" src=\"https://img.shields.io/gitter/room/opcooc/opcooc-storage-spring-boot-starter\"/\u003e\n\t\u003c/a\u003e\n\n\u003c/p\u003e\n\n-------------------------------------------------------------------------------\n\n- QQ交流群 `789585778`，可获取各项目详细图文文档、疑问解答\n[![](http://pub.idqqimg.com/wpa/images/group.png)](https://jq.qq.com/?_wv=1027\u0026k=iRannIfW)\n\n## 文档 | Documentation\n\n[![CN doc](https://img.shields.io/badge/文档-中文版-blue.svg)](README.md)\n[![EN doc](https://img.shields.io/badge/document-English-blue.svg)](README.md)\n\n\n## 特性\n\n1. 支持 **多客户端动态切换** (使用内置的spel动态参数，session，header获取客户端驱动, 还支持支持自定义获取哦)。\n2. 支持 **自定义注解** ，需继承OS(支撑多客户端动态切换的关键)。\n3. 提供 **自定义客户端驱动来源** 方案。\n4. 提供项目启动后 **动态增加移除客户端驱动** 方案(增加移除后会有Event消息通知)。\n5. 支持  **多层客户端嵌套切换** 。（ServiceA \u003e\u003e\u003e  ServiceB \u003e\u003e\u003e ServiceC）。\n6. 提供 **bucketConverter** bucketName 自定义转换器(有自动创建bucketName判断，会通过环境变量判断)。\n7. 提供 **objectConverter** objectName 自定义转换器。\n8. 支持 [aws s3](https://docs.aws.amazon.com/AmazonS3/latest/gsg/GetStartedWithS3.html), \n[阿里云oss](https://help.aliyun.com/document_detail/64919.html), \n[minio](http://docs.minio.org.cn/docs/master/how-to-use-aws-sdk-for-java-with-minio-server), \n[腾讯云cos](https://cloud.tencent.com/document/product/436/37421), \n[七牛云kodo](https://developer.qiniu.com/kodo/manual/4086/aws-s3-compatible) 等。\n\n## 快速开始\n\n-   引用依赖\n    -   Maven:\n        ```xml\n            \u003cdependency\u003e\n              \u003cgroupId\u003ecom.opcooc\u003c/groupId\u003e\n              \u003cartifactId\u003eopcooc-storage-spring-boot-starter\u003c/artifactId\u003e\n              \u003cversion\u003e1.2.2\u003c/version\u003e\n            \u003c/dependency\u003e\n        ```\n    -   Gradle\n        ```groovy\n        implementation 'com.opcooc:opcooc-storage-spring-boot-starter:1.2.2'\n        ```\n\n## 添加配置，在 `application.yml` 中添加配置信息\n-   基础yaml配置。\n\n    ```yaml\n          storage:\n            primary: s3_minio #默认的客户端类型\n            strict: true #是否启用严格模式,默认不启动. 严格模式下未匹配到客户端直接报错, 非严格模式下则使用默认客户端primary所设置的客户端\n            enabled: true #是否开启 opcooc-storage\n            driver:\n              s3_minio: #配置文件key名称\n                type: S3 #默认驱动类型(默认为S3)\n                default-bucket: opcooc #默认主目录(需要保证唯一)\n                endpoint: http://xxx.com #访问域名\n                username: xxx #账号\n                password: xxx #密码\n                region: cn-north-1 #区域\n                path-style: true #路径样式(默认为true)\n                auto-create-bucket: true #是否自动创建目标bucket\n\n    ```\n-   其他yaml配置(oss, cos, kodo)。\n    ```yaml\n          storage:\n            primary: s3_minio #默认的客户端类型\n            strict: true #是否启用严格模式,默认不启动. 严格模式下未匹配到客户端直接报错, 非严格模式下则使用默认客户端primary所设置的客户端\n            enabled: true #是否开启 opcooc-storage\n            driver:\n              s3_oss:\n                default-bucket: opcooc\n                endpoint: http://oss-cn-shanghai.aliyuncs.com\n                username: xxx\n                password: xxx\n                path-style: false\n                region: cn-north-1\n                auto-create-bucket: true\n              s3_cos:\n                default-bucket: opcooc\n                endpoint: https://bucketname.cos.ap-shanghai.myqcloud.com\n                username: xxx\n                password: xxx\n                region: cn-north-1\n                auto-create-bucket: true\n              s3_kodo:\n                default-bucket: opcooc\n                endpoint: http://s3-cn-south-1.qiniucs.com\n                username: xxx\n                password: xxx\n                region: cn-north-1\n                auto-create-bucket: true\n    ```\n    \n-   使用 @OS 切换客户端驱动。\n\n    **@OS** 可以注解在方法上或类上，**同时存在就近原则 方法上注解 优先于 类上注解**。\n    \n    |     **注解**   |                   **结果**          |\n    | :-----------: | :--------------------------------------: |\n    |    没有@OS     |                默认客户端驱动             |\n    | @OS(\"driverName\") | driverName为具体某个客户端驱动的名称    |\n    \n-   然后就开始玩耍吧~\n\n    ```java\n        @RestController\n        @OS(\"#tenantName\")\n        @RequestMapping(\"/api\")\n        @RequiredArgsConstructor\n        public class ClientController {\n        \n            private final StorageHelper client;\n    \n            @OS(\"#tenantName\")\n            @PostMapping(\"/createFolder\")\n            public void createFolder(@RequestParam(defaultValue = \"s3_minio\") String tenantName, @RequestParam String folderName) {\n                client.createFolder(SetFolderArgs.builder().bucketName(BUCKET_NAME).folderName(folderName).build());\n            }\n        \n        }\n    ```\n## 术语表\n\n   | **对象存储**    | **文件系统**|\n   | :-----------: | :-----------:|\n   |Object|对象或者文件|\n   |Bucket|主目录(存储空间)|\n   |Endpoint|访问域名|\n   |Region|地域或者数据中心|\n   |Object Meta|文件元信息。用来描述文件信息，例如长度，类型等|\n   |Data|文件数据|\n   |Key|文件名|\n   |ACL (Access Control List)|存储空间或者文件的权限|\n   \n-------------------------------------------------------------------------------\n\n\u003e 该展示只是 opcooc-storage-spring-boot-starter 功能的一小部分。如果您想了解更多信息，请参阅项目[demo项目](https://github.com/opcooc/opcooc-storage-spring-boot-starter-example) 或 wiki: [documentation](https://github.com/opcooc/opcooc-storage-spring-boot-starter/wiki).\n\n## 友情链接\n\n- [UMS（用户管理脚手架集成）](https://gitee.com/pcore/UMS)\n\n- [justAuth-spring-security-starter（spring security 集成 JustAuth 实现第三方授权登录）](https://gitee.com/pcore/just-auth-spring-security-starter)\n\n## 参考项目\n\n| Project                                                              |\n| -------------------------------------------------------------------- |\n| [dynamic-datasource-spring-boot-starter](https://gitee.com/baomidou/dynamic-datasource-spring-boot-starter)|\n\n## 参与贡献\n\n1. Fork [本项目](https://github.com/opcooc/opcooc-storage-spring-boot-starter)\n2. 新建 Feat_xxx 分支\n3. 提交代码\n4. 新建 Pull Request\n\n## License\n\nopcooc-storage-spring-boot-starter is under the Apache 2.0 license. See the [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopcooc%2Fopcooc-storage-spring-boot-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopcooc%2Fopcooc-storage-spring-boot-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopcooc%2Fopcooc-storage-spring-boot-starter/lists"}