本插件为谷神整合基于阿里云(含阿里云私有化部署)技术标准的云对象存储OSS接口插件,若您项目需要使用,则使用步骤如下:

  1. 目前已知可使用的平台:阿里云、阿里云私有化平台
  2. 下载插件包:
  3. 上传插件包到您需要调用的项目中(所有微服务及主数据服务都需要关联使用)
  4. 配置插件:
    # 文件服务适配器:固定值不可修改
    guthon.file-service.adapter = com.guthon.plugin.oss.ali.comps.AliFileService
    # 文件服务器外网共有区访问根地址(同谷神配套版设置)
    golden.file-service.url = https://[bucket-2].oss-cn-hangzhou.aliyuncs.com
    # 文件服务器端点地址(如:杭州区 oss-cn-hangzhou.aliyuncs.com )
    guthon.file-service.oss.ali.endpoint= 
    # 是否启用cname(默认: true ,false 禁用)
    guthon.file-service.oss.ali.support-cname=
    # 签名算法版本,可选值: 1,2,4,默认:4
    guthon.file-service.oss.ali.signature-version=4
    # 文件服务器私有存储区(bucket)桶
    guthon.file-service.oss.ali.private-bucket = bucket-1
    # 文件服务器公有存储区(bucket)桶(需要将此桶设置为可匿名访问)
    guthon.file-service.oss.ali.public-bucket = bucket-2 
    # 文件服务器通信编码
    guthon.file-service.oss.ali.access-key = ak
    # 文件服务器通信秘钥
    guthon.file-service.oss.ali.secret-key = sk
    # 区域编码,如:杭州 cn-hangzhou
    guthon.file-service.oss.ali.region = 
  5. 重启服务后,文件服务即可生效,开发者不需要额外处理,附件上传就会把文件上传到云存储服务。
  6. 关于HTTP代理,本插件支持HTTP代理设置,设置方法同谷神HTTP代理设置方法。
  7. 包含依赖包及版本:
序号 groupId artifactId 版本
1 com.aliyun.oss aliyun-sdk-oss 3.18.3
2 com.aliyun aliyun-java-sdk-ram 3.1.0
3 com.aliyun aliyun-java-sdk-kms 2.11.0
4 com.aliyun aliyun-java-sdk-core 4.5.10
5 com.aliyun java-trace-api 0.2.11-beta
6 com.aliyun aliyun-java-core 0.2.11-beta
7 org.jdom jdom2 2.0.6.1
8 org.codehaus.jettison jettison 1.5.4
9 javax.xml.bind jaxb-api 2.3.1
10 javax.activation javax.activation-api 1.2.0
11 org.jacoco org.jacoco.agent 0.8.5
12 org.ini4j ini4j 0.5.4
13 io.opentracing opentracing-api 0.33.0
14 io.opentracing opentracing-util 0.33.0
15 io.opentracing opentracing-noop 0.33.0
16 io.opentelemetry opentelemetry-api 1.38.0
17 io.opentelemetry opentelemetry-context 1.38.0
18 org.reactivestreams reactive-streams 1.0.3
文档更新时间: 2025-11-11 09:20   作者:weir