S3 对象存储

S3 用于连接 Amazon S3 或兼容 S3 API 的对象存储。它面向已经拥有 Bucket 和访问密钥的用户，不是普通网盘账号登录入口。

准备连接信息

请先从对象存储服务商获取：

• Endpoint：API 服务地址，例如 https://s3.amazonaws.com 或服务商提供的专用地址
• Region：区域，默认值是 us-east-1
• Bucket：存储桶名称
• AccessKey：访问密钥 ID
• Secret：访问密钥 Secret

可选项目：

• Prefix：只从 Bucket 内的某个目录前缀开始浏览
• Token：使用临时安全凭据时填写 Session Token
• Path Style：兼容服务要求路径式访问时开启
• 备注名称：保存多个连接时便于区分

添加服务器

1. 在书架点击 导入 → S3。
2. 首次进入时点击 新建连接，或点击底部 连接 打开服务器列表。
3. 选择 新增服务器。
4. 填写连接信息。
5. 点击 测试连接。
6. 测试成功后保存并选择该服务器。

Endpoint、Bucket、AccessKey 和 Secret 是必填项。Region 没有特殊要求时可以保留默认值；连接失败时再按服务商文档调整。

浏览与下载

连接成功后：

1. 点击目录前缀继续进入。
2. 点击文件即可开始下载。
3. 进入选择模式可以批量选择文件，再点击底部 下载。
4. 顶部搜索框可以搜索当前路径中的对象。
5. 下载完成后返回书架，等待统一导入任务完成。

文件夹不能作为单个文件下载，不受支持的扩展名会提示“文件格式不支持”。当前 S3 导入页面主要用于浏览和下载，不提供远程上传或删除入口。

Path Style 怎么选

• Amazon S3 和支持虚拟主机式 Bucket 地址的服务，通常保持关闭。
• MinIO、局域网对象存储或部分兼容服务，可能需要开启。
• 如果测试连接出现 Bucket、主机名或签名相关错误，可以切换后重试。

具体值仍以对象存储服务商的 S3 兼容说明为准。

常见问题

测试连接失败

依次检查 Endpoint、Region、Bucket 和密钥是否有多余空格，Endpoint 是否包含正确协议和端口，以及 Path Style 是否匹配服务要求。

能连接但无法列出文件

访问密钥至少需要列出 Bucket 和读取目标对象的权限；设置了 Prefix 时，还要确认该前缀真实存在。

临时密钥不能使用

临时凭据通常必须同时填写 AccessKey、Secret 和 Token，并在过期后重新生成。

安全提醒

建议创建仅有目标 Bucket 只读权限的独立密钥，不要使用管理员密钥。不要把 AccessKey、Secret 或 Token 发给他人或放进截图。

普通自建网盘使用用户名和密码连接时，请看WebDAV。