Skip to content

快速开始 ​

连接一个存储空间,完成第一次文件传输。Bucket(存储空间)是 OSS 存放对象的容器;对象 Key 是文件在 Bucket 中的完整名称,包含目录前缀。

1. 准备连接信息 ​

先按获取应用选择构建或运行开发预览版。准备 Bucket 所在区域,以及以下任一种凭据:

连接方式需要准备
AccessKey有权访问该 Bucket 的 AccessKey ID 和 Secret
STSAccessKey ID、Secret 和临时安全 Token
授权码兼容 OSS Browser 的目录授权码,并确认有效期和只读范围

第一次传输建议使用测试 Bucket 或专用测试目录。可执行的操作取决于账号的 RAM 策略。

2. 连接 OSS ​

填写连接名称、区域(例如 cn-hangzhou)和凭据;使用授权码时,切换到对应标签并粘贴授权码。如果账号无法列举所有 Bucket,在高级选项中填写具体 Bucket。目录前缀需以 / 结尾。

点击连接后,应看到存储空间列表或指定的 Bucket 与目录。凭据默认只保存在内存中,只有主动选择后才写入系统凭据库。连接失败时查看常见问题。

3. 找到一个文件 ​

打开 Bucket 和目录,选中文件查看大小、存储类型与详情。搜索按对象 Key 的前缀匹配,排序只作用于已加载的行。没有看到目标文件时,可继续加载更多结果。

4. 传输一个文件 ​

点击上传选择一个小文件,或选中远程文件后点击下载并选择本地目录。确认传输计划和同名文件处理方式;初次体验可选择报告冲突,避免主动替换已有文件。

在传输任务页查看进度。上传完成后刷新对象列表,下载完成后查看选定的本地目录。关闭应用或断开连接会停止进行中的传输;使用同一连接配置和 AccessKey ID 重新连接后,需要手动重试未完成的记录。

5. 预览或分享 ​

选中一个文件并打开预览。文本修改默认另存为副本;分享功能可生成限时链接。持有有效签名链接的人可以使用链接授予的访问权限,请像保护凭据一样保护链接。

继续阅读下方操作说明,或查看设置与常见问题。

连接与浏览 ​

填写连接名称、区域、AccessKey ID 和 Secret,STS 还需 Token;也可切换授权码标签,输入上游 OSS Browser 的 base64 JSON 授权码。目录授权码会应用 Bucket/前缀、过期时间和只读限制,最终权限由 RAM 策略决定。单文件授权码暂不作为目录连接支持。

高级选项提供服务域名、内网、CNAME 和 PrivateLink。后两者需要 HTTPS Endpoint 和指定 Bucket。内网模式默认推导区域内网域名,也可填写明确的 Endpoint。凭据默认仅在内存,勾选后才保存到系统凭据库;读取与删除已存凭据均有独立按钮,设置和传输记录不保存密钥。

双击打开 Bucket/目录,使用历史导航、远端前缀搜索和分页;排序仅针对已加载项。路径栏书签按钮可添加/移除当前目录,同配置书签显示在侧栏。Cmd/Ctrl + K 打开完整命令列表。

传输 ​

选择文件或目录上传,或选中远端文件/目录下载。确认列表中可选择报告冲突、跳过或替换。上传不跟随符号链接,不处理特殊文件;下载保留相对目录结构,拒绝路径穿越、保留名称、大小写冲突及符号链接子目录。空上传目录会保存为目录标记。

上传与下载任务数分别可配置,默认各 2 个;上传默认 8 MiB 分片、3 个分片并发,下载分片并发默认 3 个。超大上传会自动增大分片。暂时性传输失败按上限退避重试,复用有效检查点。下载验证续传数据、长度、OSS CRC64 及可用的 ETag,完整下载后才发布文件。

关闭或断开会取消当前队列。以相同配置和 AccessKey ID 重新连接后,可手动重试恢复的未完成任务,不会自动传输。队列记录、检查点和下载分片均位于设置文件旁的 transfers/。发布时先将校验后的数据复制到所选目标内的私有临时文件,再原子重命名或创建硬链接;请预留两份文件所需的空间。所选下载根目录会持久化,并在重试和清理时限制文件操作范围。旧版位于目标目录的分片会重新下载;若旧任务无法安全解析目标路径,请重新加入队列。取消会保留检查点和远端分片用于恢复,不再需要的远端分片应通过 OSS 生命周期规则或控制台清理。写操作后请刷新列表。

对象工具 ​

选中单个文件后使用详情栏,批量操作通过命令面板进入。预览支持有界 UTF-8 文本和位图,文本可编辑、查看 Diff 并另存到其他对象键。元数据使用字符串键值的 JSON;修改 ACL 时会显示公共访问提示。分享有效期可选 15 分钟、1 小时、1 天和 7 天,并受已知 STS 到期时间约束;链接可复制或打开,不写入持久化文件。

复制/移动填写以 / 结尾的完整目标前缀,重命名填写完整对象键。应用前核对对象列表。每项在队列中独立报告成功或失败,可单独重试。移动先复制再删除,删除失败时保留两份对象,重试不重复复制。新建目录位于命令面板。

当前限制 ​

当前为开发版本。真实 OSS 账号、Windows/Linux 原生集成、正式签名/公证和发布仍需后续提供的环境,自动化截图和交叉编译不能代替原生验收。

UTF-8 文本编辑支持到 5 MiB,预览读取上限 8 MiB,位图解码上限 2000 万像素。默认另存副本;显式选择替换原对象后,会预检 ETag 并保留 HTTP 标头、标签、元数据、ACL 和存储类型,但检查与写入不具备原子性。图片支持缩放,音视频使用原生 WebView,文档/FLV/不支持的编解码器提供外部打开或下载。元数据修改暂限 1 GiB 对象,目录计划上限 10 万个键。复制/移动/删除队列仅在当前会话有效。已接入 MyGo 签名安装与重启流程;正式发布仍需配置可信公钥和更新源,开发构建提供手动下载入口。

启用或暂停版本控制的 Bucket 不执行 x-oss-forbid-overwrite 保护。上传前检查已有对象,但并发创建仍可能产生新版本。删除/移动会先检查 ETag 再删除,OSS 不保证两次请求的原子性,操作期间应避免并发修改源对象。

存储空间、权限与分享工具 ​

Bucket 菜单提供创建、ACL、删除空桶及分片列举/清理,公开 ACL 需确认。对象工具支持递归目录复制/移动/重命名/删除、HTTP 标头与批量元数据、软链接,以及归档/冷归档/深度冷归档恢复。恢复请求成功不代表对象已经可读。

先复制或移动,再导航到目标目录粘贴;单文件可改名,目录保留相对结构,同区域跨桶使用服务端复制。每项独立显示结果并可重试。RAM 工具支持用户资料和 AccessKey 管理、对用户/组/角色的多对象策略授权、新建子用户及 STS 临时授权码。

分享支持公开地址、限时签名、自定义 HTTPS/加速域名、二维码和确认后发送邮件。SMTP 必须使用 TLS/STARTTLS,密码仅在内存或系统凭证库。设置分为传输、系统、SMTP、日志和其他;可配置并发、分片、超时、重试和分页大小,重新连接后生效。缩略图、启动检查更新和本地诊断日志可选开启;保持登录从系统凭证库读取密钥,退出登录会清除自动连接设置。

逐项实现和验收状态见 110 场景清单。

OSS Browser 的独立重构版本。