使用文档 / S3 完整配置 · 中国科技云数据胶囊

中国科技云数据胶囊

中国科技云数据胶囊 提供 20GB 免费对象存储,兼容 S3 API,适合个人笔记同步、文件中转等场景。

适用场景

  • 希望使用免费、稳定的国内 S3 兼容存储。
  • 已有科技云通行证并完成实名认证(升级至 20GB 空间)。

获取 S3 凭证

  1. 登录 数据胶囊。
  2. 创建数据空间(即 S3 Bucket)。
  3. 进入该空间的 客户端访问 页面。
  4. 点击 创建 AccessKey,保存 Access Key ID 与 Secret Access Key(Secret 只显示一次)。

创建 AccessKey(关键)

在「客户端访问」页创建 AccessKey 时,客户端应用选择 S3Drive。

数据胶囊会把 AccessKey 绑定到所选应用。请求的 User-Agent 必须是 S3Drive,否则返回 401。虾传认出 *.cstcloud.cn 后会自动带上这个 User-Agent,设置页里不用再选客户端应用。

如果这把 Key 之前绑的是 S3Browser、Rclone 或其他应用,请在控制台重新创建一把、并选择 S3Drive。

填写虾传设置

控制台可能显示以下地址之一,请原样填写(含 https://):

  • https://s3.cstcloud.cn(较常见)
  • https://s3.data.cstcloud.cn(部分教程使用;若 DNS 无法解析可改用上一地址)

在 设置 → S3 中填写:

字段说明
Endpoint与「客户端访问」页一致,例如 https://s3.cstcloud.cn 或 https://s3.data.cstcloud.cn
Region固定填 us-east-1
Bucket客户端访问页显示的空间名(桶名)
Path-style 访问必须开启
Access Key ID在客户端访问页创建的 Key
Secret Access Key对应 Secret

浏览和上传请使用 App。浏览器不允许页面修改 User-Agent,Web 直传数据胶囊仍可能返回 401。

测试连接与排错

保存后点击「测试连接」。虾传会:

  1. 由服务端对你的桶执行 HeadBucket(serverProbe)。
  2. 签发预签名 URL,由本机 HEAD 探测(验证客户端网络可达性)。

若服务端 SSL 探测失败但客户端 HEAD 成功,测试仍可通过(日志中 serverProbe=ssl_failed 表示服务端 TLS 校验问题,不影响客户端直连)。

若失败,请按顺序检查:

  1. Endpoint 优先使用 https://s3.cstcloud.cn(s3.data.cstcloud.cn 部分环境 DNS 无法解析;不要加路径后缀)。
  2. Path-style 是否已开启。
  3. Region 是否为 us-east-1。
  4. Bucket 名是否与「客户端访问」页一致。
  5. AccessKey 是否复制完整;必要时重新创建一组 Key。
  6. 查看日志中的 serverProbe 与 S3 响应 XML(SignatureDoesNotMatch、InvalidAccessKeyId 等)。

常见错误:

日志 / 错误含义处理
PKIX path building failed / SunCertPathBuilderExceptionJava 后端无法验证 CFCA 证书链(与 AccessKey 无关)升级至已修复版本;旧版可依赖客户端 HEAD 探测继续测试
SignatureDoesNotMatch / HTTP 401凭证、签名或 User-Agent 不匹配核对 Endpoint、Path-style、Region;AccessKey 必须绑定 S3Drive
InvalidAccessKeyIdAccess Key 错误或已删除在「客户端访问」重新创建 Key,客户端应用选 S3Drive

WebDAV(远程存储)

数据胶囊还提供 WebDAV 访问,地址为 https://data.cstcloud.cn/dav。在数据胶囊控制台创建 WebDAV 用户名与密码后,可在虾传 设置 → WebDAV 中添加连接。

WebDAV 与 S3 使用相同的 *.cstcloud.cn 域名与 CFCA 证书链。若后端测试连接出现 SSLHandshakeException / PKIX 错误,原因与上表 S3 相同;升级至已修复版本后,后端会自动补充 CFCA 信任链完成探测。

创建 WebDAV 凭证时,控制台仅支持 Zotero(8 及以上)。虾传会自动使用 Zotero User-Agent 进行浏览与下载;请使用控制台生成的 WebDAV 用户名与密码(不是登录密码)。

重要: 数据胶囊 WebDAV 不支持在虾传中上传文件,仅支持浏览和下载已有内容。如需上传文件,请改用 设置 → S3 配置数据胶囊 S3 连接。

CORS(Web 端)

若使用 Web 端直传,还需在数据胶囊桶配置 CORS,允许虾传 Web 的 Origin,Methods 至少包含 GET、PUT、HEAD。

相关链接